Radio Web PHP Script

🚀 Overview

Radio Web PHP Script is a self-hosted platform for running an internet radio site with live streams, Auto-DJ, show schedules, and podcast archives. It centralizes now-playing metadata, playlists, presenters/DJs, requests, and advertising in a clean, mobile-first interface—ideal for independent stations, campus/community broadcasters, churches, event promoters, and media agencies.

Real-world inspiration: The feature set reflects common broadcast workflows—SHOUTcast/ICEcast endpoints, rotating ads, time-based schedules, multi-station management, and listener analytics—so teams can launch fast and grow without SaaS lock-in.

Target users: Online radio founders, broadcasters, audio publishers, promoters, and PHP developers building branded streaming hubs.

✨ Key Features

• Live streaming integration: Connect SHOUTcast / ICEcast (MP3/AAC) with now playing titles, album art, and bitrate display.
• Auto-DJ & playlists: Schedule rotators, dayparts, jingles, and fallback streams for 24/7 playback.
• Program schedule: Weekly grid for shows, hosts, and topics with timezone-aware countdown to next show.
• Podcast & replay: Publish episodes, generate RSS/Apple Podcasts feed, and embed on-demand players.
• Song requests & dedications: Moderated queue with anti-spam and cooldown rules.
• Advertising & sponsors: Banner/HTML ad zones, pre-roll notices, sponsor carousels, and UTM tagging.
• Analytics: Concurrent listeners, session duration, top regions, device mix, and track spins with CSV export.
• Multi-station / multi-stream: Run multiple channels (Main, Talk, Hits, Worship, etc.) from one admin.
• Presenter/DJ pages: Bios, social links, upcoming shows, and past episodes.
• News & CMS: Posts, pages, categories, media library, and contact forms.
• PWA & mobile player: Installable web app, background audio, lock-screen controls.
• Localization & theming: Multi-language UI, RTL support, color themes, and custom CSS blocks.
• Security & roles: Admin/editor/DJ roles, audit logs, CAPTCHA, rate-limiting on request forms.
• Embeds & widgets: Mini player, now-playing ticker, schedule widget for partner sites.
• Developer-friendly: Clean routes/controllers, event hooks, and JSON endpoints for player apps.

⚙️ Technical Stack

• Languages: PHP 8.x+, JavaScript (ES6), HTML5, CSS3/SCSS
• Framework: Modern PHP MVC (Laravel or equivalent MVC, depending on distribution)
• Database: MySQL 8 / MariaDB
• Web server: Apache or Nginx with HTTPS (TLS)
• Extensions: OpenSSL, PDO, Mbstring, Ctype, JSON, BCMath, Fileinfo, XML, GD/Imagick
• Build tools (optional): Node.js + npm/yarn for asset builds; Redis for cache/queues; Supervisor/systemd for queue workers
• Streaming compatibility: SHOUTcast v1/v2, ICEcast 2, HLS proxy (optional)

🧩 Installation Guide

1. Server prep: Create a vhost with PHP 8.x, MySQL, and HTTPS. Point the document root to public/.
2. Upload code: Copy files to the server and set proper ownership for the web user.
3. Environment: Copy .env.example → .env; set APP_URL, DB credentials, mail (SMTP), and cache/queue drivers.
4. Dependencies: Run composer install --no-dev --optimize-autoloader then php artisan key:generate.
5. Database: php artisan migrate --seed to create tables and optional demo content.
6. Permissions: Ensure storage/ and bootstrap/cache/ are writable.
7. Configure streams: Add SHOUTcast/ICEcast mount URLs, stream keys, and now-playing metadata settings in Admin > Streaming.
8. Finalize: Build assets (npm ci && npm run build if applicable), create your first station, schedule shows, and publish your PWA manifest/icons.

📦 Deliverables

• Complete PHP project source code (Radio Web PHP Script)
• SQL migrations/seeders and sample content
• Admin dashboard, player templates, and widgets
• .env.example and basic setup documentation/README
• Optional JSON endpoints for mobile/desktop players

📱 Supported Platforms

• Web browsers: Chrome, Firefox, Safari, Edge (latest)
• Devices: Responsive UI for desktop, tablet, and mobile; PWA install support
• Server OS: Linux (Ubuntu/Debian/CentOS/Alma), macOS, or Windows Server with PHP 8+

🧠 Notes

• License: Distributed here under the GPL—you may study, modify, and redistribute per GPL terms.
• Customization tips: Override Blade/templating views in resources/views/; extend controllers/services for metadata parsing and request moderation; use resources/lang for translations; add custom players via components/.
• SEO assurance: Schema.org for episodes/shows, clean URLs, Open Graph/Twitter cards, XML sitemap, and Core Web Vitals-friendly assets help discoverability.
• Performance: Enable OPcache, HTTP/2, browser caching, image compression, and Redis for queues/caching on high-listener spikes.
• Compliance: Ensure you have rights to stream music/talk content, manage DMCA takedowns, and follow regional broadcast/licensing rules.
• Experience highlight: Built around real broadcaster needs—rotations, dayparting, presenter bios, and listener engagement tools.

👨‍💻 Original Developer Credit

Credit to the original author as listed on commercial marketplaces such as
CodeCanyon. Please consider purchasing a commercial license from the original developer if you require official updates and support.

🔒 Disclaimer

This package is provided for GPL redistribution and educational purposes. We are not the original author and do not claim brand or trademark rights. All product names, logos, and assets remain the property of their respective owners. For production use, verify your streaming/music licensing and consider purchasing the official license from the original developer for updates and technical support.