# RadioKing – Online Radio Portal Script

**RadioKing** is a powerful PHP script that lets you build your own online radio portal in minutes.  
Packed with modern features and a clean **Bulma CSS** design, it’s the perfect solution for anyone who wants to launch a professional radio directory or streaming platform.

With RadioKing, you can add **unlimited stations**, manage them with ease, and even import large station datasets instantly using the **bulk importer**.

## 🚀 Key Features

- Unlimited radio stations support  
- Bulk station importer (CSV / API ready)  
- Sticky player with live streaming  
- Country & genre categorization  
- Live search with autosuggestions  
- Favorites & user interaction system  
- Mobile-friendly responsive design (Bulma CSS)  
- Advanced admin panel with settings & link checker  
- SEO-friendly structure for better visibility  

Whether you’re creating a **radio community, music hub, or streaming directory**,  
RadioKing gives you all the tools to set up a fast, scalable, and professional-looking portal.

Features (High Level)

• 🎶 Unlimited Radio Stations – Add, import, and manage as many stations as you like.
• 📂 Bulk Import Stations – CSV importer + RadioBrowser integration for mass onboarding.
• ❤️ Favorites System – Users can log in and save their favorite stations for quick access.
• 🌎 Country, Language & Genre Filtering – Explore stations with precise filtering options.
• 🔐 Secure Admin Panel – Protected by login, CSRF tokens, and session-based authentication.
• 📱 Responsive Design – Works flawlessly on mobile, tablet, and desktop.
• 🎨 Theme Customizer – Live preview and customization of fonts, colors, and layout styles in real-time.
• 🗺️ Sitemap Generator – Automatically generates SEO-ready XML sitemaps for all stations, blog posts, and pages.
• 📦 Installer Wizard – Set up your database and admin credentials effortlessly.
• 🧹 Cleaner Utility – Automatically detect and disable broken streams or missing logos.
• 🧠 Smart Enrichment – Auto-generate descriptions using Wikipedia or metadata APIs.
• 🎛 Stage-Then-Import Workflow – Review imported stations before publishing live.
• 🪄 SEO-Optimized Pages – Sitemap, meta tags, and structured data ready out of the box.
• 📰 Built-in Blog System – Manage posts, categories, and comments.
• 💬 Contact & Reports Module – Receive listener feedback or stream issue reports.
• ⚙️ Settings Management – Modify site title, tagline, favicon, meta info, etc. directly from admin.
• 💾 Auto-Create Tables – Runs even on blank databases (self-healing settings table).
• 🌐 PWA-Ready – Includes manifest + service worker for installable app experience.
• 🎧 Sticky Footer Audio Player – Responsive, HLS-compatible player with now-playing metadata.
• 🔍 Search with Autocomplete – Fast suggestions powered by AJAX APIs.
• 🧩 Collections & Categories – Curate themed station lists.
• 📈 Analytics & Play Counting – Track plays via /api/track_play.php.
• 🧾 CSV Export / Import – For backups and bulk editing.
• 🧰 Shared-Hosting Friendly – Minimal dependencies, no Composer required.

## 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 v2 → v3

• 📦 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 migratev3.sql in phpMyAdmin (migration SQL provided).
• 🧹 Clear browser cache for updated player assets.