martinkirch / showergel

Showergel is made to live aside Liquidsoap: while a Liquidsoap script creates a radio stream, Showergel provides complementary features like logging or occasional scheduling, with a (minimalist) Web interface.
GNU General Public License v3.0
22 stars 3 forks source link

.. csv-table::

"⚠️ **Development is on hold, and currently rebooted on a new stack, new repository and new name. See** `this blog post <https://mkir.ch/2023-10-22/radio-automation-showergel-becomes-radioz.html>`_. ⚠️"

========= Showergel

Showergel is made to live aside Liquidsoap_: while a Liquidsoap script creates a radio stream, Showergel provides complementary features like playlist logging or occasional scheduling, with a (minimalist) Web interface. It is made to run on a Linux box (with systemd) dedicated to your radio stream.

License: GPL3_.

Take a look

If you'd like to see what it looks like, check out our demo installation <https://showergel.fly.dev>. It is only the visible part of Showergel, running on fake data. You can also use it as a stub back-end when developping that interface <https://showergel.readthedocs.io/en/latest/installing.html#install-for-front-end-development>.

Quick install

Our automated script can install Liquidsoap and Showergel on an Ubuntu or Debian machine::

wget https://raw.githubusercontent.com/martinkirch/showergel/main/installers/showergel_quickstart.sh && chmod +x showergel_quickstart.sh && ./showergel_quickstart.sh

The script will need to run sudo. It will start the radio, you should hear it as soon as you put sound files in the ~/Music folder. It will also register the radio as a system service, so the radio and its interface will start when the machine reboots, too.

This script installs our "quickstart" LiquidSoap script. After a first try we advise you to have a closer look to Showergel's documentation on https://showergel.readthedocs.io/.

.. _Liquidsoap: https://www.liquidsoap.info/ .. _GPL3: https://www.gnu.org/licenses/gpl-3.0.html