RadioKing – Online Radio Portal Script

RadioKing is a powerful PHP & MySQL script that lets you build a modern online radio portal in minutes.
Crafted with a clean Bulma CSS design and a global sticky player, it’s perfect for launching a professional radio directory, streaming platform, or music community.

Manage unlimited radio stations, import large datasets, list trending stations, and now even host podcasts with a beautiful, Spotify-inspired layout.

🚀 Core Highlights

• Unlimited radio stations with country, language & genre tagging
• Modern sticky player with HLS/M3U support & live metadata
• Clean Bulma CSS interface – mobile-first, fast & responsive
• Favorites, recently played & user profile area
• Advanced search with autosuggest (stations, countries, genres)
• SEO-friendly URLs & metadata for better visibility
• Powerful admin panel with full control over content & theme

🎧 New: Podcasts Module

• Full podcast directory with beautiful detail pages
• Import from Apple Podcasts & PodcastIndex (single & bulk)
• Episode grid with artwork, show notes & “Read more” summaries
• Native, seekable audio playback via the global player
• Podcast categories, languages & related shows section
• Favorite / unfavorite podcasts and episodes (per user)

🤖 New: Groq AI DJ Chatbot

• Built-in AI DJ chatbot powered by Groq
• Floating chat widget that matches your site theme
• Understands stations, genres & now playing metadata*
• Users can ask for station suggestions, moods, or genres
• Chat history stored in database for stats & insight*

📊 Analytics, Charts & Reporting*

• Top stations by plays, favorites & activity
• Mini bar charts & daily plays overview in admin dashboard
• Advanced “Top 50 stations by plays” responsive table
• Per-station metrics with quick filters & search

🛠 Admin Panel & Management

• Bulk station importer (CSV / API-ready) with validation
• RadioBrowser API integration with filters*
• Station & podcast management (CRUD, status, featured flags)
• Embed player generator with copy-paste HTML
• Broken stream checker / link checker*
• Report station form & moderation tools*

🎨 Theme & UX

• Spotify-inspired layout with sticky bottom player
• Theme-aware colors & gradients controlled from admin
• Mobile-optimized station grids & podcast layouts
• GDPR cookie bar with customizable text & colors*

🔐 Users & Auth*

• User registration & login system
• Forgot password flow with email reset link
• Optional Google Login / OAuth integration*
• Profile page with favorites & listening history*

Whether you’re creating a radio community, music hub, or full streaming directory with podcasts and AI assistant,
RadioKing gives you everything you need to launch a fast, scalable, and professional-looking portal.

Features (High Level)

