radiopi is a small utility to conveniently play some web radio, e.g. on a Raspberry Pi.
Really, it consists of two parts:
- the backend, which is just a glorified bash script for command line usage, as well as
- the frontend, a Progressive Web App written in good old PHP.
- To try it out or for development, run
./run.sh.
This is useful for frontend development, but a current limitation is that there's no audio from within the container.
TODO: Access audio from within container (container pulseaudio and host pipewire - this may be problematic lol) TODO: Adjust the Dockerfile for production (copy files instead of mounting volume).
- Make sure to install dependencies:
- ALSA sound system (probably already installed)
- pulseaudio
- vlc
- fzf (optionally)
- Webserver with PHP (for the frontend)
- Clone this repository
- Configure radio.sh to your needs:
- Extend $RADIO_STATION_LIST
- Adjust $VLC_GAIN
- Set (fallback) $ALSA_DEVICE
- Configure frontend:
- Set PATH_TO_RADIO_SCRIPT to correct script path of
radio.sh - Set NO_VOLUME_HOSTS if you want to disable volume controls
- Set PATH_TO_RADIO_SCRIPT to correct script path of
- Configure webserver to be able to access system audio (i.e. add webserver user to
audiogroup viasudo usermod -aG audio www-data) - If you want to use the scheduled alarm feature:
- Install a cron service and create a crontab for the webserver user (e.g.
sudo -u www-data crontab -e) - In systemd, disable the private tmp directory of the webserver (
PrivateTmp=falsein/etc/httpd/conf.d/myConfig.conf).
- Install a cron service and create a crontab for the webserver user (e.g.
- Symlink the frontend to your webserver's document root
For radio.sh command line usage, refer to the --help.
Progressive web app usage should be self-explanatory once you opened the URL with a browser.
You can find web radio stream URLs at these sites:
Philipp Moers – Personal Website
This software is provided under the MIT license.