An open API service indexing awesome lists of open source software.

https://github.com/kamillobinski/thock

Transform your keystrokes with immersive sound. Fully open-source with instant feedback and a native menu bar experience.
https://github.com/kamillobinski/thock

desktop keyboard keyboard-sounds macos mechanical-keyboard sounds swift

Last synced: about 1 month ago
JSON representation

Transform your keystrokes with immersive sound. Fully open-source with instant feedback and a native menu bar experience.

Awesome Lists containing this project

README

        




Logo

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



  2. Getting Started


  3. Usage

  4. Contributing

  5. License

  6. Acknowledgments

## About The Project

![banner](banner.png)

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

(back to top)

### Built With

![Swift][Swift-url]

(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 15.2 Sequoia or later.

### → Installation (recommended)

1. Go to the [latest release](https://github.com/kamillobinski/thock/releases/latest)
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

### Build From Source

1. Clone the repository
```sh
git clone https://github.com/kamillobinski/thock.git
cd thock
```

2. Open in Xcode
```sh
open Thock.xcodeproj
```

3. Build and run the application

(back to top)

## Usage

![usage](usage.gif)

(back to top)

## License

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

(back to top)

## Contributing

Any contributions - whether improving the code or adding new sound modes - are greatly appreciated!

If you have a suggestion that would make Thock better, please fork the repo and submit a pull request. You can also open an issue if you have an idea or find a bug. Thanks! 🤟

1. Fork the Project
2. Create your Feature Branch(`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

(back to top)

## Acknowledgments

Thanks to the tools and resources that helped make this project a reality!

**Keyboard Sound Recordings**
- [hainguyents13/mechvibes](https://github.com/hainguyents13/mechvibes/)
- [tplai/kbsim](https://github.com/tplai/kbsim)
- [webdevcody/type-joy](https://github.com/webdevcody/type-joy)

(back to top)

[Swift-url]: https://img.shields.io/badge/swift-%23FA7343.svg?style=for-the-badge&logo=swift&logoColor=white