feat(root): add system-volume-following flag and multiplexer functionality
The flag enables automatic scaling of vbx output to match the host system's volume, improving user experience without manual adjustments. - New Feature: Added `--system-volume-following=0/1` option to enable dynamic tracking. - Enhancement: Implemented intelligent volume scaling that maintains punchiness across different OS volume levels. - Enhancement: Updated documentation with detailed explanation of volume mechanics.
This commit is contained in:
1 file changed
+15
-1
@@ -72,14 +72,28 @@ sudo make install
|
||||
-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 `-c` is supplied.
|
||||
- First run creates `~/.vbx.json`. Subsequent runs use it unless `--config` is supplied.
|
||||
- In daemon mode, editing `~/.vbx.json` will automatically reload.
|
||||
|
||||
## 🔊 Volume Mechanics
|
||||
|
||||
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!
|
||||
|
||||
## 🎵 Sound Packs
|
||||
|
||||
System packs are installed under: `/usr/share/vbx/soundpacks/`
|
||||
|
||||
Reference in new issue
Block a user