Repository navigation
Klicky 0.3.0
Klicky 0.3.0 adds native Arch Linux and Debian-compatible distribution packages, system-wide sound packs, and automated package release assets.
Install on Arch Linux or Omarchy
gh release download v0.3.0 --pattern 'klicky-*.pkg.tar.zst'
sudo pacman -U klicky-*.pkg.tar.zst
systemctl --user enable --now klicky.serviceInstall on Ubuntu or Debian
gh release download v0.3.0 --pattern 'klicky_*_amd64.deb'
sudo apt install ./klicky_*_amd64.deb
systemctl --user enable --now klicky.serviceThe assets can also be downloaded directly below without GitHub CLI.
Upgrade from the source installer
Before installing a distribution package, remove the user-local binary and service while preserving configuration:
cd ~/Work/klicky
./scripts/uninstall-linux.shDo not use --purge. Install the package afterward and enable its service.
Included in this release
- Arch Linux x86_64 package
- Debian and Ubuntu amd64 package
- Ten MIT-licensed sound packs under
/usr/share/klicky/sounds - User sound-pack overrides under
~/.config/klicky/sounds - systemd user service under
/usr/lib/systemd/user - Keyboard-only udev access rule
klicky(1)manual page- SHA-256 checksums
Package verification
Both package formats are built and installed in clean CI environments. The Arch package was also installed on an Omarchy laptop and verified with a physical service session.
- Ubuntu CI: passed
- macOS CI: passed
- Debian package build, Lintian, extraction, and runtime checks: passed
- Arch makepkg, namcap, pacman installation, and runtime checks: passed
- Omarchy package ownership, migration cleanup, service health, and runtime permissions: passed
Important paths
/usr/bin/klicky
/usr/lib/systemd/user/klicky.service
/usr/lib/udev/rules.d/70-klicky.rules
/usr/share/klicky/sounds/
~/.config/klicky/config.toml
~/.config/klicky/sounds/
Current package scope
Release packages currently target x86_64 Arch Linux and amd64 Debian-compatible systems. macOS continues to build and test in CI but does not receive a binary package until physical runtime validation is completed. Windows remains unsupported.
See the packaging guide and full changelog for details.
Signed APT repository
Debian and Ubuntu users can install and update Klicky through:
https://muneer320.github.io/klicky
Signing fingerprint:
DBB6 7AE4 78D2 FFCE C663 7B55 9899 E554 D358 0D8F
Follow the APT repository instructions to install the repository-specific key and Deb822 source.
Full comparison: v0.2.0...v0.3.0