openFM

openFM is a modern web application that allows users to stream radio stations via the laut.fm API. The application displays current track information, station details, and a history of recently played tracks. The design is responsive and utilizes modern web technologies for an optimal user experience.

---

Features

• Live streaming of radio stations via the laut.fm API
• Display of current track information (artist, title, album cover)
• Station details (name, slogan, description, location, social media links)
• Broadcast schedule (current and next show)
• History of recently played tracks
• Responsive design for all devices
• Dynamic background images based on the current album cover

---

Technologies

• Frontend: HTML5, CSS3, JavaScript (ES6+)
• Framework: Bootstrap 5
• APIs: laut.fm API, iTunes API
• Design: Modern, customizable UI with dynamic colors

---

Installation

Prerequisites

• A modern web browser (Chrome, Firefox, Edge, Safari)
• Internet connection (for API requests and streaming)

Steps

Clone the repository:

  git clone https://github.com/ykilian/openFM.git
  cd openFM

Then open the index.html file in your preferred web browser.

---

Configuration

Station selection

Change the STATION variable in the <script> tag of index.html to stream a different station:

const STATION = 'mangoradio'; // Replace 'mangoradio' with the desired station name

---

Usage

1. Open the application in your web browser.
2. Click the Play button to start the stream.
3. The application will automatically display the current track information, album cover, and station details.
4. Use the links below the station logo to visit the station on other platforms.

---

API Reference

laut.fm API

• Station Information: https://api.laut.fm/station/{STATION}
• Current Track: https://api.laut.fm/station/{STATION}/current_song
• History: https://api.laut.fm/station/{STATION}/last_songs

iTunes API

• Album Cover: https://itunes.apple.com/search?term={ARTIST}+{TITLE}&entity=musicTrack&limit=1

---

LICENSE

This project is licensed under the MIT License.