BlueGit

timfa click-tween

Files

click-tween / README.md

README.md

README.md 7.2 KiB Download Raw

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:kwin bouwt in een archlinux: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 release publiceert 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:

TagBetekenis
6.8.1eerste release gebouwd tegen KWin 6.8.1
6.8.1-2, 6.8.1-3fix 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.

Source
1# Click Tween voor KDE Plasma 6.7 / 6.8 (Wayland)
2
3De muisaanwijzer krimpt naar 80% in 150 ms wanneer links of rechts wordt
4ingedrukt. Hij blijft klein tijdens vasthouden en slepen en groeit in 720 ms
5terug na loslaten. Bij beide knoppen tegelijk blijft hij klein totdat beide
6los zijn. De middelste knop verandert de animatie niet.
7
8Het effect schaalt KWin's bestaande cursor rond zijn hotspot. Cursorvorm,
9zichtbaarheid en positie blijven door KWin beheerd. Het onderschept geen
10klikken. Bij uitschakelen en schermvergrendeling wordt de schaal hersteld.
11
12## Instellingen
13
14Open Systeeminstellingen → Bureaubladeffecten → Click Tween en klik op de
15instellingenknop. Meld na een plugin-update één keer af en opnieuw aan.
16KWin/Qt houdt native plugincode in het geheugen; uit-/aanvinken of alleen
17Systeeminstellingen heropenen laadt een vervangen bibliotheek niet opnieuw.
18Daarna werken gewone instellingenwijzigingen direct via Toepassen, zonder afmelden.
19
20- Klik-tween-tijd: 0–5000 ms, standaard 150 ms.
21- Release-tween-tijd: 0–5000 ms, standaard 720 ms.
22- Afzonderlijke easing: standaard easeOutBack voor klik en easeOutElastic voor release.
23- 31 keuzes: Linear plus In, Out en InOut voor Sine, Quad, Cubic, Quart,
24 Quint, Expo, Circ, Back, Elastic en Bounce, zoals op https://easings.net/.
25 De implementatie gebruikt Qt QEasingCurve; curveparameters zijn Qt-standaardwaarden.
26
270 ms betekent direct. Back en Elastic kunnen voorbij de eindgrootte veren.
28Toepassen bewaart de instellingen in `~/.config/kwinrc`, groep
29`Effect-clicktween`, en werkt direct voor de volgende animatie.
30Standaardinstellingen herstelt de oorspronkelijke tijden en curves.
31De klik wordt niet vertraagd: de animatie begint bij het indrukken.
32
33## Installeren
34
35Op Arch (of een Arch-afgeleide) met KWin 6.7.x of 6.8.x:
36
37```bash
38git clone https://git.timfalken.com/timfa/click-tween.git
39cd click-tween
40./install.sh
41```
42
43Het script kijkt eerst of er een [release](https://git.timfalken.com/timfa/click-tween/-/releases)
44is voor precies jouw KWin-versie. Zo ja, dan downloadt het die build en controleert het de
45sha256-checksums én of de release tegen dezelfde Arch-pakketten `kwin` en `qt6-base` is gebouwd
46als die bij jou geïnstalleerd zijn. Klopt iets niet, of is er geen release, dan bouwt het lokaal.
47Altijd zelf bouwen: `./install.sh --build`.
48
49Daarna vraagt het sudo voor de plugin in de systeemmap en schakelt hem voor de huidige gebruiker
50direct en blijvend in, ook bij een herinstallatie. Bestaande animatie-instellingen blijven behouden;
51zonder opgeslagen instellingen gelden de bovenstaande standaardwaarden. Bij een update blijft af- en
52aanmelden nodig om de nieuwe plugincode te laden. Start het script als je eigen gebruiker, niet met
53`sudo ./install.sh`.
54
55### Afhankelijkheden
56
57Bouwen: `gcc`, `pkgconf`, `kwin`, `qt6-base`, `qt6-declarative`, `kcoreaddons`, `kconfig`,
58`kcmutils`, `kwindowsystem`, `wayland`, `libepoxy`, `libdrm` en `dbus`:
59
60```bash
61sudo pacman -S --needed gcc pkgconf kwin qt6-base qt6-declarative kcoreaddons kconfig kcmutils kwindowsystem wayland libepoxy libdrm dbus
62```
63
64De meeste zijn al onderdeel van een Plasma-installatie. Installeren vraagt daarnaast `sudo`,
65`kwriteconfig6` en `qdbus6`; downloaden een release `curl` en `git`.
66
67### Alleen bouwen
68
69```bash
70./install.sh --build-only
71```
72
73Bouwt in `build/` en controleert de pluginfactory en de instellingenmodule (31 curves), zonder iets
74te installeren of instellingen te wijzigen. Er is geen CMake: `install.sh` roept `moc` en `g++` direct aan.
75
76### Na een kwin-update
77
78Een KWin-effect gebruikt de interne KWin-API en moet voor elke kwin-versie opnieuw gebouwd worden.
79Na `pacman -Syu` met een nieuwe kwin: `./install.sh` opnieuw draaien en daarna af- en aanmelden.
80
81Automatisch kan ook, met de pacman-hook in `hook/`:
82
83```bash
84hook/setup.sh
85```
86
87Dat installeert `/usr/local/bin/rebuild-clicktween` (met het pad van deze map en jouw gebruikersnaam
88ingevuld) en `/etc/pacman.d/hooks/kwin-clicktween.hook`. Na elke installatie of upgrade van `kwin`
89bouwt pacman het effect dan opnieuw en vervangt het de plugin. Mislukt het bouwen, dan blijft het oude
90effect staan en faalt pacman niet. Log: `/var/log/clicktween-rebuild.log`.
91
92## Uitschakelen of verwijderen
93
94Uitschakelen kan via Systeeminstellingen → Bureaubladeffecten → Click Tween,
95of via:
96
97```bash
98kwriteconfig6 --file kwinrc --group Plugins --key kwin_effect_clicktweenEnabled false
99qdbus6 org.kde.KWin /Effects org.kde.kwin.Effects.unloadEffect kwin_effect_clicktween
100```
101
102Volledig verwijderen:
103
104```bash
105./install.sh --uninstall
106```
107
108## Compatibiliteit en controle
109
110Dit is een experimentele native plugin voor de interne KWin 6.7/6.8 API.
111Na een KWin-update voer je het installatiescript opnieuw uit. Andere
112KWin-minorversies worden geweigerd totdat de code daarvoor is gecontroleerd.
113De plugin draait in KWin zelf; bewaar open werk voordat je de eerste keer
114installeert. Gelijktijdige cursor-effecten zoals Shake Cursor of Zoom kunnen
115hun eigen cursor tekenen en moeten apart worden gecontroleerd.
116
117Handmatig controleren na installatie:
118
119- Links en rechts: korte klik, vasthouden, slepen en snel herhaald klikken.
120- Beide knoppen indrukken; één loslaten mag de cursor niet herstellen.
121- Test pijl, tekstcursor en handje, ook in XWayland-apps.
122- Controleer op meerdere schermen met verschillende schaalfactoren.
123- Uitschakelen tijdens vasthouden moet de oorspronkelijke grootte herstellen.
124
125De buildcontrole controleert compileren, linken, metadata en het laden van
126de pluginfactory tegen de lokale KWin-versie. Visueel gedrag moet nog in een
127actieve sessie worden getest.
128
129## Pipeline en releases
130
131`blue-ci-cd.yml` draait op BlueGit:
132
133- **Merge request, push naar master, handmatige run:** `build:kwin` bouwt in een `archlinux:latest`-image na
134 `pacman -Syu` tegen de nieuwste kwin in de Arch-repo's (`scripts/ci-build.sh`). Faalt die job, dan werkt
135 het effect waarschijnlijk niet op de nieuwste kwin. Een nieuwe KWin-minorversie (bv. 6.9) faalt bewust
136 op de versiecontrole in `install.sh` tot de code daarvoor is nagekeken.
137 Wil je op elk moment controleren of master nog bouwt: start een pipeline op master via de knop.
138- **Release (handmatig op master):** de job `release` publiceert via de BlueGit-release-API een release met
139 `clicktween-x86_64.tar.gz` (beide `.so`-bestanden, `build-info.txt`, `SHA256SUMS`), het bijbehorende
140 `.sha256`-bestand en `build-info.txt`.
141
142### Tagschema
143
144De tag is de KWin-versie waarvoor gebouwd is:
145
146| Tag | Betekenis |
147| --- | --- |
148| `6.8.1` | eerste release gebouwd tegen KWin 6.8.1 |
149| `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) |
150
151De `release`-job kiest de tag zelf: de KWin-versie waartegen hij net gebouwd heeft, met `-N` erachter als die
152tag al bestaat. Met de variabele `RELEASE_TAG` kun je een tag opgeven; die wordt gecontroleerd. Een gepushte
153tag start `verify:tag`, die faalt met een duidelijke melding als de tag niet bij de kwin-versie in Arch past.
154Arch heeft altijd maar één (de nieuwste) kwin; een release voor een oudere kwin kan dus niet meer gebouwd
155worden. In `build-info.txt` staan ook de exacte Arch-pakketversies van `kwin` en `qt6-base`; `install.sh`
156gebruikt een release alleen als die overeenkomen met je systeem.
157
158## Licentie
159
160GPL-2.0-or-later, zie `COPYING`.