This is a personal project, built for the joy of building it. I wanted one calm, beautiful place to hear what the rest of the world is listening to right now, without ads, accounts or tracking. It is open source so anyone can run it, learn from it or make it better. Contributions are very welcome.
- Tune the world. Turn a radio dial across cities and hear a live station from that country instantly.
- Ask for what you want. Type "calm jazz from Japan" or "Bengali music from Bangladesh" and get real stations. Works on keywords alone; AI is optional.
- Browse by place, language, mood or genre, with over 45,000 stations from the Radio Browser directory.
- Surprise me. One button, somewhere unexpected.
- The interface follows the music. A jazz station makes the app calm and amber; a dance station turns it electric. Colors always keep accessible contrast.
- Now playing song titles when a station broadcasts them, plus lock screen and media key control.
- Favorites and history stored on your device. No account, no tracking.
- Installable as an app, and it keeps working offline for browsing what you already visited.
git clone https://github.com/raj-khan/openradio.git
cd openradio
npm install
npm run devOpen http://localhost:3000. No API keys or database needed: station data comes from the public Radio Browser API.
Copy .env.example to .env.local and fill in what you need:
| Variable | What it does |
|---|---|
NEXT_PUBLIC_APP_URL |
Public origin used for metadata, sitemap and robots |
RADIO_BROWSER_BASE_URL |
Pin a specific Radio Browser mirror |
AI_GATEWAY_API_KEY |
Enables AI understanding on /discover (keyword parsing works without it) |
AI_MODEL |
Model for discovery, as provider/model |
| Command | What it runs |
|---|---|
npm run dev |
Development server |
npm run build / npm start |
Production build and server |
npm run lint / npm run typecheck |
ESLint and TypeScript |
npm test |
Unit tests (Vitest) |
npm run test:e2e |
End to end tests (Playwright, mocked station API) |
npm run format |
Prettier |
Next.js 16 (App Router) and React 19 in TypeScript, Tailwind CSS v4, Zustand for player state, hls.js for HLS streams, Zod for validation, Vitest and Playwright for tests. No database: favorites and history live in your browser.
Station data flows through a StationProvider interface, so Radio Browser can be swapped or joined by other directories later. Audio is never proxied, recorded or rebroadcast: your browser connects straight to each station.
See docs/architecture.md for the full picture and docs/design.md for the visual direction.
Station data from Radio Browser. Photography from Unsplash under the Unsplash License, credited on the about page. OpenRadio does not host or rebroadcast audio; streams, names and logos belong to their stations.
Released under the MIT License.