Matrix CLI

VB-Audio Matrix, Virtual Audio Router Application for Windows (Discussion and Support).
Post Reply
Andew212
Posts: 3
Joined: Wed Jan 17, 2024 12:52 am

Matrix CLI

Post 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!
Vincent Burel
Site Admin
Posts: 2061
Joined: Sun Jan 17, 2010 12:01 pm

Re: Matrix CLI

Post by Vincent Burel »

by VBAN-TEXT request only for the moment.

see second message:
viewtopic.php?t=588
Andew212
Posts: 3
Joined: Wed Jan 17, 2024 12:52 am

Re: Matrix CLI

Post 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!
Vincent Burel
Site Admin
Posts: 2061
Joined: Sun Jan 17, 2010 12:01 pm

Re: Matrix CLI

Post 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
Andew212
Posts: 3
Joined: Wed Jan 17, 2024 12:52 am

Re: Matrix CLI

Post 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!
onyx_online
Posts: 6
Joined: Mon May 11, 2020 8:36 pm

Re: Matrix CLI

Post 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.
maby
Posts: 1
Joined: Thu Dec 22, 2022 5:05 pm

Re: Matrix CLI

Post 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
onyx_online
Posts: 6
Joined: Mon May 11, 2020 8:36 pm

Re: Matrix CLI

Post 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.
Post Reply