Page 1 of 1
Matrix CLI
Posted: Fri Jan 19, 2024 1:35 am
by Andew212
Hello, is there a way to access the Audio Matrix CLI externally?
Eg, does it expose a TCP server on a certain port or anything like that?
I would like to be able to control it from another program.
Thank you!
Re: Matrix CLI
Posted: Fri Jan 19, 2024 6:44 am
by Vincent Burel
by VBAN-TEXT request only for the moment.
see second message:
viewtopic.php?t=588
Re: Matrix CLI
Posted: Fri Jan 19, 2024 7:29 am
by Andew212
Thanks Vincent!
However I am still a little confused. So once VBAN is on, it opens a UDP server on port 6980 correct?
And then I should be able to send packets to it using the TEXT type to send CLI commands?
Could you help me with an example packet? Once I get the first one I can go from there.
If I want to send the cli command Point(ASIO64A.IN[6],ASIO64A.OUT[3]).dBGain = 0.0;
Would I send a packet as below:
VBANR\00\00\10Point(ASIO64A.IN[6],ASIO64A.OUT[3]).dBGain = 0.0; //sent as ASCII
to port 6980 as UDP?
I am using packet sender (
https://packetsender.com) to test, but if you could suggest something better that would be great!
Re: Matrix CLI
Posted: Fri Jan 19, 2024 9:37 am
by Vincent Burel
Basically yes, but if you don't program it, you may use MacroButtons (installed with any Voicemeeter).
and define you request like this for example:
SendText("vban1",Point(ASIO64A.IN[6],ASIO64A.OUT[3]).dBGain = 0.0;);
see user manual page 54:
https://vb-audio.com/Voicemeeter/Voicem ... Manual.pdf
Re: Matrix CLI
Posted: Sun Jan 21, 2024 6:14 am
by Andew212
Thanks Vincent, I have got this working now.
My problem was I didnt realise that VBAN stream 1-6 were audio, 7 was MIDI, and 8 was ascii.
Used the correct VBAN stream and have control now.
One more question. I can set all the commands I want, but is there a way to query the state of a command without changing it? So like can I read the current state of a point in the matrix?
Thank you!
Re: Matrix CLI
Posted: Fri Jun 28, 2024 7:28 pm
by onyx_online
Here is a CLI program that can be used to send VBAN-TEXT instructions to Matrix. There is an example in the README.
https://github.com/onyx-and-iris/vbantxt-cli
If you're not sure how to build the program I've included executables in the repo's Releases section.
Re: Matrix CLI
Posted: Sat Jul 06, 2024 4:33 pm
by maby
onyx_online wrote: Fri Jun 28, 2024 7:28 pm
Here is a CLI program that can be used to send VBAN-TEXT instructions to Matrix. There is an example in the README.
https://github.com/onyx-and-iris/vbantxt-cli
If you're not sure how to build the program I've included executables in the repo's Releases section.
That is extremely helpful, onyx_online!
Can I repeat Andrew's question which was not answered as far as I can see - is this command channel strictly one way, or is it also possible to read parameters from Voicemeeter and Matrix?
Martin
Re: Matrix CLI
Posted: Sat Jul 06, 2024 8:36 pm
by onyx_online
The vbantxt-cli can only be used to send requests.
To receive data a client program must subscribe to the VBAN RT Packet service.
Vincent has provided an example of this in the vmr_streamer source code:
https://github.com/vburel2018/Voicemeet ... vban_cmd.c
As far as I know this is currently only possible for Voicemeeter, but not Matrix.
Re: Matrix CLI
Posted: Mon Mar 02, 2026 2:55 am
by onyx_online
I wanted to leave an update on this thread. I've recently put together a CLI working over VBAN that can be used to communicate with Voicemeeter and Matrix. It's possible to send and read values with some limitations, check the README for more info.
https://github.com/onyx-and-iris/vban-cli
It's written in python so it's not a single binary unlike vbantxt but if you're familiar with the python ecosystem you can install vban-cli with a one-line command using uv or pipx.
Since it's written in python it should be able to run fine on Windows/Linux/Mac, both locally as well as remotely.