vban-cli 0.4.1

A command-line interface for Voicemeeter leveraging VBAN.

vban-cli

---

Install

With uv

uv tool install vban-cli

With pipx

pipx install vban-cli

The CLI should now be discoverable as vban-cli

---

Configuration

Flags

vban-cli --host=localhost --port=6980 --streamname=Command1

Environment Variables

example .envrc:

#!/usr/bin/env bash

export VBAN_CLI_HOST="localhost"
export VBAN_CLI_PORT=6980
export VBAN_CLI_STREAMNAME=Command1

---

Use

Usage: vban-cli COMMAND

╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ bus          Control the bus parameters.                                                         │
│ strip        Control the strip parameters.                                                       │
│ --help (-h)  Display this message and exit.                                                      │
│ --version    Display application version.                                                        │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Parameters ─────────────────────────────────────────────────────────────────────────────────────╮
│ --kind        Kind of Voicemeeter [env var: VBAN_CLI_KIND] [default: potato]                     │
│ --host        VBAN host [env var: VBAN_CLI_HOST] [default: localhost]                            │
│ --port        VBAN port [env var: VBAN_CLI_PORT] [default: 6980]                                 │
│ --streamname  VBAN stream name [env var: VBAN_CLI_STREAMNAME] [default: Command1]                │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

For every command and subcommand there exists a --help flag for further usage information.

---

Implementation Notes

1. The VBAN TEXT subprotocol defines two packet structures ident:0 and ident:1. Neither of them contain the data for Bus EQ parameters.
2. Packet structure with ident:1 is emitted by the VBAN server only on pdirty events. This means we do not receive the initial state of those parameters on initial subscription. Therefore any commands which are intended to fetch the value of parameters defined in packet ident:1 will not work in this CLI.
3. Packet structure with ident:1 defines parameteric EQ data only for the first channel.

---

Further Notes

I've made the effort to set up the basic skeletal structure of the CLI as well as demonstrate how to combine subcommand groups with subcommand groups so more can be implemented, it just needs doing. There may be restrictions on some things however, for example, retrieving values is only possible for parameters defined in the protocol. Setting parameters can be done for anything possible by a string request.

Shell completion scripts are available (for zsh, bash and fish) but I haven't tested them

Some of the help output needs improving for commands that branch off positional arguments.

If there's something missing that you would like to see added the best bet is to submit a PR. You may raise an issue and if it's quick and simple to do I may (or may not) do it.

---

License

vban-cli is distributed under the terms of the MIT license.