📻 Radio Explorer

Real-time radio station discovery stream using Go, Server-Sent Events (SSE), and Radio Browser API. Explore 30,000+ radio stations available worldwide with a beautiful live streaming UI!

✨ Features

• 📻 30,000+ Stations — Access worldwide radio stations database
• 🌍 Global Coverage — Stations from every country with flags
• ⚡ Real-time SSE — Live streaming with Server-Sent Events
• 🎨 Beautiful UI — Modern Tailwind CSS design with animations
• ▶️ Direct Play — One-click streaming to your player
• 🏷️ Rich Metadata — Genre tags, bitrate, codec, language info
• 📊 Popularity Stats — Votes and listener counts
• 🔄 API Auto-Failover — Automatic discovery & fallback between Radio Browser API servers
• 🚀 Zero Config — No API keys required

🛠️ Tech Stack

Technology	Purpose
Go 1.21+	Backend server
Chi Router	HTTP routing & middleware
SSE	Real-time streaming
Radio Browser API	Radio stations data
Tailwind CSS	UI styling

🚀 Quick Start

Clone the repository:

git clone https://github.com/smart-developer1791/go-radio-explorer
cd go-radio-explorer

Initialize dependencies and run:

go mod tidy
go run .

Open your browser:

http://localhost:8080

On startup, the app automatically discovers the best available Radio Browser API servers.

📡 API Reference

Radio Browser API

Radio Explorer uses the official Radio Browser API infrastructure, which consists of a bootstrap endpoint and multiple live regional API servers.

Endpoint	Purpose
https://all.api.radio-browser.info/json/servers	Discover available API servers
https://{region}.api.radio-browser.info/json/stations/topvote/100	Fetch top-voted radio stations

Where {region} is a live Radio Browser server such as de1, nl1, at1, etc.

The application does not use https://www.radio-browser.info for API requests. Instead, it first fetches the official server list from all.api.radio-browser.info and then performs all station queries against live regional servers.

If a server is unavailable or returns an invalid response, Radio Explorer automatically retries the request using another server.

No API key required.

Note: Station data is fetched from a single randomly selected API server per request to avoid unnecessary load on the Radio Browser infrastructure.

---

🔄 API Server Handling

On startup, Radio Explorer dynamically loads the official Radio Browser server list from the bootstrap endpoint.

For each data request:

• a random API server is selected to distribute load,
• failed or unhealthy servers are skipped,
• the request transparently falls back to another available server.

This approach improves reliability, performance, and resilience to server outages.

📁 Project Structure

go-radio-explorer/
├── main.go          # Application entry point
├── go.mod           # Go module definition
├── render.yaml      # Render deployment config
├── .gitignore       # Git ignore rules
└── README.md        # Documentation

🌐 Environment Variables

Variable	Default	Description
PORT	8080	Server port

🎯 SSE Events

Event	Description
message	Station data (JSON)
done	Stream completed
error	API or streaming error (sent as SSE event)

📦 Dependencies

github.com/go-chi/chi/v5 — Lightweight router with middleware

🖼️ Station Data

Each streamed station includes:

{
  "name": "Station Name",
  "country": "Country",
  "countrycode": "CC",
  "language": "Language",
  "tags": "rock,pop,classic",
  "homepage": "https://...",
  "url_resolved": "https://stream...",
  "favicon": "https://...",
  "bitrate": 128,
  "codec": "MP3",
  "votes": 1234,
  "clickcount": 56789
}

🙏 Credits

• Radio Browser — Free radio station API
• Chi Router — Go HTTP router
• Tailwind CSS — Utility-first CSS

---

Deploy in 10 seconds