Quick Start Guide ‐ VBAN as a service (Linux)

Build VBAN from Source

Pre-requisitists

sudo apt install automake libasound-dev libpulse-dev libjack-dev

Download source from repo

Run build commands

./autogen.sh
./configure
make
sudo make install

Determine audio device

This is required when running it as a service. The default device is system default when running outside of a service.

aplay -L

Test VBAN Receptor and Emitter

Example with VBAN emitter running on 192.168.1.2:6980 with stream name TestStream with an audio device of hw:CARD=K11

vban_receptor -i 192.168.1.2 -p 6980 -s TestStream -d hw:CARD=K11

Install as a service

sudo nano /etc/systemd/system/vban.service

Example vban.service file:

[Unit]
Description=VBAN Receptor
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/vban_receptor -i 192.168.1.2 -p 6980 -s TestStream -d hw:CARD=K11
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

Note: Restart=always will restart the command if it fails to connect. If the RestartSec is too fast you will get an error after 5 restarts too quickly. You can also try After=network-online.target but YMMV and Restart=always seems more reliable to establish a connection automatically after sign-on

Enable Service

sudo systemctl enable vban.service

Reload service daemon

sudo systemctl daemon-reload

Start Service

sudo systemctl start vban.service

At this point you should have an audio stream established!