Skip to content

kamillobinski/thock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

257 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Logo

Thock

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

Release Version GitHub Downloads Discord Ask DeepWiki

Table of Contents
  1. About The Project
  2. Features
  3. Getting Started
  4. License
  5. Contributing
  6. Acknowledgments

About The Project

banner

Thock is a high-performance utility designed to bring the tactile satisfaction of mechanical switches to your macOS workspace. Built natively in Swift, it bridges the gap between hardware feel and software execution with zero compromises on speed or privacy.

Started this project to challenge the status quo. While paid alternatives exist, Thock is built on the belief that the best tools should be open-source and community-driven. By focusing on a custom low-latency engine and deep system integration, Thock offers a professional-grade typing experience that stays out of your way and keeps your flow state intact.

🍺 Homebrew: brew install --cask kamillobinski/thock/thock

(back to top)

Features

Quick Overview (if you don't feel like scrolling today)
Feature Description
Custom Engine Native AudioQueue APIs achieving ultra-low latency for perfectly synced feedback.
Sound Library Extensible JSON-based architecture to import or create custom switch profiles.
Smart Integration Music awareness that automatically mutes audio during playback.
Advanced Control Hands-on-keys management via Raycast extension and dedicated CLI.
Translation Fully localized interface for English, Español, Français, 日本語, 中文, Deutsch and Italiano users.

custom-engine

Custom Engine

Features a custom audio engine built on native macOS AudioQueue APIs, achieving ultra-low latency that feels instantaneous. By bypassing standard high-level processing layers, we have eliminated perceptual lag to provide perfectly synced auditory feedback.

Whether you are a high-speed programmer or a creative writer, Thock ensures every keystroke is met with organic, realtime sound that keeps pace with your fastest workflow.

(back to top)

sound-library

Sound Library

Built to be an open platform. While the app comes pre-loaded with high-quality recordings, you aren't limited to the defaults.

With support for custom sound packs, you can easily import new switch profiles or create your own using a simple JSON structure. Whether you want the heavy 'thock' of a vintage board or a completely unique experimental soundscape, you can expand your library to suit your specific taste. Drop your folder into the directory and switch profiles instantly.

(back to top)

smart-integration

Smart Integration

With music awareness, Thock intelligently manages your soundscape so you never have to manually toggle settings. By detecting active playback from apps like Spotify or Apple Music, it automatically mutes its typing sounds to let your music take priority.

As soon as the music stops, the app instantly resumes your mechanical feedback. It's a seamless, 'set-and-forget' feature designed for deep work sessions where your focus shifts between rhythm of your keys and the rhythm of your playlist.

Supported: Apple Music, Spotify, VLC

(back to top)

advanced-control

Advanced Control

Built for power users, Thock extends beyond the menu bar with its own Raycast Extension and a dedicated CLI. This integration allows you to toggle the audio engine and switch sound packs entirely via the command bar.

By exposing every core function to the system, Thock fits seamlessly into your automation workflows and productivity scripts. Whether you're using Raycast, Alfred, or the terminal, you have total control over your typing environment without ever lifting your hands.

(back to top)

translation

Translation

With localization, Thock bridges the gap between powerful functionality and effortless usability. The interface is fully translated into multiple languages, allowing users to navigate the ecosystem without language barriers.

Select your preferred language in the general settings to enjoy a workspace tailored to your needs.

Supported: 🇺🇸 English, 🇪🇸 Spanish, 🇫🇷 French, 🇨🇳 Chinese, 🇯🇵 Japanese, 🇩🇪 German, 🇮🇹 Italian.

(back to top)

Getting Started

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

Warning

Thock requires macOS 13.5 Ventura or later.

A Homebrew Cask Installation (recommended)

brew tap kamillobinski/thock
brew install --cask thock

or one command:

brew install --cask kamillobinski/thock/thock
B: 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
C: 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)

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!

Contributor Contribution
sasagar VLC auto-launch prevention.
nthnbch French translations.
Bcharlit German translations.
Crocchetto Italian translations.
Kaedeeeeeeeeee Dynamic localization (Japanese + Chinese), auto-enable on headphones, trackpad sound support.
distantorigin Menu bar accessibility and VoiceOver responsiveness.
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, performance improvements.
iamsoum Clearer step-by-step sound pack conversion instructions.

(back to top)