GitHub - tau-org/tau-tower: Webradio server - broadcasts audio source to clients · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
tau-org
tau-tower
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>142 Commits<br>142 Commits
.github/workflows
.github/workflows
docs
docs
src
src
.gitignore
.gitignore
Cargo.lock
Cargo.lock
Cargo.toml
Cargo.toml
LICENSE
LICENSE
README.md
README.md
flake.lock
flake.lock
flake.nix
flake.nix
rustfmt.toml
rustfmt.toml
View all files
Repository files navigation
This project is funded through NGI Zero Core, a fund established by NLnet with financial support from the European Commission's Next Generation Internet program. Learn more at the NLnet project page.
Usage:
This tool is built for livestreaming audio to the world wide web, broadcasting<br>a audio stream from an instance of<br>tau-radio, the accompanying software.
Modelled after the Icecast software, it serves a html audio stream that can be<br>used in a audio tag on any other website.
You should run this on a remote server, such as a AWS, Digital Ocean or any VPS<br>with the correct priviledges.
Note that the smallest available Digital Ocean 'Droplet' does not have enough<br>RAM to build this project locally. The workaround is to build for that<br>architecture using ex: cargo build --target x86_64-unknown-linux-gnu.
To install:
$ cargo install --git https://github.com/tau-org/tau-tower
The first time using the tool, it will search your system for a config file.<br>It looks for it in the path
$HOME/.config/tau/tower.toml # on macOS
or
$XDG_CONFIG_HOME/tau/tower.toml # on Linux
If there is no config file located there, you will be prompted to create one.
# username and password are NOT secure, they only<br># link a tauradio and tautower service together<br>username = "username"<br>password = "emanresu"
# Sets the listening port, to which the source stream is transmitted<br>listen_port = 8000
# Sets the broadcast port, from which the stream will be accessable<br>broadcast-port = 8001
# Sets the server http endpoint - http://localhost:8001/tau.ogg<br>broadcast-endpoint = "tau.ogg"
# Optional:<br># Sets which other sites are able to rebroadcast the stream<br># "*" allowes all, adding "http://localhost:4000" to list is redundant<br>cors_allow_list = ["*", "http://localhost:4000"]
If you want to temporarily overwrite the config, you are able to pass arguments.
--broadcast-port \<br>--cors-allow-list "*""># Ex: Uses temporary credentials, and disables the local recording.<br>$ tau-tower \<br>--listen-port listen-port> \<br>--broadcast-port broadcast-port> \<br>--cors-allow-list "*"
Dependencies
On Linux (using apt):
$ sudo apt update<br>$ sudo apt install build-essential
Streaming Pipeline
tau-radio runs on your local<br>machine, and captures sound from the audio device on your system. The defaults<br>are BlackHole 2ch on macOS, and pipewire on Linux, though these can be<br>overwritten by the config or in the CLI arguments.
The captured audio is then streamed to the<br>tau-tower, which should run on a<br>remote server. This server application exposes a audio media stream that can be<br>consumed by many clients, as a web radio.
Alongside tau-tower should run an instance of Asciinema<br>which can use the live audio stream as background to a live terminal stream, by<br>setting the broadcast endpoint URL as a media source in the streams settings.
https://example.com:8002/tau.ogg
For this to work, the Asciinema origin must be added to cors_allow_list in tower.toml:
cors_allow_list = ["https://example.com:4000"]
your computer
remote server
(audio capture)<br>(opt. tls/ssl)<br>(proxy)<br>(broadcaster)<br>(opt. stream host)
tau-radio -><br>internet -><br>Caddy -><br>tau-tower -><br>Asciinema
For TLS termination and reverse proxy setup, see Proxy Setup (Caddy).
About
Webradio server - broadcasts audio source to clients
Resources
Readme
License
EUPL-1.2 license
Uh oh!
There was an error while loading. Please reload this...