Thock

A macOS utility that adds sound effects to your keyboard.
Lightweight, native and runs in the menu bar.

Table of Contents

1. About The Project
   • Built With
2. Getting Started
3. Usage
4. License
5. Contributing
6. Acknowledgments

About The Project

Thock is a native macOS utility that adds sound effects to your keyboard.

I built this project for fun, aiming to create a satisfying typing experience - like a mechanical keyboard, but entirely in software. Similar apps exist, but those written in other languages often lack proper macOS support or fall short in quality and functionality. There’s also Klack, a $5 paid alternative on the App Store, but I believe an open source community can do better lol.

Key features:

•   Native macOS application
• ⚡ Minimal CPU & memory usage
• 📎 Menu bar utility
• 🔊 Over 25 unique sound modes
• 🕹️ Adjustable volume slider
• 🪄 Raycast extension
• 🙉 Custom soundpacks
• 💅 Soundpack Converters
• ⚙️ Settings (auto-mute, launch at login, etc)

(back to top)

Built With

(back to top)

Getting Started

It's quick and easy. You can either download a prebuilt release or build it yourself if you prefer.

Important

Thock requires macOS 13.5 Ventura or later.

→ Option 1. Hombrew Cask Installation (recommended)

brew tap kamillobinski/thock
brew install --cask thock

or one command:

brew install --cask kamillobinski/thock/thock

Option 2. Release Download

1. Go to the latest release
2. Download Thock-x.y.z.zip
3. Unpack the ZIP file
4. Move the app to your Applications folder for easy access
5. Open Thock

Option 3. Build From Source

1. Clone the repository

   git clone https://github.com/kamillobinski/thock.git
   cd thock

2. Open in Xcode

   open Thock.xcodeproj

3. Build and run the application

(back to top)

Usage

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contributing

Got an idea or want to improve something? Awesome!

Check out the contributing guide for everything you need to know.

(back to top)

Acknowledgments

Thanks to the folks that helped make this project a reality!

Community Contribution

• @SouhailBlmn - Volume persistence across output devices, global shortcut to toggle the app
• @shailantani - Raycast extension (source code)
• @qalonbudker - Pitch variation for key sounds
• @zenangst - Event handling, mode saving, perf improvements
• @iamsoum - Updated the sound pack conversion instructions for improved clarity and step-by-step guidance

(back to top)