Setup - RWAV Bridge

Quick Start

Download the installer from Downloads.
Install RWAV Bridge on a machine on the same LAN as your Roon Core.
Open Roon → Settings → Extensions → Enable “RWAV Bridge”.

Overview

RWAV Bridge is a Roon Extension that exposes safe HTTP endpoints your MCP server uses to browse, play, and manage the queue. Install the Bridge on any machine on the same LAN as your Roon Core (often the same host). Then enable it in Roon’s Extensions.

Prerequisites

A running Roon Core and the Roon app signed in on the same network.
Local admin rights to install an app/service.
Network allows multicast discovery and local HTTP:
- UDP 5353 (mDNS/Bonjour)
- UDP 1900 (SSDP)
- TCP 3002 (Bridge HTTP; default)

Download & Install

macOS

Download the RWAV Bridge installer from https://www.rwav-bridge.co.uk.
Open the installer; if macOS blocks it, go to System Settings → Privacy & Security → “Open Anyway”.
On first run, grant “Network” access if prompted.

Windows

Download the .exe from https://www.rwav-bridge.co.uk and run as Administrator.
If SmartScreen warns, allow and continue (verify publisher).

Linux (x64)

Pick one:

DEB (Ubuntu/Debian)

Download the DEB from the Downloads page.
Install: sudo apt install ./rwav-bridge-linux_1.1.6_amd64.deb
If using dpkg: sudo dpkg -i rwav-bridge-linux_1.1.6_amd64.deb && sudo apt -f install
Run/verify: curl http://localhost:3002/version

Portable tar.gz (any distro)

Download the portable tarball from the Downloads page.
Extract: tar -xzf rwav-bridge-linux-x64-portable.tar.gz -C /opt
Move: mv /opt/rwav-bridge-linux-x64-portable /opt/rwav-bridge
Start: cd /opt/rwav-bridge, then chmod +x run.sh, then ./run.sh
Verify: curl http://localhost:3002/version

Optional (verify checksum)

sha256sum rwav-bridge-linux-x64-portable.tar.gz
  eef67e2e599edcc37ae6ab19c7c1f00eb35454986fe09e8230a60570cfb49c73
sha256sum rwav-bridge-linux_1.1.6_amd64.deb
  7836b868519b4fd115ba90caeb55ef3d54e80f5d21a4ee019c9c9392847e9de5

Headless (systemd)

If the DEB ships a unit, enable it:
  sudo systemctl enable --now rwav-bridge

Otherwise create /etc/systemd/system/rwav-bridge.service:
[Service]
ExecStart=/usr/bin/rwav-bridge
Restart=on-failure

[Install]
WantedBy=multi-user.target

Then:
  sudo systemctl daemon-reload
  sudo systemctl enable --now rwav-bridge
  systemctl status rwav-bridge
  curl http://localhost:3002/version

Enable in Roon

Open the Roon app → Settings → Extensions.
Toggle “Enable Extensions” on.
Find “RWAV Bridge” in the list, click “Authorize/Enable”.
The Bridge should show a status (Running) and the host it’s on.

Verify the Bridge

From the Bridge host:

curl http://localhost:3002/version       # returns a version string
curl http://localhost:3002/capabilities  # returns a JSON capability snapshot

Firewall & Network Tips

Allow inbound TCP 3002 to the Bridge host (LAN scope).
Allow UDP 5353 (mDNS) and UDP 1900 (SSDP) for discovery on the LAN.
Ensure the Bridge and Roon Core are on the same subnet/VLAN; avoid guest/Wi‑Fi isolation.

Headless (systemd) on Linux

Create a unit file at /etc/systemd/system/rwav-bridge.service pointing to the Bridge binary:

[Service]
ExecStart=/usr/local/bin/rwav-bridge
Restart=on-failure

[Install]
WantedBy=multi-user.target

Then:

sudo systemctl daemon-reload && sudo systemctl enable --now rwav-bridge
systemctl status rwav-bridge
curl http://localhost:3002/version

Upgrades

Stop the app/service.
Install the new version from https://www.rwav-bridge.co.uk.
Start the app/service, then re-verify /version and /capabilities.

Troubleshooting

Bridge not listed in Roon Extensions

Toggle “Enable Extensions” off/on; restart Roon.
Reinstall/Restart the Bridge.
Verify same LAN/subnet; disable guest/Wi‑Fi isolation.

MCP can’t connect (discovery)

Try RWAV_BASE=http://<bridge-host>:3002.
Check firewall rules for TCP 3002; allow UDP 5353/1900.

404/timeout from endpoints

Confirm the Bridge process is running and /capabilities works locally.
If using a VPN, ensure local LAN access is enabled.