Repository navigation
AI-generated software: PolySwitch was developed with AI assistance. This is an experimental native KWin effect.
New since 0.4.15
- First-run walkthrough with replay from Settings.
- Named appearance profiles with native import/export. Background images are embedded; importing adds a profile without changing your current look.
- Undoable appearance reset, disable control, and installed rollback tools and instructions.
- Automatic KDE light/dark and accent following, live theme updates, complementary glow palettes, and automatic/manual/mixed modes with individual overrides.
- Optional Plasma SVG interface artwork and a separate Plasma color source.
- Smooth auto-upright roll with adjustable idle delay and animation duration; interaction cancels the roll.
- Remove the old embedded background import button.
Download without compiling
The binary archive is only for KDE neon 24.04, x86_64, KWin 6.8.1, Qt 6.11.1. Extract it and run:
./install-binary.sh --check-only
./install-binary.shAuthenticate only in KDE’s prompt. Save work, sign out/in normally, then enable PolySwitch in Desktop Effects. Open with Meta+Shift+P. Do not restart KWin manually. The installer checks compatibility and checksums, backs up the old plugin, and includes disable/rollback/uninstall helpers. Other systems should build from source; distribution patches can affect compatibility.
The binary download is about 215 KiB and the plugin about 524 KiB, with debugging information removed. Personal backgrounds, profiles and backups use additional space. Complete GPL-3.0-or-later source archives and SHA-256 checksums are attached.
Validation
Three CTest checks pass. Isolated Wayland UI tests cover the walkthrough, profile selection/apply/reset/undo, persistence, theme changes, SVG artwork and smooth upright animation. A separate virtual KWin test verifies native profile export/import/cancel with input release and the disable state. See validation notes.
