Skip to content

Releases: vyixor/tapaccumulator

⚡ TapAccumulator v1.3.0

30 May 16:25
79877a8

Choose a tag to compare

⚡ 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_ms in 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

  1. Download TapAccumulator.zip below
  2. Extract it anywhere — Desktop, Program Files, wherever you prefer
  3. Run TapAccumulator.exe
  4. On first launch, a welcome guide walks you through everything
  5. Go to ⌘ Tap Commands → pick a tap count → enter a command → click ⚡ Register Command
  6. 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.