Panaudia Link is a MacOS application that can be used to stream uncompressed multi-track audio in and out of a Panaudia Space.
You can stream Object Based Audio into a Space, sending in both broadcast quality audio streams and streams of XYZ position data.
You can stream up to 3rd order 16ch ambisonic audio out of a Space allowing you to present it in a multi speaker auditorium.
Panaudia Link is a simple utility application built on top of two amazing open source projects: Tailscale and Roc Toolkit.
Roc Toolkit is an essential component of Panaudia Link it provides resilient, high-quality, multi-track audio streaming and virtual device drivers for MacOS.
We have chosen to use Roc Toolkit as our priorities are quality and stability across the WAN rather than very low latency or operation on a prepared network.
To use Panaudia Link you will need to install the Roc Virtual Audio Device for macOS. We provide a build of this driver bundled with the Panaudia Link app.
Use of Tailscale is optional with Panaudia, it provides secure VPN tunnelling using Wireguard and NAT traversal giving excellent security and capability for connections between clients and our servers. Tailscale's core technology is open source, but we also use their commercial SaaS to provide secure networking
To use Panaudia Link with Panaudia Cloud you will need an account with Tailscale and to install their client on your Mac. Their free personal plan works perfectly.
If you are hosting Panaudia yourself you don't need to use Tailscale, and it will still work fine. Panaudia's software has no intrinsic dependency on Tailscale, but we have chosen to use it for our cloud service.
You will need a computer running MacOS >= 15.0 (Sequoia).
To install Panaudia Link:
Panaudia Link creates Virtual Audio Devices that appear alongside all other audio devices on your Mac. This makes Panaudia Link compatible with any audio software that can play and receive audio, simply select the Panaudia Send or Panaudia Receive device in your software's settings.
Panaudia Link runs a local OSC server that can receive automation OSC messages from any software, like Max/MSP or Grapes, that uses OSC to control Object Based Audio. Panaudia Link forwards these messages to the Panaudia Space.
Panaudia Link supports a subset of the ADM-OSC standard plus one custom message
| /adm/obj/n/xyz | f f f | Object position | ADM-OSC |
| /adm/obj/n/name | s | Object name | ADM-OSC |
| /pan/obj/n/colour | i | Object colour | Custom |
| /adm/lis/xyz | f f f | Listener position | ADM-OSC |
By default, the server listens on port 4001 but this can be changed in the OSC tab.
The Send tab in Panaudia Link can be used to send multi-track Object Based Audio into a Panaudia Space.
The Virtual Audio Device section of the settings lets you configure and create a multi-track output Virtual Audio Device on your Mac
You can add and remove tracks, and then click Create Device to create the Virtual Audio Device.
Once the device has been created you cannot change it number of tracks, but you can change their name, position or colour.
The Virtual Audio Device will remain in your system after you close the app, to remove it click Remove Device.
Space Host is the address of the Space
To connect to a Panaudia Space running locally set this to:
localhost:8080
To connect to a Panaudia Cloud Space set this to the link ID for the Space's web page eg:
link-7004a463-5fd6-4546-9eae-9a91622c6fe2
When you press Connect Panaudia Link will try to connect to the Space.
When you press Disconnect Panaudia Link will disconnect from the Space and stop streaming audio.
The Virtual Audio Device section of the settings lets you configure and create a multi-track input Virtual Audio Device on your Mac
You can choose between a 2nd Order and a 3rd Order device.
At the moment Panaudia Cloud only supports 2nd Order streaming.
The Virtual Audio Device will remain in your system after you close the app, to remove it click Remove Device.
You can choose between two different types of ambisonic normalisation SN3D and N3D
You can adjust the position of the ambisonic renderer in the Space.
You can achange the ports being used by Roc Toolkit if they conflict with other software on your computer.
Space Host is the address of the Space
To connect to a Panaudia Space running locally set this to:
localhost:8080
To connect to a Panaudia Cloud Space you will have to be logged into our tailscale and set this to the link ID for the Space's web page eg:
link-7004a463-5fd6-4546-9eae-9a91622c6fe2
When you press Connect Panaudia Link will try to connect to the Space.
When you press Disconnect Panaudia Link will disconnect and stop receiving audio.
To fully delete Panaudia Link: