How anjudeepveerla/shortgun-keyboard-by-vad- works
ShotgunKeyboard is a macOS and Windows desktop app that plays selected sound effects on key-down events. Users configure sounds, selection mode, volume, and armed state; the platform app monitors keyboard events, chooses a configured sound, and plays it. Both platforms also support importing sounds and local settings, while macOS uses a menu-bar item and Windows a notification-area tray. Platform behavior is consolidated in each app’s main source file; links reflect only relationships shown in the excerpts or README.
Main entry points: main.swift macOS app and controls · Program.cs Windows app and controls · bundled-sounds Bundled effects · generate_sound.py Generated WAV effects
Components 13
macOS app
- macOS app and controls
main.swift - macOS audio playback
main.swift - macOS local settings
main.swift - macOS key monitoring
main.swift
Windows app
- Windows app and controls
windows/Program.cs - Windows audio engine
windows/Program.cs - Windows local settings
windows/Program.cs - Windows key hook
windows/Program.cs
Sound assets
- Bundled effects
bundled-sounds - Generated WAV effects
generate_sound.py
Other components
- Desktop user
- macOS
- Windows
Connections 20
- Desktop user → macOS app and controls: configures
README.md - Desktop user → Windows app and controls: configures
README.md - macOS app and controls → macOS key monitoring: starts monitoring
main.swift - macOS key monitoring → macOS app and controls: reports key-down
main.swift - macOS app and controls → macOS audio playback: plays selected
main.swift - macOS app and controls → macOS local settings: loads and saves
main.swift - macOS app and controls → Bundled effects: uses effects
README.md - macOS app and controls → Generated WAV effects: includes generated effects
README.md - macOS → macOS key monitoring: provides key events
README.md - macOS app and controls → macOS: requests permissions
README.md - Desktop user → Windows app and controls: configures
README.md - Windows app and controls → Windows key hook: creates hook
windows/Program.cs - Windows key hook → Windows app and controls: calls key-down
windows/Program.cs - Windows app and controls → Windows audio engine: plays selected
windows/Program.cs - Windows app and controls → Windows local settings: loads and saves
windows/Program.cs - Windows app and controls → Bundled effects: extracts effects
windows/Program.cs - Windows app and controls → Generated WAV effects: includes generated effects
README.md - Windows → Windows key hook: provides key events
windows/Program.cs - Desktop user → macOS app and controls: imports sounds
README.md - Desktop user → Windows app and controls: imports sounds
README.md