Mechanical keyboard sounds for Linux, macOS and Windows 11. Give the keyboard you already own a sound you enjoy, whether you're writing code, taking notes or chatting with friends.
A little sound for every keystroke.
Watch the 45-second demo · Listen to the packs · Install · Everyday use · Help · Full guide
There's someone under your keys. Klicky, our curious little mascot, loves a good typing rhythm and settles down when you do. Meet Klicky.
The app runs quietly in the background. Pick a pack, set the volume and carry on typing.
Ask a question or share your setup · Browse the wiki · Support development
- Find your sound. Ten included packs: Cherry MX Black, Blue, Brown and Red in PBT/ABS variants, plus EG Oreo and EG Crystal Purple. You can add your own recordings too.
- Control it from your desktop. Windows tray, macOS menu bar, or Linux terminal with Klicky Bar on supported Omarchy desktops.
- Keep it local. No account or subscription. Normal playback stores no typed text and makes no network requests.
- Built in Rust for responsive playback. Sounds are decoded when a pack loads and reused while you type.
Prefer a package manager? Klicky is available through these routes:
| Your system | Install with | Setup |
|---|---|---|
| Ubuntu / compatible Debian | APT | Add Klicky's signed repository |
| Windows 11 · x64 | Microsoft Store | Get Klicky |
| macOS · Apple Silicon | Homebrew | Install from Klicky's tap |
| Windows 11 · x64 | Scoop | Install from Klicky's bucket |
| Arch / Omarchy · x86_64 | pacman | Download and install the release package |
The Arch route uses pacman -U with a downloaded package, not an AUR or pacman -S listing. Each setup guide includes the required repository or bucket and startup steps.
Open your system below and copy the command. The setup helpers install the app and sounds, then start Klicky. Follow any setup or permission prompts. For downloads and more methods, use the installation picker.
Linux · Ubuntu / compatible Debian, Arch / Omarchy
Run in a terminal as your normal desktop user:
curl -fsSL https://klicky.muneer320.tech/install.sh | bashUses signed APT packages on Ubuntu 24.04+ / compatible Debian amd64, or the release package on Arch / Omarchy x86_64. Setup asks for sudo when needed and enables login startup. Have curl installed first.
Compatible Omarchy setups include the bar toggle. To skip it, use bash -s -- --no-omarchy-toggle at the end of the command. For Fedora, older distributions or other architectures, build from source:
curl -fsSL https://klicky.muneer320.tech/install.sh | bash -s -- --sourceAll Linux methods and prerequisites · Signed APT setup · Omarchy integration · Klicky Bar marketplace listing
macOS · Apple Silicon and Intel
Run in Terminal:
curl -fsSL https://klicky.muneer320.tech/install.sh | bashBuilds Klicky from source, prepares missing Rust and Apple build tools, includes the menu bar control and enables login startup. First setup can take several minutes; approve Apple's tools dialog if shown.
Allow ~/.local/bin/klicky in System Settings → Privacy & Security → Accessibility. Setup opens the pane and retries while you approve it. To skip the menu helper, use bash -s -- --no-menu at the end of the command.
Already use Homebrew on Apple Silicon? With Homebrew and Apple's build tools installed:
brew install muneer320/tap/klicky && brew services start muneer320/tap/klicky && klicky service enableThis also builds from source. Grant Accessibility to the executable shown by brew info klicky, then run klicky service start. Use one installation method; Intel Macs use the installer above.
Windows 11 · x64
Install Klicky from the Store for automatic updates. Open it from Start, then use its tray menu for sounds and optional login startup. All ten packs are included.
Other methods: PowerShell installer, portable ZIP or Scoop
For the standalone installer, run in PowerShell:
irm https://klicky.muneer320.tech/install.ps1 | iexDownloads the installer, verifies its SHA-256 and opens setup for your user. Choose whether to start at login; the helper starts Klicky after setup. No Rust, Visual Studio or administrator terminal needed.
Prefer to click a download? Get the Windows installer or portable ZIP. For the ZIP, extract the whole folder and open klicky-desktop.exe.
Already use Scoop? Follow the Scoop setup guide.
Windows controls and troubleshooting · All Windows installation methods
Note
The standalone Windows EXE/ZIP downloads are unsigned; the Microsoft Store package is signed through Store delivery. If Windows Security reports a threat, stop setup and follow the security-block guidance.
Want to read the helpers first? Linux/macOS script · Windows script
Once setup finishes, type in any ordinary app to hear Klicky. Here's where to find the controls:
| System | Where to look |
|---|---|
| Windows | Tray menu: choose a pack, change volume, Pause/Resume, retry audio or choose login startup. |
| macOS | Menu bar: choose a pack, change volume, Pause/Resume or choose login startup. Terminal controls are available too. |
| Linux | Terminal controls below. Klicky Bar adds pack, volume, Pause/Resume and startup controls on Omarchy 4.5+. |
On Linux and macOS, try:
klicky list # List sound packs
klicky switch cherrymx-blue-pbt # Choose a pack
klicky volume 0.5 # Set volume to 50% (range: 0 to 1)
klicky status # Check current stateSource installations use ~/.local/bin/klicky if your shell doesn't find klicky. Microsoft Store and Scoop expose klicky in a new Windows terminal. For the standalone Windows installer, use:
& "$env:LOCALAPPDATA\Programs\Klicky\klicky.exe" statusStart, stop and choose login startup
klicky service start # Start this session
klicky service stop # Stop now; keep login startup
klicky service enable # Start now and at login
klicky service disable # Stop now and disable login startupThese commands also work through the Windows CLI. The Windows tray has Start with Windows; Windows may independently disable or delay startup. Homebrew manages the menu helper separately; see its service instructions.
Want to customize further? Use the configuration guide for settings and paths, or make your own sound pack from OGG audio and a JSON timing map.
Do I need a mechanical keyboard? Does Linux work on Wayland?
Any ordinary keyboard works; the sound is added in software. Linux reads evdev below Wayland/X11, using a keyboard-only device rule rather than separate desktop-specific capture.
Does it record what I type?
Normal playback stores no typed text, logs no key names and sends no network requests. Explicit update checks contact GitHub without sending keyboard events or settings. Global keyboard permission is sensitive, so grant it only to trusted software. Unix benchmark mode prints mapped key names and is for controlled tests. Privacy and security
No sound, missing sounds or a delay?
Check that Klicky is running, isn't paused, and has a nonzero volume. On macOS, check Accessibility permission. Try laptop speakers or wired output to compare: Bluetooth can add noticeable delay.
The troubleshooting guide covers permissions, startup and audio recovery. If sounds still drop out, report a bug with your OS, output device and what happened.
How do I update?
Use the method you installed with. Microsoft Store manages updates for its copy. For helper installations, rerun the install command above. For package managers, follow the Homebrew or Scoop update steps, including stopping Klicky first. Settings and custom sounds are preserved during updates.
Current source also includes a centralized update command; it will reach packaged installations with the next app release.
How do I uninstall, including desktop controls?
Microsoft Store: quit Klicky and uninstall it through Settings → Apps → Installed apps. Store removal clears package-private settings and custom packs, so back them up first. Store data and removal.
For installations made with the download helpers:
Linux/macOS
curl -fsSL https://klicky.muneer320.tech/uninstall.sh | bashWindows installer
irm https://klicky.muneer320.tech/uninstall.ps1 | iexThese stop Klicky and remove its installed desktop controls. Settings and custom packs stay unless you choose purge removal.
Installed with Homebrew or Scoop? Use package-manager removal instead. Portable Windows copies have separate removal steps.
Klicky uses native keyboard input on each OS and prepares audio before you type. Linux/macOS use a resident daemon; Windows uses a native tray coordinator. They share sound-pack decoding and cached audio. Read the architecture guide for the diagram, module map and platform details, or the performance guide for measurements and methodology.
| I want to… | Start here |
|---|---|
| Install, configure or troubleshoot | The website field guide |
| Browse all guides | Documentation index |
| Look up commands or configuration | CLI · Configuration |
| Add recordings or desktop integration | Sound packs · Omarchy |
| Understand or contribute code | Build, test and contribute · Open issues |
| Explore the character or use artwork | Klicky's story · Artwork |
| Check releases and project history | Releases · Changelog |
I first saw Sauhard Gupta's original macOS project running on a Mac and wanted it on my Omarchy machine. So I adapted it for Linux, then kept going until Windows joined in. Read the development story. · About me
MIT license · Acknowledgements and third-party credits. Third-party notices are included with packaged downloads.
