MP3 Fusion - Music Search & Discovery Engine PHP Script

Version: 1.0
Author: Developer SB

Overview

MP3 Fusion is a powerful, lightweight, and easy-to-manage PHP script that allows you to create your own music search and discovery website. Built with performance and simplicity in mind, it operates without a database, making it incredibly easy to deploy on any standard PHP hosting.
The script uses the YouTube API to provide users with access to a massive library of music, which they can stream instantly and get links to download. With a secure, password-protected admin panel, you have complete control over your site's appearance, features, and content.
This script is the perfect solution for anyone looking to create a music-related website, a niche audio portal, or a music blog with search functionality.
Live Demo: [Link to Your Live Demo Website]

Core Features

Frontend (User-Facing):

• Powerful Music Search: Utilizes the YouTube Data API v3 for real-time search results.
• Featured Songs List: Showcase trending or curated tracks on the homepage.
• Instant Audio Streaming: Users can preview any song in a clean pop-up player.
• MP3 Download Links: Provides redirection links for users to download tracks.
• Fully Responsive: Looks and works perfectly on desktops, tablets, and mobile devices.
• Pagination System: "Next" and "Prev" buttons for easy navigation of long song lists.
• Static Pages: Includes templates for About, Contact, DMCA, and Instructions pages.

Backend (Admin Panel):

• No Database Required: Runs on a simple, file-based system (JSON) for ultimate portability.
• Secure Admin Area: Password-protected panel, completely separate from the frontend.
• Full Site Customization: Change site title, logo, meta tags, and more.
• Ad Management: Enable/disable ads and paste your ad code (e.g., AdSense) into dedicated slots.
• Featured Songs Management: Easily add or remove songs from the homepage list.
• API & Cache Control: Manage your API keys and clear the site cache with a single click.
• SEO Tools: Includes an automatic XML sitemap generator.

Server Requirements

Please ensure your hosting environment meets the following requirements:

• PHP Version: 7.2 or newer (7.4+ recommended)
• PHP Extensions: cURL and JSON (These are standard and enabled on 99% of hosts)
• Web Server: Apache, Nginx, or any server that can run PHP.
• Write Permissions: The server must be able to write to the /data/ and /cache/ directories.

Installation Guide (5-Minute Setup)

Follow these simple steps to get your website live.
Step 1: Upload Files

• Unzip the main file you downloaded.
• Inside the source/ or dist/ folder, you will find the application files.
• Upload all of these files and directories (admin, cache, data, templates, etc.) to your hosting account's public directory (e.g., public_html or www).

Step 2: Set Directory Permissions (CRITICAL STEP)

• Your website needs to be able to save your settings and cache API results. You must set the correct permissions for two folders.
• Using your hosting control panel's File Manager or an FTP client (like FileZilla), navigate to the uploaded files.
• Right-click on the /data/ directory, choose "File Permissions" (or "Attributes"), and set the numeric value to 775.
• Repeat the exact same process for the /cache/ directory.
• Note: If 775 does not work due to your host's configuration, use 777 as an alternative.

Step 3: Configure Your Website

• Navigate to the admin login page in your browser: <a href="http://yourwebsite.com/admin/login.php">http://yourwebsite.com/admin/l...</a>
• Log in with the default password: admin
• In the admin panel, go to the "API Keys, Ads & Caching" section.
• Paste your YouTube Data API v3 Key into the appropriate field. The site will not work without this.
• Customize the rest of the settings (Site Title, Logo, etc.) to your liking.
• Click the "Save All Settings" button.

Congratulations! Your website is now live and fully functional.

Admin Panel Guide

• Login: Access yourwebsite.com/admin/login.php. The default password is admin. It is highly recommended to change this in the config.php file.
• Adding Featured Songs: Go to the "Featured Songs Management" section, enter an artist and title, and click "Add Song."
• Clearing Cache: If you feel search results are outdated, go to the "Tools" section and click "Clear Cache."
• Sitemap: The sitemap is generated automatically. To refresh it after adding many songs, click "Regenerate Sitemap."

Support

For any questions, issues, or feature requests, please contact us at: [email protected] . We are happy to help!

