Click Tween voor KDE Plasma 6.7 / 6.8 (Wayland)
De muisaanwijzer krimpt naar 80% in 150 ms wanneer links of rechts wordt ingedrukt. Hij blijft klein tijdens vasthouden en slepen en groeit in 720 ms terug na loslaten. Bij beide knoppen tegelijk blijft hij klein totdat beide los zijn. De middelste knop verandert de animatie niet.
Het effect schaalt KWin's bestaande cursor rond zijn hotspot. Cursorvorm, zichtbaarheid en positie blijven door KWin beheerd. Het onderschept geen klikken. Bij uitschakelen en schermvergrendeling wordt de schaal hersteld.
Instellingen
Open Systeeminstellingen → Bureaubladeffecten → Click Tween en klik op de instellingenknop. Meld na een plugin-update één keer af en opnieuw aan. KWin/Qt houdt native plugincode in het geheugen; uit-/aanvinken of alleen Systeeminstellingen heropenen laadt een vervangen bibliotheek niet opnieuw. Daarna werken gewone instellingenwijzigingen direct via Toepassen, zonder afmelden.
- Klik-tween-tijd: 0–5000 ms, standaard 150 ms.
- Release-tween-tijd: 0–5000 ms, standaard 720 ms.
- Afzonderlijke easing: standaard easeOutBack voor klik en easeOutElastic voor release.
- 31 keuzes: Linear plus In, Out en InOut voor Sine, Quad, Cubic, Quart,
Quint, Expo, Circ, Back, Elastic en Bounce, zoals op https://easings.net/. De implementatie gebruikt Qt QEasingCurve; curveparameters zijn Qt-standaardwaarden.
0 ms betekent direct. Back en Elastic kunnen voorbij de eindgrootte veren. Toepassen bewaart de instellingen in ~/.config/kwinrc, groep Effect-clicktween, en werkt direct voor de volgende animatie. Standaardinstellingen herstelt de oorspronkelijke tijden en curves. De klik wordt niet vertraagd: de animatie begint bij het indrukken.
Installeren
Op Arch (of een Arch-afgeleide) met KWin 6.7.x of 6.8.x:
git clone https://git.timfalken.com/timfa/click-tween.git
cd click-tween
./install.sh
Het script kijkt eerst of er een release is voor precies jouw KWin-versie. Zo ja, dan downloadt het die build en controleert het de sha256-checksums én of de release tegen dezelfde Arch-pakketten kwin en qt6-base is gebouwd als die bij jou geïnstalleerd zijn. Klopt iets niet, of is er geen release, dan bouwt het lokaal. Altijd zelf bouwen: ./install.sh --build.
Daarna vraagt het sudo voor de plugin in de systeemmap en schakelt hem voor de huidige gebruiker direct en blijvend in, ook bij een herinstallatie. Bestaande animatie-instellingen blijven behouden; zonder opgeslagen instellingen gelden de bovenstaande standaardwaarden. Bij een update blijft af- en aanmelden nodig om de nieuwe plugincode te laden. Start het script als je eigen gebruiker, niet met sudo ./install.sh.
Afhankelijkheden
Bouwen: gcc, pkgconf, kwin, qt6-base, qt6-declarative, kcoreaddons, kconfig, kcmutils, kwindowsystem, wayland, libepoxy, libdrm en dbus:
sudo pacman -S --needed gcc pkgconf kwin qt6-base qt6-declarative kcoreaddons kconfig kcmutils kwindowsystem wayland libepoxy libdrm dbus
De meeste zijn al onderdeel van een Plasma-installatie. Installeren vraagt daarnaast sudo, kwriteconfig6 en qdbus6; downloaden een release curl en git.
Alleen bouwen
./install.sh --build-only
Bouwt in build/ en controleert de pluginfactory en de instellingenmodule (31 curves), zonder iets te installeren of instellingen te wijzigen. Er is geen CMake: install.sh roept moc en g++ direct aan.
Na een kwin-update
Een KWin-effect gebruikt de interne KWin-API en moet voor elke kwin-versie opnieuw gebouwd worden. Na pacman -Syu met een nieuwe kwin: ./install.sh opnieuw draaien en daarna af- en aanmelden.
Automatisch kan ook, met de pacman-hook in hook/:
hook/setup.sh
Dat installeert /usr/local/bin/rebuild-clicktween (met het pad van deze map en jouw gebruikersnaam ingevuld) en /etc/pacman.d/hooks/kwin-clicktween.hook. Na elke installatie of upgrade van kwin bouwt pacman het effect dan opnieuw en vervangt het de plugin. Mislukt het bouwen, dan blijft het oude effect staan en faalt pacman niet. Log: /var/log/clicktween-rebuild.log.
Uitschakelen of verwijderen
Uitschakelen kan via Systeeminstellingen → Bureaubladeffecten → Click Tween, of via:
kwriteconfig6 --file kwinrc --group Plugins --key kwin_effect_clicktweenEnabled false
qdbus6 org.kde.KWin /Effects org.kde.kwin.Effects.unloadEffect kwin_effect_clicktween
Volledig verwijderen:
./install.sh --uninstall
Compatibiliteit en controle
Dit is een experimentele native plugin voor de interne KWin 6.7/6.8 API. Na een KWin-update voer je het installatiescript opnieuw uit. Andere KWin-minorversies worden geweigerd totdat de code daarvoor is gecontroleerd. De plugin draait in KWin zelf; bewaar open werk voordat je de eerste keer installeert. Gelijktijdige cursor-effecten zoals Shake Cursor of Zoom kunnen hun eigen cursor tekenen en moeten apart worden gecontroleerd.
Handmatig controleren na installatie:
- Links en rechts: korte klik, vasthouden, slepen en snel herhaald klikken.
- Beide knoppen indrukken; één loslaten mag de cursor niet herstellen.
- Test pijl, tekstcursor en handje, ook in XWayland-apps.
- Controleer op meerdere schermen met verschillende schaalfactoren.
- Uitschakelen tijdens vasthouden moet de oorspronkelijke grootte herstellen.
De buildcontrole controleert compileren, linken, metadata en het laden van de pluginfactory tegen de lokale KWin-versie. Visueel gedrag moet nog in een actieve sessie worden getest.
Pipeline en releases
blue-ci-cd.yml draait op BlueGit:
- Merge request, push naar master, handmatige run:
build:kwinbouwt in eenarchlinux:latest-image na
pacman -Syu tegen de nieuwste kwin in de Arch-repo's (scripts/ci-build.sh). Faalt die job, dan werkt het effect waarschijnlijk niet op de nieuwste kwin. Een nieuwe KWin-minorversie (bv. 6.9) faalt bewust op de versiecontrole in install.sh tot de code daarvoor is nagekeken. Wil je op elk moment controleren of master nog bouwt: start een pipeline op master via de knop.
- Release (handmatig op master): de job
releasepubliceert via de BlueGit-release-API een release met
clicktween-x86_64.tar.gz (beide .so-bestanden, build-info.txt, SHA256SUMS), het bijbehorende .sha256-bestand en build-info.txt.
Tagschema
De tag is de KWin-versie waarvoor gebouwd is:
| Tag | Betekenis |
|---|---|
6.8.1 | eerste release gebouwd tegen KWin 6.8.1 |
6.8.1-2, 6.8.1-3 | fix of herbouw voor dezelfde KWin 6.8.1 (bv. een codefix of een Arch-rebuild van kwin/qt) |
De release-job kiest de tag zelf: de KWin-versie waartegen hij net gebouwd heeft, met -N erachter als die tag al bestaat. Met de variabele RELEASE_TAG kun je een tag opgeven; die wordt gecontroleerd. Een gepushte tag start verify:tag, die faalt met een duidelijke melding als de tag niet bij de kwin-versie in Arch past. Arch heeft altijd maar één (de nieuwste) kwin; een release voor een oudere kwin kan dus niet meer gebouwd worden. In build-info.txt staan ook de exacte Arch-pakketversies van kwin en qt6-base; install.sh gebruikt een release alleen als die overeenkomen met je systeem.
Licentie
GPL-2.0-or-later, zie COPYING.