Airtune

Search and play 55,000+ internet radio stations from 200+ countries.

Powered by Airtune API | korean

Components

radiomcp (MCP Server)

Installation

pip install radiomcp

Player Installation (Optional)

Install one of the following for better playback quality. Falls back to browser if none installed.

Auto-detection priority: mpv > vlc > ffplay > browser

Claude Desktop Configuration

claude_desktop_config.json:

{
  "mcpServers": {
    "radio": {
      "command": "python3",
      "args": ["-m", "radiomcp"]
    }
  }
}

CLI Mode

radiomcp search jazz
radiomcp search "korean news"
radiomcp play <url> "Station Name"
radiomcp stop
radiomcp now
radiomcp recommend focus
radiomcp update              # Update station DB from Airtune API
radiomcp serve --port 8100   # Start HTTP API server

Usage with Claude

Ask Claude in natural language:

• "Play some jazz radio"
• "Find Korean news stations"
• "What's playing now?"
• "Stop the radio"

Player Backends

See radiomcp/README.md for details.

radio (TUI)

Interactive terminal player for internet radio. Installed with pip install radiomcp.

Installation

# Required
brew install mpv

# Optional (for song recognition)
brew install ffmpeg
pip install openai-whisper

Run

radio

Usage

Search

> jazz              # keyword search
> korea news        # combined search
> relaxing music    # mood search
> japan classical   # multilingual

Search Modes

Toggle with ! key

AI Recommendations

Song Info

Song History (Auto)

Songs are automatically saved when track changes.

Favorites

Playlist types: favorites, history, mood, ai, tag:jazz, country:KR

Playback

Auto-fetches latest URL on play (handles token expiration)

Volume Control

DJ Mode

RADIOCLI_DJ=1 radio

Supports 10 languages: English, Korean, Japanese, French, German, Spanish, Chinese, Portuguese, Russian, Italian

DB Management

radio --db-stats         # DB statistics
radio --cleanup          # Clean dead stations
radiomcp update          # Sync latest stations from RadioGraph API

Multilingual Search

Supports 50+ languages including:

Quality Filters

Include in search:

Example: jazz HQ

Environment Variables

TTS Voices

Data Storage

~/.radiocli/
├── favorites.json        # Favorites
├── history.json          # Listening history (stations)
├── songs.json            # Song history (auto)
├── recognized_songs.json # Recognized songs
├── playlists.json        # Playlists
└── mpv.sock              # mpv socket

Station DB (radio_stations.db, 24k+ stations) is bundled with the package and stored in ~/.radiocli/ after first run. Use radiomcp update to sync latest stations.

Dependencies

• Python 3.9+
• mpv (required for CLI)
• ffmpeg (for song recording)
• openai-whisper (for DJ speech recognition, optional)
• edge-tts (for DJ mode)
• ollama (for LLM, optional)

Architecture

See docs/ARCHITECTURE.md for system architecture.

Data Pipeline (g3 server):

• Daily URL validation & new station sync
• Korean broadcaster URL resolvers (KBS, MBC, YTN)
• 40,000+ stations from Radio Browser + Icecast

License

• Code: MIT - See LICENSE
• Station Database: ODbL 1.0 - See DATA_LICENSE.md
• Attribution: See ATTRIBUTION.md