Skip to content

Latest commit

 

History

History
54 lines (36 loc) · 1.89 KB

README.md

File metadata and controls

54 lines (36 loc) · 1.89 KB

radiopi

radiopi is a small utility to conveniently play some web radio, e.g. on a Raspberry Pi. It offers a bash script for command line usage and a Progressive Web App as a frontend.

Installation

  • 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
  • Configure webserver to be able to access system audio (i.e. add webserver user to audio group via sudo 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 (e.g. in /lib/systemd/system/apache2.service or /usr/lib/systemd/system/httpd.service or /usr/lib/systemd/system/nginx.service).
  • Symlink the frontend to your webserver's document root

Usage

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.

Radio Stream URLs

You can find web radio stream URLs at these sites:

Author

Philipp Moers – @soziflip

License

This software is provided under the MIT license.