Klicky v0.5.0

Klicky now brings keyboard sounds to Linux, macOS and Windows 11 x64 in one release. Pick a sound pack, set the volume and let it keep you company while you type.

What's new

• Windows support with native tray controls, pause/resume, sound-pack switching, volume controls and optional login startup.
• A Windows installer and portable ZIP, with checksums and build identity included.
• One-command installation and removal for all three platforms. macOS includes its menu bar helper by default; compatible Omarchy setups include the bar toggle. Both can be opted out of.
• Recovery for Windows installations whose CLI was removed, plus fixes for uninstall lookup and background launch from PowerShell.
• Clearer installation guides, an expanded field guide, playable sound-pack previews and Klicky's new mascot identity.

Install or update

Start with the installation guide, or see the repository for platform-specific instructions.

Linux has Debian/Ubuntu amd64 and Arch x86_64 packages. The Debian package needs glibc 2.39 or newer; use the source installer on older systems. macOS installs from source and includes the menu helper. Windows targets Windows 11 x64 desktop environments.

The Windows installer is unsigned and may show an unknown-publisher warning. Keep Windows Security enabled. For responsive sound, use laptop speakers or wired audio; Bluetooth can add noticeable delay.

Updating preserves your settings and custom sounds. Removal keeps them by default; use the documented purge option if you want them removed too.

See the changelog for details, the Windows guide for installer/portable behavior, and the engineering story for how the project grew across platforms.

Mechanical keyboard sounds for Windows 11 x64, with all ten sound packs included.

Run this in PowerShell to download the verified installer and open setup:

irm https://klicky.muneer320.tech/install.ps1 | iex

Setup is per-user and includes the app, packs and native tray controls. No Rust or Visual Studio is needed. The helper starts Klicky after setup; a paused launch selected in the wizard is respected. Login startup is optional.

Alternatively, download the -setup.exe asset below, or extract the complete portable ZIP and open klicky-desktop.exe. Keep its sounds and notices together. The tray changes packs/volume, pauses/resumes playback and offers audio recovery. Settings and custom packs persist across guarded installer upgrades and removal. Aggregate CLI diagnostics do not record typed text or key names.

This is an unsigned Windows preview. Laptop-speaker listening checks on the development laptop were reported comfortable. Bluetooth can add output delay; this is not a calibrated latency or all-hardware compatibility claim.

Windows guide · Website · Troubleshooting

Built from reviewed commit 7640d242bbc16cd64cfb811e66af10f0ec2a2570, Windows package workflow 42121268258. Exact source identity, payload hashes and third-party notices are inside the bundle; SHA-256 sidecars accompany both downloads. This preview does not replace Linux v0.4.0 as the latest stable release.

What's Changed

• feat: publish signed APT repository by @Muneer320 in #4
• feat: redesign APT repository page by @Muneer320 in #5
• Restore Pages homepage without dropping APT package history by @Muneer320 in #6
• fix: harden daemon lifecycle, IPC reliability, and package guards by @Muneer320 in #7
• chore: prepare v0.4.0 release candidate by @Muneer320 in #8

Full Changelog: v0.3.0...v0.4.0

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.service

Install 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.service

The 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.sh

Do 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

Klicky 0.2.0

Klicky 0.2.0 turns the original macOS keyboard-sound daemon into a cross-platform, Linux-first utility while preserving macOS support and the existing sound-pack format.

Highlights

• Native Linux input through evdev, independent of Wayland or X11
• Verified operation on Arch Linux, Omarchy, Hyprland, Wayland, and PipeWire
• Persistent Rodio 0.22 mixer with 256-frame output when supported
• Predecoded, cached per-key samples with clipping-safe loudness normalization
• systemd user-service installer with automatic restart and device rediscovery
• Narrow keyboard-only udev access rule
• Optional native Omarchy top-bar toggle
• Owner-only runtime directory, PID file, and IPC socket
• Linux and macOS CI covering formatting, tests, Clippy, release builds, documentation, shell scripts, and systemd packaging

Measured Linux performance

On the tested Omarchy laptop, 55 physical keypresses produced:

• Mean dispatch latency: 0.241 ms
• Median: 0.220 ms
• p95: 0.520 ms
• p99: 0.570 ms

These measurements cover event receipt through audio dispatch. They do not claim physical key-to-speaker latency.

Install on Linux

git clone https://github.com/Muneer320/klicky.git
cd klicky
./scripts/install-linux.sh

The installer requires Rust 1.87 or newer, systemd user services, udev, and the distribution package that provides ALSA development headers.

Upgrade notes

Existing Linux installations can rerun ./scripts/install-linux.sh. The installer migrates service enablement to default.target, restarts the installed binary, and removes legacy runtime files from the config directory.

Known limitations

• macOS is continuously compile-tested, but this release has not received a fresh physical Mac runtime validation.
• Input devices are discovered at daemon startup. Reader failure triggers a systemd restart and rescan, but adding another keyboard while current readers remain healthy requires a restart.
• Linux installation automation currently targets systemd and udev distributions.
• Windows support is not included.

Lineage

Klicky began as Sauhard Gupta's original Klicky. This release preserves the original Git history, MIT license, macOS implementation, sound-pack format, and attribution while adding the Linux platform, packaging, performance work, security hardening, and documentation maintained here.

See the changelog and benchmark methodology for details.