How justsamyog/betterkeys works
Better Keys is a Windows desktop sound-feedback app. Global keyboard and mouse events are captured and debounced, mapped through the active soundpack, then played by the audio engine; the tray UI manages packs, settings, and sound controls. Users can also import packs and edit per-key mappings. Edges are limited to calls shown in excerpts, SOURCE INDEX references, or README statements; unsampled implementation details are not asserted.
Main entry points: TrayApp.java Tray and Settings · SoundpackEditorDialog.java Pack Import Editor · KeyMapperDialog.java Key Sound Mapper · SoundpackManager.java Pack Manager
Components 19
Startup and Controls
- Application Entry
src/main/java/com/justsamyog/betterkeys/Main.java - App Configuration
src/main/java/com/justsamyog/betterkeys/config/AppConfig.java
Global Input
- Global Input Hook
src/main/java/com/justsamyog/betterkeys/input/GlobalInputListener.java
Soundpacks
- Pack Manager
src/main/java/com/justsamyog/betterkeys/model/SoundpackManager.java - Pack Model
src/main/java/com/justsamyog/betterkeys/model/Soundpack.java - Legacy Pack Converter
src/main/java/com/justsamyog/betterkeys/model/PackConverter.java - Pack Files
src/main/resources/soundpacks
Audio Playback
- Audio Engine
src/main/java/com/justsamyog/betterkeys/audio/AudioEngine.java - Default WAV Synthesis
src/main/java/com/justsamyog/betterkeys/audio/WavGenerator.java
Desktop Interface
- Tray and Settings
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Pack Import Editor
src/main/java/com/justsamyog/betterkeys/ui/SoundpackEditorDialog.java - Key Sound Mapper
src/main/java/com/justsamyog/betterkeys/ui/KeyMapperDialog.java - Keyboard View
src/main/java/com/justsamyog/betterkeys/ui/KeyboardPanel.java - Icon Rendering
src/main/java/com/justsamyog/betterkeys/ui/IconLoader.java - Gradient Panel
src/main/java/com/justsamyog/betterkeys/ui/GradientPanel.java - Glass Panel
src/main/java/com/justsamyog/betterkeys/ui/GlassPanel.java
Other components
- User
- Keyboard and Mouse
- Audio Output
Connections 27
- User → Application Entry: launches
README.md - Application Entry → Tray and Settings: starts
src/main/java/com/justsamyog/betterkeys/Main.java - Tray and Settings → App Configuration: loads and saves
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Tray and Settings → Pack Manager: manages packs
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Tray and Settings → Global Input Hook: configures
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Tray and Settings → Audio Engine: controls playback
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Keyboard and Mouse → Global Input Hook: sends events
src/main/java/com/justsamyog/betterkeys/input/GlobalInputListener.java - Global Input Hook → Audio Engine: plays mapped sounds
src/main/java/com/justsamyog/betterkeys/input/GlobalInputListener.java - Global Input Hook → Pack Model: selects variants
src/main/java/com/justsamyog/betterkeys/input/GlobalInputListener.java - Pack Manager → Pack Files: reads packs
src/main/java/com/justsamyog/betterkeys/model/SoundpackManager.java - Pack Manager → Pack Model: creates models
src/main/java/com/justsamyog/betterkeys/model/SoundpackManager.java - Pack Manager → Legacy Pack Converter: converts legacy packs
src/main/java/com/justsamyog/betterkeys/model/SoundpackManager.java - User → Pack Import Editor: imports packs
README.md - Pack Import Editor → Pack Manager: uses pack manager
src/main/java/com/justsamyog/betterkeys/ui/SoundpackEditorDialog.java - User → Key Sound Mapper: edits key mappings
README.md - Key Sound Mapper → Keyboard View: displays keyboard
src/main/java/com/justsamyog/betterkeys/ui/KeyMapperDialog.java - Key Sound Mapper → Pack Model: updates mappings
src/main/java/com/justsamyog/betterkeys/ui/KeyMapperDialog.java - Key Sound Mapper → Pack Manager: uses pack manager
src/main/java/com/justsamyog/betterkeys/ui/KeyMapperDialog.java - Audio Engine → Audio Output: plays samples
src/main/java/com/justsamyog/betterkeys/audio/AudioEngine.java - Audio Engine → Default WAV Synthesis: decodes generated WAV
src/main/java/com/justsamyog/betterkeys/audio/AudioEngine.java - Tray and Settings → Pack Import Editor: opens editor
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Tray and Settings → Key Sound Mapper: opens mapper
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Tray and Settings → Icon Rendering: renders icons
src/main/java/com/justsamyog/betterkeys/ui/TrayApp.java - Pack Import Editor → Icon Rendering: renders icons
src/main/java/com/justsamyog/betterkeys/ui/SoundpackEditorDialog.java - Pack Import Editor → Gradient Panel: uses panel
src/main/java/com/justsamyog/betterkeys/ui/SoundpackEditorDialog.java - Pack Import Editor → Glass Panel: uses panel
src/main/java/com/justsamyog/betterkeys/ui/SoundpackEditorDialog.java - Key Sound Mapper → Gradient Panel: uses panel
src/main/java/com/justsamyog/betterkeys/ui/KeyMapperDialog.java