Usage:

This tool is built for livestreaming audio to a server hosting a tau-tower web-radio server instance. You are able to hijack an audio device connected to your computer and transmit its signal directly to this radio stream.

For convenience, the option to record the current stream is also available, encoded in the same format as the stream itself. Currently the only option is ogg opus.

---

To install:

$ cargo install --git https://github.com/tau-org/tau-radio

The first time using the tool, it will search your system for a config file. It looks for it in the directory:

$ $HOME/.config/tau/config.toml

If there is no config file located there, you will be prompted to create one.

If you want to temporarily overwrite the config, you are able to pass arguments.

# Ex: Uses temporary credentials, and disables the local recording. 
$ tau-radio \
  --username <username> \
  --password <password> \
  --no-recording

Dependencies

On macOS (using Homebrew):

$ brew install opus libopusenc libogg libshout

On Linux (using apt):

$ sudo apt update
$ sudo apt install \
  build-essential autoconf automake libtool pkg-config \
  libjack-dev libasound2-dev libpipewire-0.3-dev \
  libopus-dev libopusenc-dev libopusfile-dev opus-tools \
  libogg-dev libshout-dev