Taptap elevates your daily typing and mouse interactions into a rich, three-dimensional acoustic experience. Engineered with Web Audio API HRTF spatial algorithms, bespoke luxury acoustics, low-latency system-wide hooks, and cryptographic sound containers, Taptap delivers authentic mechanical switch reverberation mapped dynamically across your soundstage.
▶ Launch Live Web Demo & Testing Soundstage
- 🌐 3D Binaural Soundstage: Realistic spatial audio positioning using Web Audio API
PannerNodewith HRTF panning and Z-axis vertical elevation. Every keystroke is dynamically rendered across a 3D stereo acoustic field corresponding to keyboard physical key positions. - 🛡️ Cryptographic Acoustic Vault (
.tap): ProprietaryTAPTAP_VAULT_V1container architecture with symmetric in-memory stream descrambling and tokenized sample indexing. Audio assets remain protected with zero raw audio exposure. - 🔒 Single-Instance Architecture: Built-in OS instance lock (
app.requestSingleInstanceLock) prevents multiple processes from conflicting. Launching a second instance automatically focuses the existing session without duplicate audio or tray icons. - ⌨️ 17 Curated Luxury Switch Acoustics & 8 Mouse Models: Handcrafted acoustic profiles spanning Linear (Lofree Pulse/Surfer, Akko Piano Pro, Akko Cream Yellow, Gateron Ink Black/Red, Tealios, NovelKeys Cream, Keychron Red), Tactile (Holy Panda, Keychron Brown), Clicky (Kailh Box Navy, Akko Pink), Muted/Novelty (Lofree Void, IQUNIX MQ80, Lizard Pop), plus 8 high-fidelity tactile mouse click profiles.
- 🎨 Cute & Friendly Aesthetic: Warm alabaster linen (
#f4f0e6) and royal bordeaux (#721825) palette, cute rounded Quicksand & Nunito typography, fluid light & dark themes, and a frameless glass-inspired window. - ⚡ Ultra Low-Latency Native Hooks: Backed by
uiohook-napifor global, non-intrusive background key and mouse event interception across any application. - 🎯 Interactive Typing Test & Soundstage Radar: Real-time canvas radar visualizer tracking acoustic trajectory, paired with a live typing speed mini-game featuring 3-second countdowns, real-time WPM, accuracy tracking, and acoustic feedback.
- 🪟 Stealth Mode & Tray Integration: Seamless Windows system tray integration, background execution, and global instant mute toggle (Ctrl + Shift + M).
Taptap is built to run both as a standalone desktop companion and as an instant web testing environment:
| Capability | Live Web Demo (GitHub Pages) | Native Desktop Application |
|---|---|---|
| Instant In-Browser Sound Testing | ✅ Yes (Zero installation) | ✅ Yes |
| Interactive Typing Mini-Game | ✅ Yes | ✅ Yes |
| Full 17 Switch & 8 Mouse Vault | ✅ Yes (In-memory decrypt) | ✅ Yes (In-memory decrypt) |
| 3D HRTF Soundstage & Radar Visualizer | ✅ Yes | ✅ Yes |
| Light / Dark Luxury Themes | ✅ Yes | ✅ Yes |
| System-Wide Background Hooks | ❌ (Browser sandbox limited) | ✅ Yes (Active in all apps) |
| System Tray Stealth Mode | ❌ | ✅ Yes |
Global Mute Hotkey (Ctrl+Shift+M) |
❌ | ✅ Yes |
| Single-Instance Enforcement | ❌ | ✅ Yes |
👉 Try the Live Web Demo now: mightyiest.github.io/taptap
┌────────────────────────────────────────────────────────┐
│ Global System-Wide Input │
│ (Keyboard & Mouse via uiohook-napi) │
└───────────────────────────┬────────────────────────────┘
│ (Low-latency IPC)
▼
┌────────────────────────────────────────────────────────┐
│ Taptap Electron Renderer │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Acoustic Vault Descrambler │ │
│ │ • In-Memory XOR Stream Cipher │ │
│ │ • Tokenized Sample Hash Lookup │ │
│ └────────────────────────┬─────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Web Audio API Spatial Engine │ │
│ │ • HRTF Spatial Panner (X/Y/Z Coordinates) │ │
│ │ • Dynamic Stereo Spread & Micro-Pitch Variance │ │
│ │ • Gain Normalization & Anti-Clipping Limiter │ │
│ └────────────────────────┬─────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Soundstage Radar Visualizer │ │
│ │ • 60 FPS HTML5 Canvas Coordinate Renderer │ │
│ └──────────────────────────────────────────────────┘ │
└───────────────────────────┬────────────────────────────┘
│
▼
[ 3D Binaural Spatial Audio Output ]
- Node.js (v18.0 or higher recommended)
npm(bundled with Node.js)
-
Clone the repository:
git clone https://github.com/Mightyiest/taptap.git cd taptap -
Install dependencies:
npm install
-
Launch Desktop App (Electron):
npm start
-
Launch Web Preview Locally:
npm run preview
This repository includes automated GitHub Pages deployment via GitHub Actions (.github/workflows/deploy-pages.yml) and .nojekyll protection.
To activate GitHub Pages for your repo:
- Go to your repository on GitHub:
https://github.com/Mightyiest/taptap - Click Settings ➔ Pages (in the left sidebar).
- Under Build and deployment ➔ Source:
- Choose GitHub Actions (recommended — deploys automatically on push).
- Or select Deploy from a branch ➔ select branch
mainwith folder/ (root)and click Save.
- Your live interactive testing companion will be live at:
https://mightyiest.github.io/taptap/
Compile standalone production installers and single-file portable executables using electron-builder:
# Build complete Windows distribution (NSIS Installer + Portable)
npm run dist
# Build NSIS Setup Installer only
npm run dist:nsis
# Build Single-File Portable Executable only
npm run dist:portableBuilt executables and installer packages are generated into the dist/ directory.
Taptap includes a built-in cryptographic asset manager:
# Verify integrity of all encrypted sound containers and security perimeter
npm run vault:verify
# Pack raw sound directories into .tap binary containers
npm run vault:packNote
Audio Protection Perimeter: All audio samples are tokenized and protected inside proprietary .tap containers. Raw audio files (.wav, .mp3) are strictly blocked from version control by policy and .gitignore rules.
| Shortcut / Control | Function |
|---|---|
| Ctrl + Shift + M | Global Toggle Mute / Unmute (Desktop) |
| Window Close [✕] | Minimizes smoothly to System Tray (Desktop) |
| Tray Double-Click | Restores Taptap window to focus |
| Spatial Spread Slider | Adjusts binaural stereo separation width (0% – 200%) |
| Elevation Toggle | Enables 3D vertical soundstage acoustics (Z-axis) |
| Single Instance | Prevents duplicate windows; focuses active instance |
Taptap/
├── .github/
│ └── workflows/
│ └── deploy-pages.yml # Automated GitHub Pages deployment
├── .agents/ # AI Agent guidelines and audio protection rules
├── .gitignore # Excludes binaries, raw audio, and node_modules
├── .nojekyll # GitHub Pages static asset pass-through
├── assets/
│ ├── brands/ # High-resolution brand and manufacturer badges
│ ├── vault/ # Encrypted .tap binary soundpack containers
│ ├── icon.ico # Windows application icon
│ └── icon.png # Application logo
├── scripts/
│ ├── pack-sounds.js # Vault packager
│ └── vault-cli.js # Vault verification and encryption CLI
├── app.js # UI controllers, radar canvas, typing test engine
├── audio-engine.js # Web Audio API spatial engine and vault descrambler
├── main.js # Electron main process, tray, single-instance lock
├── index.html # Luxury frameless application interface
├── styles.css # Luxury Beige & Maroon design system & themes
├── package.json # Project metadata, build specs, dependencies
├── LICENSE # MIT License
└── README.md # Project documentation
This project is licensed under the MIT License.
Crafted with meticulous attention to acoustic fidelity and bespoke design.