About MP3 Fusion

MP3 Fusion is a sleek and powerful music discovery platform that allows you to create your own music search engine website. Built for speed and simplicity, it operates without a database, making it incredibly easy to set up and manage. It's the perfect solution for anyone passionate about sharing music with the world.

Key Features

• Powerful Music Search: Instantly find any song or artist.
• Featured Homepage: Showcase trending or curated tracks.
• Instant Audio Streaming: Preview songs directly on the site.
• MP3 Download Links: Provide users with links to download music.
• No Database Required: Simple, file-based system for easy setup.
• Full Admin Control: Manage all settings, songs, and ads from a secure panel.
• SEO Ready: Includes an automatic sitemap generator for better search engine ranking.
• Fully Responsive: Works perfectly on desktop, tablet, and mobile devices.

MP3 Fusion: Application Requirements

This document outlines the necessary server environment and external services required to successfully install and operate the MP3 Fusion PHP web application.

1. Server Requirements

These are the technical requirements for the web hosting environment. Most standard web hosting plans (including shared hosting) will meet these needs.

• Web Server Software:
  • Apache, Nginx, or any other standard web server that can execute PHP scripts.
• PHP Version:
  • PHP 7.2 or newer is required. PHP 7.4+ is recommended for optimal performance and security.
• PHP Extensions:
  • cURL: This extension is mandatory as it is used to make API calls to the YouTube service. It is enabled by default on almost all hosting providers.
  • JSON: This extension is mandatory for reading and writing the .json files in the /data/ directory. It is a core part of PHP and is always enabled.
• File System Permissions:
  • T
  • /data/ (to save settings and the featured songs list)
  • /cache/ (to save cached API responses)
• Permissions should be set to 775 or, if necessary, 777. This is the most common point of failure during installation.

2. External Service Requirements

The application relies on an external API for its core functionality.

• YouTube Data API v3 Key:
  • A valid API key from the Google Cloud Console is absolutely required.

3. End-User Requirements (Browser)

These are the requirements for visitors who will be using the website.

• A Modern Web Browser:
  • Any up-to-date browser such as Google Chrome, Mozilla Firefox, Apple Safari, or Microsoft Edge.
• JavaScript Enabled:
  • JavaScript must be enabled in the browser for the site's interactive features (like the music player, search functionality, and modals) to work. This is the default setting on all modern browsers.

MP3 Fusion: Installation Guide

Welcome to MP3 Fusion! This guide will walk you through the simple, 5-minute setup process to get your music website live.

Step 1: Upload the Script Files

First, you need to place the application files onto your web hosting server.

1. Unzip the main .zip file you downloaded.
2. Inside, you will find a folder containing the application files (such as index.php, config.php, and the admin, data, and cache directories).
3. Using your hosting control panel's File Manager or an FTP client (like FileZilla), upload all of these files and directories to the root public folder of your domain (this is usually named public_html or www).

Step 2: Set Directory Permissions (Critical Step)

This is the most important step. The script needs permission to write to certain folders to save your settings and cache data. If you skip this, your site will not work.

1. In your File Manager or FTP client, locate the /data/ and /cache/ directories that you just uploaded.
2. Right-click on the /data/ directory and find the "Permissions" or "Attributes" option.
3. Set the numeric value for the permissions to 775.
4. Now, right-click on the /cache/ directory and do the same: set its permissions to 775.

Troubleshooting Tip: If 775 permissions do not work on your specific hosting setup, you can use 777 as an alternative.

Step 3: Configure Your Website

Now it's time to log in to the admin panel and complete the configuration.

1. Open your web browser and navigate to the admin login page by typing: http://yourwebsite.com/admin/l...
2. Log in using the default password:
   • Password: admin
3. Once you are logged in, you will see the admin dashboard. The most important setting is the API key.
   • Go to the "API Keys, Ads & Caching" section.
   • Paste your YouTube Data API v3 Key into the correct field. The search functionality will not work without this key.
4. Feel free to customize your Site Title, Logo, and other settings.
5. When you are finished, scroll to the bottom and click the large "Save All Settings" button.

Congratulations! Your MP3 Fusion website is now installed and live.