Radio Player Icecast/Shoutcast with REST API Now Playing and PWA Support

This PHP project displays information about songs playing on Icecast/Shoutcast radio streams, including history, album art, lyrics, and Progressive Web App (PWA) support. The project offers flexibility to be used with either the local API or the web API, allowing you to choose the option that best suits your needs. Additionally, it is possible to rename the index.php file to index.html to use the project exclusively with the web API.

Demo Screenshots

Features:

• Displays current song, artist, and album art.
• History of played songs.
• Cover art of the current song
• Fetches song lyrics using Vagalume API (Vagalume API)
• Responsive design for mobile devices.
• Now available as a Progressive Web App (PWA) for enhanced user experience!
• Support for multiple radio stations

Requirements

• PHP 7.0 or higher
• Web server (e.g., Apache, Nginx)
• Enabled PHP extensions: file_get_contents, json, stream_context_create
• Internet access to fetch song metadata and album covers

Installation

1. Clone the repository or download the files.

git clone https://github.com/jailsonsb2/RadioplayerAPI.git

2. Make sure you have a web server configured to serve PHP files. If you are using WAMP, place the files in the www folder.

3. Navigate to the project directory.

cd RadioplayerAPI

4. Make sure write permissions are set for the directory where the history will be saved.

5. Edit the Githubissues.

6. Githubissues is a development platform for aggregating issues.