GrooveFM 🎵

GrooveFM is a simple online radio station created with Node.js and the Express web framework. Tune in to enjoy seamless music playback, synchronized across all connected clients.

Table of Contents

• Features
• Technology Stack
• Setup
• License

Features

• 🎧 Seamless Playback: The audio playback is designed to be smooth and continuous.
• ⏲️ Synchronized Timestamp: All clients hear the same audio part at any given time.
• 🔄 Auto-replay: The stream automatically starts over after reaching the end.
• 💾 Persistent State: The server retains its state across restarts.

Technology Stack

• Node.js
• Express
• HTML5
• Vanilla JS

Setup

Follow these steps to get GrooveFM up and running on your local machine:

1. Clone the Repository

   git clone https://github.com/DarkTwentyFive/GrooveFM.git

2. Navigate to the Directory

   cd GrooveFM

3. Install Dependencies

   npm install

4. Initialize Timestamp File

   If you want to initialize the timestamp, create a file named timestamp.txt in the root directory with the initial value (0 for instance).

   echo "0" > timestamp.txt

5. Upload Audio: Upload your audio file to the root directory of the project and name it music.mp3.

6. Set Audio Duration: Open index.js and locate the following line:

   const audioDuration = 0; // audio file duration

   Replace 0 with the actual duration of your audio file in seconds.

7. Run the Server

   npm run start

8. Open your browser and navigate to http://localhost:3000 to start listening!

License

GrooveFM is open-source and is under the MIT License. See the LICENSE for more information.

---

Happy Listening with GrooveFM 🎶