Skip to content
Muneer320Public

About

Free, open-source keyboard sounds for Windows, macOS and Linux. Ten sound packs, native desktop controls, and a little character under your keys.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Repository files navigation

Klicky

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.

Watch Klicky's sound demo: a little character beneath a violet keycap.

A little sound for every keystroke.
Watch the 45-second demo · Listen to the packs · Install · Everyday use · Help · Full guide

CI status MIT license 10 included sound packs OpenSSF Best Practices status

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.

Install

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 | bash

Uses 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 -- --source

All 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 | bash

Builds 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 enable

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

macOS setup · Homebrew setup, updates and removal

Windows 11 · x64

Download Klicky from the Microsoft Store

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 | iex

Downloads 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

Everyday use

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 state

Source 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" status
Start, 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 startup

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

Full CLI reference

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.

Help and FAQ

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 | bash

Windows installer

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

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

Explore the project

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.

About

Free, open-source keyboard sounds for Windows, macOS and Linux. Ten sound packs, native desktop controls, and a little character under your keys.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages