Installation#

⚠️ Radiotomate is still in beta. Some bugs may remain and it lacks some features we'd like to have in a genuine "V1". But it is already quite stable and upcoming versions will be able to update existing installs, so you can already give it a try.

Requirements#

  • Some music and jingles - at least one of each!
  • Disk space requirements depends on the average quality (and length) of music and episodes you'll broadcast, but also how often you want to clean up old sounds. Radiotomate's containers use a bit more than 2GB, so you need a few GB to test. In production, something between 100GB and 1TB should be comfortable.
  • A computer dedicated to that automation. We recommend Debian or Ubuntu.
Windows users: click here! You can test Radiotomate thanks to WSL. Start Powershell and type: 
wsl --install
Choose a username and a password, after the installation close Powershell and start wsl to have a terminal where you can install Radiotomate.
Radiotomate will not start automatically at boot ([contact us](community.md) if you know how to do that). After your test, you can remove WSL as a whole by typing in Powershell: 
wsl --unregister Ubuntu
wsl --uninstall

Install#

Open a terminal. Copy-paste the following command an press enter:

wget -O - https://radiotomate.org/install.sh | bash

This command will download the program, it might need your password (if it needs to sudo apt install podman). Then the terminal will show you the link to the installer, copy-paste that link in a browser or click on it while holding Ctrl:

screenshot of a terminal showing the link

Notes:

  • If you are installing on a remote machine, replace localhost in the link by the correct hostname or IP address.
  • If you prefer to install Radiotomate in a specific folder, cd to this folder before launching the installation.

Note for later that if you want to stop the application, type in the same terminal:

systemctl --user stop radiotomate

If you want to start (or restart) the application, type:

systemctl --user restart radiotomate

Things to do after the installation#

  • Start by creating a jingles cart that contains at least one sound.
  • Copy some music files to the radiotomate_data/MusicDropbox folder. In less than a minute these files should move to radiotomate_data/Music and start playing.
  • Add music via the Web application, create auto-DJ slots and carts to experiment Radiotomate's unique playback logic.
  • Share access to other people in your radio by creating user accounts. Before that:

The interface is started behind port 6811, but it is not secured (as the s in HTTPS) and maybe blocked by your firewall. If you want to access the application via the Internet, you need to setup a Web server to proxy port 6811. You probably also want to proxy port 6800, where Radiotomate is listening for a live stream.

soon: here we'll explain how to set-up Caddy in front of Radiotomate and Icecast.

You can also review configuration options to improve Radiotomate's integration with your radio's software. Later on, consider our recommended maintenance measures.

In case of trouble#

If the system is not starting, see the maintainance section.

Copy everything that appeared in the terminal, and paste it along your message when asking for help

Uninstalling#

If you only wanted to do a short-lived test of Radiotomate (thanks!) you can get back to a clean state by running the following commands:

systemctl --user disable radiotomate.service
systemctl --user stop radiotomate.service
rm ~/.config/containers/systemd/radiotomate*
podman image prune -a
rm -rf radiotomate_data