Skip to content

About

Make your keyboard sound mechanical — synthesized live in real time, no sample packs. Open-source macOS menu bar app, an alternative to Klack and Thock.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Switchsmith

Smith your own keyboard sound.

Release License: MIT Platform: macOS 13.5+

Switchsmith is a free, open-source macOS menu bar app that makes your keyboard sound mechanical — every click is synthesized live, in real time, not played back from a recorded sample pack. Think of it as an open-source alternative to Klack and Thock for anyone who wants custom mechanical-keyboard typing sounds on Mac, without downloading or recording audio files — shape the click yourself with a small physically-inspired DSP model.

Why real-time synthesis

Existing tools in this space (Klack, Thock) work by triggering recorded .wav/.caf samples of real switches on every keystroke, with pitch jitter layered on top for variation. That's a proven approach and it sounds great, but it means the "sound" is fixed at recording time — you get whichever switches someone recorded, and making a new one means recording new audio.

Switchsmith takes a different angle: the click is generated from scratch, per keystroke, by a small real-time DSP voice made of an impact transient and a damped resonant body. Six parameters — sharpness, weight, brightness, decay, jitter, volume — fully describe a switch's character, so "designing a new switch" is dragging sliders and hearing the result instantly, not sourcing a recording. The whole sound library ships as a few hundred bytes of floating point numbers, not audio assets.

Features

  • Real-time synthesis engine — no bundled audio files at all
  • Switch Designer — live sliders for sharpness, weight, brightness, decay, and jitter, with instant audio preview
  • Five built-in presets (Cream, Box Jade, Linear Red, Buckling Spring, Topre) as starting points, each just a parameter set
  • Typing-velocity-reactive dynamics — clicks get a little punchier as you type faster, and settle back down as you slow down
  • Distinct key-down / key-up character, like a real switch's press and release
  • Menu bar only — no dock icon, no window unless you open the designer
  • Raycast extension — toggle the app or switch presets from Raycast without touching the mouse

How it works

Global key capture. A listen-only CGEventTap on .cgSessionEventTap observes keyDown/keyUp system-wide (never modifies or blocks events). This needs both Accessibility and Input Monitoring permission — CGEvent.tapCreate returns nil outright if either is missing, which is a much clearer signal than AppKit's NSEvent global monitor, which can report success while silently never delivering events.

Synthesis. An AVAudioSourceNode render callback generates every sample live — no AVAudioPlayerNode, no pre-rendered buffers. Each voice is a plain value type in a fixed-size pool (24 voices), mutated in place with no allocation or locking inside the per-sample hot path (a single NSLock guards the pool itself, held for the whole render block rather than per sample). Each click layers two components:

  • an impact transient — a short lowpass-filtered noise burst, shaped by sharpness and brightness
  • a resonant body — a very brief noise impulse excites a second-order bandpass (biquad) filter tuned by weight, whose output is independently amplitude-gated by decay

Driving the body with an impulse into a resonator, rather than a sustained pure tone, is deliberate: the first version of this engine used two additive sine oscillators for the body and it sounded like a bell being struck, not a keyboard — pure tones ringing for hundreds of milliseconds read as tonal/musical no matter how the envelope is shaped. Exciting a damped resonator with a transient and gating it independently of the filter's own decay gives a percussive thump instead, and keeps the decay slider behaving predictably regardless of the filter's Q.

Typing-velocity dynamics. An exponential moving average of the interval between consecutive key-downs maps to an intensity multiplier applied to each new voice — a tightening cadence nudges volume/punch up, a relaxed one settles it back to baseline.

UI. AppKit NSStatusItem for the menu bar chrome, SwiftUI for the Switch Designer window, bridged with NSHostingController. State lives in a single ObservableObject that both surfaces bind to directly.

External control. Switchsmith registers a switchsmith:// URL scheme (handled via a classic kAEGetURLEvent Apple Event, the same mechanism browsers use to hand off custom-scheme links to apps) supporting switchsmith://toggle, switchsmith://enable, switchsmith://disable, and switchsmith://preset/<id>. That's the entire IPC surface — no persistent socket or server — and it's what the Raycast extension (TypeScript, @raycast/api) drives to let you toggle sound or switch presets without leaving the keyboard.

Requirements

macOS 13.5 (Ventura) or later.

Installation

Homebrew (recommended)

brew tap navadiashrey/switchsmith
brew install --cask switchsmith

Note

Switchsmith is signed ad hoc (not notarized — that requires a paid Apple Developer Program membership). On first launch, right-click the app in Applications and choose Open once to bypass Gatekeeper's unidentified developer warning; after that it opens normally.

Build from source

git clone https://github.com/navadiashrey/switchsmith.git
cd switchsmith
./make_app.sh
open Switchsmith.app

This produces Switchsmith.app via the Swift Package Manager — no Xcode project required, just the Swift toolchain that ships with Xcode or the Command Line Tools.

Grant permissions

On first launch, macOS will prompt for Accessibility. You'll also need to add Switchsmith manually under:

System Settings → Privacy & Security → Input Monitoring

Both are required for the global key monitor to receive events — see How it works above for why.

Usage

Switchsmith lives in the menu bar (keyboard icon). Click it to enable/disable, pick a preset, or open the Switch Designer to sculpt your own sound. Your settings persist across launches.

Raycast extension (optional)

cd raycast-extension
npm install
npm run dev   # opens it in Raycast for local development

Adds two commands: Toggle Switchsmith and Set Switch Preset, both driving the app via the switchsmith:// URL scheme described above. See raycast-extension/ for the source.

Project structure

Sources/Switchsmith/
├── main.swift                  # App entry point, NSApplicationDelegate
├── AppState.swift               # Central observable state, persistence
├── KeyMonitor.swift              # CGEventTap-based global key capture
├── SynthEngine.swift             # Real-time DSP voice engine
├── SwitchModel.swift              # Switch parameters + built-in presets
├── TypingVelocityTracker.swift     # Typing-speed → intensity mapping
├── StatusBarController.swift        # NSStatusItem menu bar UI
├── DesignerView.swift                # SwiftUI Switch Designer window
└── DebugLog.swift                     # Lightweight file logger

raycast-extension/                # TypeScript Raycast extension (optional)
├── src/toggle.tsx                 # No-view command: toggle enabled state
├── src/set-preset.tsx              # List view: pick a built-in preset
└── src/presets.ts                   # Mirrors SwitchModel.swift's presets

License

MIT — see LICENSE.

About

Make your keyboard sound mechanical — synthesized live in real time, no sample packs. Open-source macOS menu bar app, an alternative to Klack and Thock.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages