========================================================================
             KEEBS MECHANICAL KEYBOARD AUDIO (macOS EDITION)
========================================================================

Thank you for downloading Keebs for macOS!

WHAT DOES THIS DO?
------------------------------------------------------------------------
Keebs provides ultra-low latency (<3ms), audiophile-grade mechanical 
keyboard acoustics, 3D binaural stereo spatial panning, and Force Touch 
trackpad haptics for your Mac keyboard and external mechanical keyboards.

HOW TO INSTALL ON YOUR MAC (Takes 30 seconds):
------------------------------------------------------------------------
METHOD 1 (Recommended):
1. Double-click "Keebs-macOS.dmg".
2. Drag the "Keebs" icon into the "Applications" folder shortcut.
3. Open "Keebs" from your Applications or Launchpad.

METHOD 2 (Direct App Bundle):
Double-click "Keebs.app" directly in this folder or copy it to /Applications.

FIRST-TIME PERMISSION (Accessibility):
------------------------------------------------------------------------
Because Keebs plays sounds in the background across all apps (Safari, Word, 
Slack, VS Code, Terminal, etc.), macOS requires standard Accessibility 
Permission:
1. When launched, Keebs will show an "Accessibility Permission" button.
2. Click "Grant Permission" to open System Settings -> Privacy & Security -> Accessibility.
3. Toggle "Keebs" to ON.
4. Keebs will immediately start playing mechanical sounds!

WHERE IS THE APP?
------------------------------------------------------------------------
- Menu Bar Extra:
  Look for the mechanical keyboard switch stem icon in your top macOS menu bar.
  Click it to open the sleek dark quick-controls popover (Community Library 
  paginated to 4 switches per page, master volume, upstroke clack, launch on boot).
- Keebs Studio:
  Click "Open Keebs Studio..." to open the full industrial console with 
  Switch Showroom (6 per page), binaural stereo controls, velocity burst 
  dynamics, and live test typing pad.

FEATURES INCLUDED:
------------------------------------------------------------------------
* 10+ Built-in Artisan Switches (Holy Panda, Cherry MX Blue, NovelKeys Cream, 
  Cherry MX Brown, Gateron Oil King, IBM Model M Buckling Spring, etc.).
* 32-player pre-warmed audio ring-buffer (Sub-3ms instantaneous latency).
* 3D Binaural Stereo Panning (-55% left to +55% right).
* Force Touch Trackpad Haptic alignment feedback on every key bottom-out.
* Velocity Burst Dynamics (+10% volume punch on rapid typing <110ms).
* Micro-Pitch Humanization Jitter (+/-2% organic variance).
* Long-Press Autorepeat Suppression: Holding Delete/Backspace produces one 
  click and stays silent while held.
* Smart Mute: Auto-mutes during microphone calls (Zoom, Meet, Teams, Discord, 
  FaceTime) and password managers (1Password, Bitwarden, Apple Keychain).

Enjoy typing!
========================================================================
