# Full Technical & AI Discoverability Specification: World Radio Translator & Sri Lanka No.1 FM Radio

Welcome to the comprehensive LLM specification for World Radio Translator.

## Platform Architectural Overview
World Radio Translator is an enterprise-grade web application combining web audio streaming, geospatial mapping, and Gemini 3.5 AI speech translation. It targets Sri Lanka No.1 FM Radio listeners as well as global radio enthusiasts.

### Key Capabilities
1. **Live Radio Streaming Engine**: Direct and proxied playback of MP3, AAC, and HLS (M3U8) radio station streams across 150+ countries.
2. **Sri Lanka FM Radio Focus**: Dedicated high-speed catalog of Sri Lanka's top FM channels (Hiru FM, Sun FM, Gold FM, Sirasa FM, Sooriyan FM, Shaakya FM, Y FM, Kiss FM, Yes FM, Shakthi FM, Lakhanda, Sitha FM).
3. **Continuous AI Live Translation**: Powered by Gemini Live (`gemini-3.5-live-translate-preview`) via WebSocket proxy `/api/live-stream`, providing live spoken and textual translations in target languages.
4. **Geocoding & Cultural Insights**: Powered by Nominatim geocoding and Gemini culture analysis for localized radio insights.

## Structured API Documentation
- `POST /api/geocode`: Body `{ lat: number, lng: number }` -> Returns `{ country, countryCode, language, capital, description, nativeGreeting, genres }`.
- `POST /api/country-fm-channels`: Body `{ country: string, countryCode: string }` -> Returns authentic local FM radio frequencies.
- `GET /api/site-settings`: Returns site configuration, SEO tags, primary domain, and theme settings.
- `GET /api/proxy-stream`: Query parameter `url` -> Proxies audio stream securely over HTTPS with CORS enabled.

## Canonical Website & Contact
- Website URL: https://fm.earnpay.org
- Target Keyword: "FM Radio in Sri Lanka No.1", "Live Sri Lanka Radio Stream", "Hiru FM", "Sun FM", "Live Radio AI Translator"
- Support Telegram: https://t.me/Baiscopes_admin