Releases: vyixor/tapaccumulator
⚡ TapAccumulator v1.3.0
⚡ TapAccumulator v1.3.0
Turn your earbud button into a programmable multi-tap macro launcher.
2× lock screen · 3× launch Spotify · 4× run a script — completely hands-free.
🎉 First Public Release
This is the inaugural release of TapAccumulator — a Windows automation tool that intercepts your Bluetooth earbud's media button and maps tap patterns to shell commands, scripts, and system actions.
📦 What's in this release
| File | Size | Description |
|---|---|---|
| TapAccumulator.zip | ~26 MB | Self-contained Windows executable |
⚙️ Default Configuration
On first run TapAccumulator creates %APPDATA%\TapAccumulator\settings.json with sensible defaults. Everything is tunable — capture mode, tap timeout, filter threshold, TTS voice, and more. The Settings page in the UI exposes all values, or edit the JSON directly.
🐛 Known Limitations
- Hook and Mix modes may register phantom taps from browser auto-replay or media automation tools. The app warns you on startup and offers a one-click path to switch to Reclaim mode.
- Startup grace period (default 5 seconds) blocks tap detection briefly after launch to filter Windows boot-storm media events.
- Some Bluetooth adapters fire two events per button press. If taps double-register, increase
tap_debounce_msin Settings.
📋 Changelog
v1.3.0 — Initial public release
- Stealth Mix mode with automatic hook-first focus strategy
- Unified input filter (keyboard · mouse · scroll) with configurable threshold
- Windows SAPI TTS per macro with voice index, rate, and volume controls
- Always-on system tray with custom earbud icon
- Reclaim Media Focus tray action with Windows toast notification
- First-run welcome modal and hook mode warning dialog
- Full settings page — all engine parameters exposed in UI
- Non-destructive settings.json upgrades — new keys merge without overwriting
- Boot-storm guard with configurable grace period
✨ Features
- Multi-tap detection — map 2 through 8 taps to different commands
- Three capture modes — Mix (smart default), Hook (passive), Reclaim (exclusive)
- Works alongside YouTube and Spotify — no pausing, no interference
- Voice confirmation — optional Windows SAPI speech text per macro
- Modern dark UI — live event stream, real-time tap counter, settings page
- Always-on system tray — toggle listener, reclaim media focus on demand
- Boot-storm guard — ignores phantom events during Windows startup
- Fully portable settings — human-readable JSON at
%APPDATA%\TapAccumulator\
🚀 Getting Started
- Download
TapAccumulator.zipbelow - Extract it anywhere — Desktop, Program Files, wherever you prefer
- Run
TapAccumulator.exe - On first launch, a welcome guide walks you through everything
- Go to ⌘ Tap Commands → pick a tap count → enter a command → click ⚡ Register Command
- Tap your earbud button and watch it fire
💻 System Requirements
| OS | Windows 10 or Windows 11 |
| Architecture | x64 |
| Runtime | None — fully self-contained |
| Hardware | Any Bluetooth earbud or wireless headset with a media button |
Found a bug? Open an [issue](https://github.com/vyixor/tapaccumulator/issues).
Like the project? A ⭐ star goes a long way.