A MPD web server and client to listen to your favorite online radio stations. It's great for a Raspberry Pi home audio system.
- Allows quick switching between your favorite radio stations
- Simple and nicely designed
- Responsive web client - ready for your phone
- Designed to be served as home screen app on iOS ("Add to homescreen")
MPD.fm has been tested on Raspbian Stretch Lite. Required are:
- Current version of Node.js
- Installed and configured MPD
- Git (optional to easily keep MPD.fm up-to-date)
Do the following as root:
# Install Node.js if not yet done
# E.g., by following Richard Stanley's script: https://github.com/audstanley/NodeJs-Raspberry-Pi
wget -O - https://raw.githubusercontent.com/audstanley/NodeJs-Raspberry-Pi/master/Install-Node.sh | bash;
# Install MPD if not yet done - configure as needed
# MPD.FM typically works with an out-of-the-box MPD
apt-get update
apt-get install mpd
# Install Git if not yet done
apt-get install git
# Create a user to have the server not as root
useradd -mrU srv-mpd-fm
# Sign into the new user
su srv-mpd-fm
cd /home/srv-mpd-fm
# Download MPD.fm using Git
git clone https://github.com/florianheinemann/MPD.FM.git
# Install dependencies
cd MPD.FM
npm install
# Back to root
exit
# Copy systemd service file
cp /home/srv-mpd-fm/MPD.FM/service/MPD.FM.service /etc/systemd/system/
# Ensure MPD.FM starts with boot and run
systemctl enable MPD.FM
systemctl start MPD.FM
# Check status
systemctl status MPD.FM
To update MPD.FM just do the following as root:
# Sign into the dedicated user
su srv-mpd-fm
cd /home/srv-mpd-fm/MPD.FM
# Update
git pull
npm install
# Back to root
exit
# Restart MPD.FM
systemctl restart MPD.FM
# Check status
systemctl status MPD.FM
- Point your browser to [IP of your server]:4200 (e.g., https://192.168.1.2:4200)
- On iOS you can display MPD.FM app-like by pressing Share / Add to Home Screen in Safari
- Several clients can use MPD.FM simultaneously
Ports, etc. can be defined by editing the environment variables in MPD.FM.service
(typically in /etc/systemd/system):
# Set to log detailed debug messages
# Environment=DEBUG=mpd.fm:*
# Details of MPD server (Default: localhost:6600)
Environment=MPD_HOST=localhost
Environment=MPD_PORT=6600
# Port to serve HTTP (the user needs special permission to serve on 80; default: 4200)
Environment=PORT=4200
# JSON file with radio stations. If empty [app root]/data/stations.json will be used
Environment=STATION_FILE=
stations.json
provides MPD.FM with all the radio stations that should be shown to the users. Each station is stored as follows:
{ "id": 1,
"station": "Berlin Community Radio",
"desc": "BCR is a broadcasting platform presenting everything that is influencing Berlin",
"logo": "https://www.berlincommunityradio.com/sites/all/themes/bcr_bootstrap/images/logospot.png",
"stream": "https://berlincommunityradio.out.airtime.pro:8000/berlincommunityradio_a"
}
- id - A unique identifier of the station (easiest is to simply number them 1, 2, 3, ...
- station - Name of the station that should be displayed
- desc - Short description of the station (optional)
- logo - URL to a logo of the station (any size)
- stream - URL to the stream of the radio station (in a format supported by MPD such as MP3, OGG, ...)