🎵 Amethyst Music

A lightweight fork of Purple Music, self-hosted web application to stream and organize your personal music library. Built with a responsive, dark-purple interface, it runs smoothly without heavy dependencies using PHP and MY SQL.

---

📸 Screenshots

❓ The SQL script might not create the user for the db correctly

✨ Features

• 🚀 One-Click and one SQL script Install: Automated setup wizard on the first run and automated SQL script for database creation.
• 📱 Smart & Responsive UI: Modern design optimized for desktop and mobile, featuring an app-like fullscreen player.
• 🎶 Multi-Format Support: Plays and automatically calculates track length for .mp3, .wav, .flac, and .ogg files.
• 🏷️ ID3v2 Metadata Parser: Automatically extracts title, artist, and embedded artwork from your MP3 files.
• 🖼️ Image Optimization: Automatically resizes and converts covers to .webp to save bandwidth (requires PHP-GD extension).
• 🔀 Advanced Controls: Shuffle, loop (track or queue), and dynamic queue management.
• 📂 Mixes & Playlists: Create, edit, and share custom playlists among users.
• 🔒 Security & Control:
  • Session-based user/admin roles.
  • CSRF protection using secure tokens.
  • Rate-limiting on registration and file uploads.
  • Storage folders protected against arbitrary script execution via .htaccess.

---

🛠️ Prerequisites

To run Purple Music, you only need:

• A web server (Apache, Nginx, LiteSpeed, etc.)
• PHP 7.4 or higher
• The following PHP extensions enabled:
  • php-gd (Optional but highly recommended for image optimization)

---

🚀 Installation & Deployment

1. Clone the repository into your web directory:

   git clone https://github.com/enzo-quirici/Amethyst_Music
   cd Amethyst_Music
   nano setup.sql
   # change the mysql password
   mysql -u root -p < setup.sql

This project is a fork of PurpleMusic (MIT License) Original author: Axolat (https://github.com/Axolat000/PurpleMusic)