Raspberry Pi Internet Radio 
---------------------------
Author : Bob Rathbone
Site   : http://www.bobrathbone.com
Email  : bob@bobrathbone.com


This program uses  Music Player Daemon 'mpd', its client 'mpc' and the python3-mpd library
See http://www.musicpd.org/
Use "apt-get install mpd mpc python3-mpd" to install the libraries
This software uses the python3-mpd library. See https://packages.debian.org/sid/python3-mpd

Version 7.3 release notes 
-------------------------
14th November 2021

THIS VERSION ONLY RUNS ON ON RASPBERRY PI BUSTER OS AND NOT THE NEW BULLSEYE VERSION.
THIS MEANS THAT YOU CANNOT USE RASPBERRY PI IMAGER SOFTWARE TO CREATE YOUR SDCARD.
YOU HAVE TO USE WIN32 DISK IMAGER (Win32DiskImager.exe) TO CREATE THE SD CARD.
FULL DETAILS HOW TO DO THIS ARE SHOWN IN THE VERSION 7.3 CONSTRUCTORS GUIDE.
VERSION 7.4 TO SUPPORT BULLSEYE IS UNDER DEVELOPMENT (RELEASE AS YET DATE UNKNOWN). 

1) Add LUMA support for SSD1306, SSD1309, SSD1325, SSD1331, SH1106 and WS0010 OLEDs
2) Support added for creating a bootable USB 3.0 Hard Disk Drive
3) Add creation of playlist from Music directory on a USB Disk Drive.
4) Implement flipping screen vertically fo ST7789 OLED class (Pirate Audio)
5) Display equalizer.cmd configuration file in display_config.sh script
6) The equalizer.cmd file moved to /var/lib/radiod
7) Shutdown button added to gradio and vgradio (See display_shutdown_button in radiod.conf)
8) Force language translation off (override translate_lcd setting) for OLEDs
	- unless romanize=yes
9) Correct Adafruit Speaker Bonnet installation failure (Do not install pulseaudio)
10) Correct Mixer controls USB command in display_config.sh. Added display MPD playlists
11) If icecast2 installed it now uses systemd to start/stop it instead of System V initd
12) Icecast streaming can now be enabled and disabled in the full feature graphical version
13) Identify playlist type by contents rather than file name 
	(No need for '_' at beginning of file name). Existing playlists renamed during installation
14) Update playlist if changed by an external client such as OMP!D
15) Added driver for Grove JHD1313 RGB 2x16 LCD
16) New playlists_class.py added to allow update of MPD playlists from external MPD clients
17) Added update_stationlist.py script to re-create stationlist file from MPD playlists 
18) New /etc/crontab.daily/radiod script added to run update_stationlist.py and 
    create_stations.py daily if update_playlists=yes found in /etc/radiod.conf
19) New rotary_class_rgb.py added to support RGB Rotary encoders
20) New rotary_class_rgb_i2c.py added to support I2C RGB Rotary encoders
21) New utility rgb_set_i2c_address.py added for I2C RGB Rotary encoders
22) Button class and all rotary encoder classes now run in a thread
23) Shutdown command shutdown_parameter added (Default "sudo shutdown -h now")
24) Configuration display programs now display parameters as Yes/No instead of True/False
25) Added Raspberry Pi Zero 2 W with 1GHz 64-bit Arm Cortex-A53 quad core CPU

Version 7.2 release notes 
-------------------------
26th July 2021
1) Add Compute Model and 8GB 4B to display_model.py
2) Correct report of X-Windows detected if Lite OS installed
3) Correct remote control configuration display error
4) Correct DAC overlay not being configured in /boot/config.txt if called from configure_radio.sh
5) Alternative rotary class, remove sudo requirement and edge detection set to BOTH
6) Comitup WiFi roaming dropped due to problems
7) New parameter rotary_gpio_pullup=up/off to disable internal pullups for KY-040 rotary encoders
8) Correct crash in the test routine of event_class.py
9) Support for Sitronix SSD1306 128x64 monochrome tft with I2C interface 
10) Virtual rewrite of configuration class to give consistant labels
11) New display_wifi.sh script to display details of current Wi-Fi connection
12) Added network information to display_config.sh and display_wifi.sh
13) Button and Rotary encoder interfaces now run in their own thread
14) Correct not playing MEDIA on start-up if no IP network available
15) Don't add comment to /boot/cmdline.txt as it is causing boot failure
16) Configure I2C using configuration script instead of raspi-config (takes two attempts)
17) Correct Spotify/Airplay not unmuting correctly (Only volume change would unmute)  
18) Improve Graphic screens scrolling in particular RSS display
19) Integrity check of /boot/config.txt added. Make sure it isn't null
20) Support for Waveshare 2.8 and 3.5-inch TFTs added

Version 7.1 release notes 
-------------------------
2nd April 2021
1) Use MPD socket listener (mpd.socket) to handle client requests
2) Correction to UDP client/server for Remote control software
3) remote_control.py amended to send valid KEYs to the radio daemon
4) Correction to select source in web interface
5) Correction to shoutcast playlist selection in web interface
6) Added internet_timeout setting for Internet check in /etc/radiod.conf
7) set_mixer_id.sh uses audio_out setting in radiod.conf to select correct audio card
8) Correct crash in full feature graphic radio when selecting playlists
9) Store volume in /var/lib/radiod/volume if changed by an external client
10) Set locale to LC_ALL=C in scripting relying upon English messages
11) New parameter audio_config_locked add to prevent dynamic update of audio configuration
12) New parameter --input_file=<station.urls> in create_stations.py program
13) get_shoutcast.py converted to Python 3
14) Correction to select source "Internal Server Error" in web interface

Version 7.0 release notes  (Compared to version 6.15)
-------------------------
28th January 2021
1) Major release - All Python code converted to Python 3
2) MPD interface now uses python3-mpd instead of python-mpd
3) Improved audio device section including PCM5102A devices
4) Improve reconnection to stream after Internet connection restored
5) Prevent duplicate log messages
6) Add wiring scheme display to display configuration script (display_config.sh)
7) Internet check added (Prevent skipping if Internet connection lost)
8) Improved error messages (Bad stations, time outs etc.)

Manuals
-------
Version 7.x
https://bobrathbone.com/raspberrypi/documents/Raspberry%20PI%20Radio.pdf

Vintage radio
https://bobrathbone.com/raspberrypi/documents/Raspberry%20PI%20Vintage%20Radio.pdf
https://bobrathbone.com/raspberrypi/documents/Raspberry%20PI%20Vintage%20Radio%20Operating%20Instructions.pdf

Version 6.x (For PiFace CAD support only)
https://bobrathbone.com/raspberrypi/documents/Raspberry%20PI%20Radio%206.x.pdf


GitHub
------
Source available from GitHub
Version 7.x see:  https://github.com/bobrathbone/piradio6
Run ./setup.sh from the command line to create the radiod package

Licenses
--------
The licences for the source and documentation for this project are:
GNU General Public License. 		http://www.gnu.org/licenses/gpl.html
GNU AFFERO General Public License.	http://www.gnu.org/licenses/agpl.html
GNU Free Documentation License. 	http://www.gnu.org/licenses/fdl.html

Disclaimer 
----------
Software is provided as is and absolutly no warranties are implied or given.
The authors shall not be liable for any loss or damage however caused.