• Real-time keyboard key press/release sound playback
• Real-time mouse click sound playback
• Multiple bundled sound packs for both keyboard and mouse
• User sound packs under ~/.local/share/vbx/audio/
• Background daemon mode with PID file and safe shutdown
• Live config reload on ~/.vbx.json changes (daemon mode)

• build-essential
• pkg-config
• libjson-c-dev
• libpulse-dev
• libsndfile1-dev
• libinput-dev
• libevdev-dev
• libudev-d

paru -S vbx-git

git clone https://github.com/S4NKALP/vbx.git
cd vbx
make
sudo make install

Usage: vbx [OPTIONS]

Options:
  -S, --sound SOUND_NAME        Select sound pack (default: eg-oreo)
  -V, --volume VOLUME           Set volume [0-100] (default: 50)
  -d --daemon                   Run as a background daemon
  -s --stop                     Stop the background daemon
  -m --mute                     Mute sound
  -u --unmute                   Unmute sound
  -- enbale/disable DEVICE_NAME Enable/disable a device
  -l, --list                    List available sound packs
  -f, --system-volume-following=0/1 Enable/disable dynamic tracking of system volume (default: 0)
  -h, --help                    Show this help message
  -v, --verbose                 Enable verbose output

Notes:

• First run creates ~/.vbx.json. Subsequent runs use it unless --config is supplied.
• In daemon mode, editing ~/.vbx.json will automatically reload.

vbx lets you control your volume in three ways:

1. Keyboard Volume (--volume): Sets the base volume for your keyboard sounds (from 0 to 100).
2. Mouse Volume (--mouse-volume): Sets the base volume for your mouse clicks (from 0 to 100).
3. System Volume Multiplexer (--system-volume-following=1): When turned on, vbx automatically scales the app's sound to match your computer's main volume slider.

How the multiplexer works: Instead of just cutting the volume linearly (which makes sounds too quiet at 50% OS volume), the multiplexer uses a gentle boost curve. This means if you lower your computer's volume, your typing sounds will still be punchy and easy to hear without ever being too loud!

Example: If you set your keyboard volume to 50% (vbx --volume 50 --system-volume-following 1), and your computer's master volume is currently at 80%, vbx will intelligently scale its own output down to securely match your OS levels, without you having to change your vbx settings every time you watch a quiet video!

System packs are installed under: /usr/share/vbx/soundpacks/

User packs go under: ~/.local/share/vbx/soundpacks/<device-name>/<pack-name>/

Required files inside each <pack-name>/ directory:

• config.json (format matches bundled packs)
• Audio files referenced by config.json

Contributions are welcome! Feel free to open issues or submit pull requests.

MIT — see LICENSE.

• MechVibes for sound packs
• mechavibes-dx for sound packs
• showmethekey for code