RadioMouse is a modern PHP radio portal script that lets you create a fast and stylish online radio directory with live streaming support for Icecast, Shoutcast, HLS/M3U8, AAC, and MP3. It features a sleek Bulma UI, global audio player with EQ visualizer, station pages, PWA support, and a powerful admin panel to manage stations and settings easily.

• Live radio streaming (Icecast, Shoutcast, HLS/M3U8, MP3, AAC/AAC+)
• Modern global audio player with EQ visualizer
• Station pages with logos, bitrate, genres, and now-playing
• Fast Bulma-based responsive UI
• Station import from RadioBrowser API
• Favorites system with local storage
• PWA support for installable web app
• SEO-friendly pages with clean URLs
• Lightweight, fast, and fully customizable
• Admin panel to manage stations and settings

Requirements

Before installation, make sure your environment meets the following:

Server Requirements

• PHP 8.0+ (recommended 8.1–8.3)
• MySQL 5.7+ or MariaDB 10.3+
• Apache Web Server
• HTTPS enabled (recommended)

Required PHP Extensions

• pdo_mysql
• mbstring
• json
• openssl
• curl
• fileinfo

📁 1. Upload the Files

• Download the RadioMouse ZIP package.
• Extract it on your computer.
• Upload all files (including /install) to your hosting:

• cPanel: /public_html/
• DirectAdmin: /domains/yourdomain.com/public_html/
• Localhost: htdocs/ or public/

🛠️ 2. Create a Database

• Open your hosting control panel.
• Go to MySQL Databases.
• Create:
  • A new database
  • A new database user
  • Assign the user ALL PRIVILEGES
• Save the following for the installer:
  • DB Host: usually localhost
  • DB Name
  • DB User
  • DB Password

🚀 3. Start the Installer

Once files are uploaded, visit:

https://yourdomain.com/install/install.php

You will see the RadioMouse Installer (mouse-themed UI).

🔧 Fill Out the Form

Then click:

🐭 Install RadioMouse

If everything is correct:

• ✔ Database tables created
• ✔ Admin account created
• ✔ Encryption key generated
• ✔ Branding initialized

🧹 4. Delete the /install Folder

For security, remove the entire:

/install

RadioMouse will not run until this folder is deleted.

🔐 5. Log Into Admin Panel

Admin URL:

https://yourdomain.com/admin/login.php

Use the credentials you created.

🎨 6. Initial Configuration

Inside the Admin Panel, recommended first steps:

• ✔ Set your site name & tagline
• ✔ Upload a logo & favicon
• ✔ Configure PWA (Add to Home Screen)
• ✔ Import stations from RadioBrowser
• ✔ Add/edit stations manually

📡 7. Add Radio Stations

RadioMouse supports:

• Icecast
• Shoutcast v1/v2
• M3U8 HLS
• AAC / AAC+
• MP3 streams

All URLs are encrypted and streamed through the server proxy for:

• ✔ Security
• ✔ Hiding real stream URLs
• ✔ Consistent EQ + HLS handling

To add a station:

• Go to Admin → Stations → Add
• Paste stream URL
• Save — the system auto-encrypts it

🔊 8. HLS & Real WebAudio EQ

• M3U8 streams use HLS.js (Safari uses native playback)
• All streams pass through server proxy — URLs stay hidden
• Built-in Bass/Mid/Treble Equalizer
• No configuration required