• 🎶 Unlimited Radio Stations – Add, import, categorize and manage as many stations as you want.
• 📂 Bulk Import Stations – CSV importer + RadioBrowser API integration with filtering, deduplication & staging before publishing.
• 🎧 Podcasts Module – Full podcast directory with episodes grid, Apple Podcasts & PodcastIndex import, related shows, and native seekable playback.
• 🤖 Groq AI DJ Chatbot – Theme-aware AI assistant that suggests stations, genres, moods & interacts based on real metadata.
• 💬 AI Chat Widget – Floating mobile-friendly widget with chat history, muted text hints, typing indicator & chatbot stats panel.
• ❤️ Favorites System – Users can save their favorite stations, podcasts & episodes.
• 📱 Mobile-Optimized Design – Two-column mini cards, responsive grids, better padding & fully optimized for small devices.
• 🎨 Theme Customizer – Customize brand color, gradients, player colors, fonts & GDPR bar styling from admin (real-time preview).
• 🔍 Instant Search with Autosuggestions – Live suggestions for stations, genres, languages, podcasts & episodes.
• 🌎 Country, Language & Genre Filtering – Precise filtering for stations and podcasts.
• ⚡ HLS/M3U Compatible Player – Supports AAC/MP3/HLS streams, live metadata, podcast seekbar, and theme-aware visuals.
• 🎚️ Audio Enhancements – Bass / Mid / Treble controls, volume persistence & stream auto-retry.
• 🎛 Replace-or-Edit Fake Streams – Broken stream checker, report module & admin moderation.
• 📊 Analytics & Charts – Top 10 mini-bar charts, daily plays graph, advanced “Top 50 Stations” responsive mobile table.
• 🧭 Browse by Genres & Featured Lists – Genre landing pages, trending lists & related stations.
• 🧩 Collections Manager – Curated station lists with cover images & short descriptions.
• 🔗 Embed Player Generator – One-click HTML/JS embed codes with color customization.
• 📥 Import Deduplication – Ensures API importers do not add duplicates again.
• 📄 Auto-Generated Station Pages – Clean SEO titles, meta tags, slugs & schema markup.
• 🛠 Admin Panel with Full CRUD – Manage stations, podcasts, embed widgets, user reports, categories & featured lists.
• 📦 Installer Wizard – Step-by-step install with DB setup, admin creation & table auto-create.
• 🧹 Cleaner Utility – Find broken logos, dead streams & auto-disable offline stations.
• 🧠 Smart Enrichment – Auto-fill descriptions using metadata or external APIs.
• 🔐 User Accounts + Google Login (OAuth) – Supports email login & optional Google one-click login.
• 🔒 Secure Admin Area – CSRF tokens, session checks, and hardened routes.
• 📝 Built-in Blog Module – Categories, posts, comments & SEO-ready URLs.
• 🔧 Advanced Settings Panel – Edit site title, favicon, metadata, tracking codes & theme settings.
• 💾 CSV Export / Import – Backup or mass-edit stations & podcasts.
• 🧭 Sitemap Generator – SEO-ready XML for stations, podcasts, blog posts & pages.
• 🌐 PWA-Ready – Manifest + service worker for “Add to Home Screen”.
• 🧰 Shared-Hosting Friendly – Zero Composer dependencies, pure PHP + MySQL.

## Requirements

To run RadioKing, you’ll need the following:

- 🖥 **Web Server**: Apache / Nginx / LiteSpeed (shared, VPS, or dedicated)  
- 💾 **PHP**: Version 8.0 or higher (with PDO extension enabled)  
- 🗄 **Database**: MySQL 5.7+ or MariaDB 10+  
- 📂 **Extensions**:  
  - cURL  
  - PDO MySQL  
  - OpenSSL  
  - mbstring  
  - JSON  
- 🌐 **Modern Browser**: Chrome, Firefox, Safari, or Edge (for admin panel and user access)  

Optional (recommended):  
- HTTPS (SSL) for secure streaming and logins  
- PHP GD / Imagick (for better image/logo handling)  

📦 RadioKing Radio Portal — Installation Instructions

Requirements

• PHP 8.1 or higher
• MySQL 5.7+ / MariaDB 10.5+
• cURL, PDO, OpenSSL enabled
• Apache/Nginx with mod_rewrite
• SSL (HTTPS) recommended

🚀 Installation Steps

1. Upload all files to your hosting server.
2. Create a new MySQL/MariaDB database and user.
3. Open https://yourdomain.com/install in your browser.
4. Step 1: Enter DB details and create your Admin Email + Password.
5. The installer imports the database schema and writes config.php.
6. Make sure the following directories are writable: uploads/ and assets/img/
7. Login to https://yourdomain.com/admin with your new credentials.
8. To quick import stations — after logging in as admin:
   • Go to Manage Stations → Import CSV
   • Upload the provided stations.csv file included with the script.

🔐 Security Notes

• Set /includes/config.php to read-only (644 permissions).
• Delete or restrict the /install/ folder after installation.
• Change your admin password immediately after setup.

⬆️ Upgrading v3 → v4

• 📦 Back up DB and files
• 🗂️ Replace all files in public_html/ using FileZilla.
  Do not upload the install folder or includes/config.php.
  Then run migrate_v4.sql in phpMyAdmin (migration SQL provided).
• 🧹 Clear browser cache for updated player assets.