PHP Music

Galleries

• 🎵 Scan & Play: Recursively scans your directory for mp3, m4a, flac, ogg, and wav files.
• 🔒 User Accounts & Long Sessions: Secure registration, profile management, and sessions that last for up to an entire year.
• 📱 Progressive Web App (PWA): Dynamic Service Worker caches assets and media streams for rapid loading and true offline performance.
• ✏️ Metadata Editor & Lyrics: Edit ID3 tags (Title, Artist, Album, Genre, Lyrics) and view synchronized LRC lyrics in real-time.
• 📝 Blogging & Markdown Platform: Create, auto-save, and publish blogs with Markdown, Find & Replace, multi-format exports (PDF, HTML, MD, TXT, ZIP), and threaded comments.
• 🔒 Personal Privacy Controls: Set playlists, uploaded songs, or blogs to "Personal Private" mode, keeping them hidden and unplayable/unreadable for all other users.
• 🎨 Integrated Image Editor (ImagEditor): Design graphic covers or modify images with custom layers, filters, shapes, text, scale transformations, and PNG exports directly in-app.
• 🎧 PHPAudio – Audio Editor: Trim, amplify, edit metadata, and save audio files directly to your library with waveform preview and rollback support.
• 🕹️ Embedded Rhythm Game: Play auto-analyzed beatmaps of your personal library with customizable keybinds, adjustable tick speeds (up to 20x), pause menus, and player-based global ranks.
• 💻 Integrated PHPEditor (IDE): Desktop-optimized browser code editor for server files with Ace Editor, syntax highlighting, multi-tab support, file history rollback, and a terminal console.
• 🖼️ PHPShares – Artwork & Manga Gallery: Upload and share illustrations and manga with tags, series, characters, parodies, NSFW toggle, favorites, threaded comments, and a dedicated manga reader with page navigation.
• 🔗 Social Ecosystem: Follow artists, invite collaborators, copy playlists, and share direct deep-links instantly.

1. Clone the repository:

   git clone https://github.com/HirotakaDango/PHP-Music.git
   cd PHP-Music

2. Dependencies: Ensure PHP 7.4+ is installed. Download the latest getID3 library and extract it into a getid3/ folder inside the project root folder.
3. Enable SQLite in PHP: PHP Music runs entirely on SQLite. If you are using XAMPP/LAMPP, you may need to enable it manually.
   • XAMPP (Windows/macOS): Open xampp/php/php.ini and remove the semicolon (;) before extension=pdo_sqlite and extension=sqlite3. Restart Apache.
   • LAMPP (Linux): Open `/opt/lampp/etc/php.ini`, uncomment the same extensions, and run `sudo /opt/lampp/lampp restart`.
4. Permissions: PHP must have write permissions to the project directory to create music.db and the uploads/ folder.

   chmod -R 777 . # Adjust permissions as per your server's security standards

5. Run the app:

   php -S localhost:8080

   Open http://localhost:8080 in your browser. Register an account, log into the admin panel (?access=admin, password: admin) to verify yourself, and hit "Scan All" to build your library.

• Accounts & Extended Sessions: Registering an account lets you track listening history, save favorites, create playlists, write blogs, and post comments. Sessions securely persist for up to 1 year so you remain logged in across devices. To upload music, an admin must verify your account (verified status = "yes").
• Dynamic Navigation Sidebar: Access directories for "Listen Later", "Community", "Personal Notes", and "My Blogs" situated directly below the "Following" tab.
• Blogging Platform & Markdown Editor: Access "My Blogs" from the sidebar to compose and publish articles. Supports full Markdown formatting (headings, lists, code blocks, tables, and media embeds) with a live split-preview mode and real-time word/character counting. Features an integrated "Find & Replace" tool, auto-saving drafts, category classification, and status toggles ("Public / Published" vs "Private / Draft").
• Blog Engagement & Comments: Public blogs feature like/dislike reactions and a full threaded comment section with nested replies, comment reactions, `@username` mentions, and edit/delete permissions for comment owners. Non-logged-in guests can read blogs and view comment threads, while comment posting and reaction controls are reserved for logged-in accounts.
• Blog Search & Sorting: Search through your blogs using the debounced search bar with empty-match feedback, and sort lists by "Newest", "Oldest", or "Recently Modified".
• Multi-Select & Bulk Actions for Blogs: Long-press or right-click blog cards to enter multi-select mode (highlighted with red borders). Bulk delete or download selected blogs as a `.zip` archive. Switching views automatically cancels multi-select mode.
• Exporting & File Import for Blogs: Export individual blogs to PDF, HTML, Markdown, or Plain Text. Batch import `.txt` files as new drafts or backup/restore entire blog collections via JSON.
• Rhythm Game Engine Guide: Access the "Rhythm Game" tab from the sidebar.
  • How to Play: The game parses tracks directly from your database. Tap "PLAY" on any song card to trigger the launch setup modal. Under settings, you can define keyboard lane mapping bindings (default: `D`, `F`, `J`, `K`), calibrate audio latency offset values, and tweak the Note Speed multiplier (supporting up to `20x` speed).
  • Ranks & Scores: The "Ranks" tab displays player-focused standing metrics sorted by total scores accumulated across all completed song sessions. In addition, when launching any specific track, its individual high-score board is dynamically rendered inside the Play modal—awarding glowing "FC" badges to perfect runs (0 misses/bads).
  • Pause & Abort System: Tap "Pause" at any point during a run to freeze the timeline. The overlay lets you immediately "Resume", trigger an instant "Retry", or "Quit to Menu" safely.
• Image Editor (ImagEditor) Workspace Guide: Click "Image Editor" in the sidebar to load the canvas playground.
  • Layer Manipulation: Click "Image" to import PNG or JPG files, "Text" to append editable text layers, or "Shape" to render vector shapes. Drag layers to position them, or use the active transform handles to scale, stretch, and rotate layers on a responsive plane.
  • Property Adjustments: Tap "Settings" (or select a layer) to pull up the Properties Panel. Here, you can change positions, alter opacity levels, adjust rounded corner-radius values, and fine-tune image properties (brightness, contrast, grayscale filters).
  • Brush & Drawing Tools: The "Draw" panel offers multiple brush engines (dip pen, felt tip, airbrush, calligraphy, neon, spray, eraser) with adjustable size, opacity, and glow intensity. Symmetry modes (vertical, horizontal, quad) help create mirrored illustrations.
  • Actions & Exports: Reorder layers (bring forward/send back), toggle flip orientations, duplicate, or delete layers. When ready, click "Export" to save your composite creation to your local drive as a high-resolution `.png`, `.jpg`, `.webp`, `.svg`, or save the project as a JSON file for later editing.
  • Projects & Templates: Save your projects in the cloud and access them later. The "Design Presets" drawer provides 25+ ready‑to‑use templates (promo banners, quote cards, cyber posters, vintage, minimal, etc.) to jumpstart your creative process.
• PHPAudio – Audio Editing Tool:
  • Access: Click "PHPAudio" from the sidebar to open the audio editor workspace.
  • Open Audio: Drag and drop or click to browse an audio file (MP3, FLAC, WAV, M4A, OGG, and more). The editor will display a waveform and extract all ID3 metadata.
  • Trim & Amplify: Use the sliders to set a start and end point for trimming, and adjust the gain (amplify) to boost or reduce volume.
  • Playback Controls: Preview your edits with play/pause, volume control, and playback speed adjustment.
  • Edit Metadata: Update title, artist, album, and cover art. The cover can be cropped with a 1:1 aspect ratio.
  • Save to Library: Save the edited audio directly to your music library. If you opened a song already in the library, you can save over it or create a new entry. The system updates the database and writes the new ID3 tags into the file.
  • Rollback: If you save changes to an existing song, a version history is kept, allowing you to restore the previous version at any time.
• PHPShares – Artwork & Manga Gallery:
  • Access: The "PHPShares" submenu in the sidebar lets you explore all artworks, illustrations, and manga/comics uploaded by the community.
  • Browsing: Filter by "All", "Illustrations", "Manga", or "My Favorites". Sort by newest, oldest, most viewed, or most favorited. Use the search bar to find specific works by title, tags, characters, or series.
  • Upload Artwork: Click "Upload Artwork" in the PHPShares submenu. You can upload multiple images at once (for manga pages), add a title, tags, description, and optionally assign it to a "Series". Mark it as "NSFW" (18+) if necessary.
  • Manga Reader: When viewing a manga/comic, a dedicated reader mode allows you to flip through pages with keyboard arrows (←/→) or by clicking the left/right side of the screen. You can also jump to any page or episode using the episode selector modal.
  • Series Management: Group related artworks into series. Each series shows its own page with aggregated metadata (tags, characters, parodies, groups) and a list of all episodes. You can navigate directly from the series page to any episode.
  • Favorites & Comments: Like your favorite artworks and leave comments. Comments support markdown, @mentions, and threaded replies.
  • Metadata Index: Explore the gallery by tags, characters, parodies, groups, or series via the dedicated index pages accessible from the PHPShares submenu.
• Listen Later (Bookmark): From any song's 3-dot context menu, select "Listen Later" to save it to your bookmarks. Bookmark icons dynamically alternate states. Drag and drop tracks inside your "Listen Later" tab to manually reorder your queue.
• Song Community & Comments CRUD: Open "View Comments & Likes" from any song context menu to engage in track discussions. This panel allows you to like/dislike the track, post nested comments, reply, react to other comments, or edit/delete your own submissions. Adding @username inline will automatically format and highlight the tag for visibility.
• Community Social Feed: Share posts with other users in the Community space. You can post, edit, delete, and react (like/dislike) to updates. Sort feed content by "Newest", "Most Liked", or exclusively from "Following Users".
• Personal Notes: Use the "Personal Notes" tab to manage draft ideas or lyric logs privately. These are sandboxed strictly to your profile and can be sorted by "Newest", "Oldest", or "Recently Modified".
• Direct Messaging & User Search: Access your Inbox to send real-time text and image messages to other users. Search for artists directly within the inbox. See when users were last active and check message read/unread status.
• User Blocking: From any user's profile, click the Block icon to instantly prevent them from messaging or following you, automatically severing any mutual follows.
• Calendar & Time: Use the Calendar option in the sidebar to open a real-time clock and interactive date-picker, ideal for quick date referencing during music curation.
• Offline Music Mode: Save songs, cover art, and metadata into browser Cache Storage via "Make Available Offline" in context menus. If files are not fully cached, they dim and cannot be played. Use "Re-download Cache" to re-cache if needed. If a song is fully offline, use "Save File to Device" to download it physically from browser storage without using network data. Drag-and-drop to manually reorder offline songs, with dedicated JSON import/export options.
• Audio Customization: Sculpt your sound directly from the Settings panel. Toggle "Volume Normalization" (Automatic Gain Control) to keep volume levels balanced, or enable the "5-band Equalizer" to adjust frequency gains (60Hz, 230Hz, 910Hz, 3.6kHz, 14kHz).
• Dynamic Queueing: Click "Play Next" or "Add to Queue" on any track context menu. Scroll down the "Up Next" tab in the player modals (mobile or desktop) to load the queue dynamically with infinite scrolling.
• Draggable Sleep Timer: Specify a countdown (in minutes) from your profile dropdown to automatically pause playback when the timer runs out. Displays a draggable floating countdown bubble on active sleep timers, complete with a quick-cancel button.
• Collaborative Playlists & Privacy constraints: Toggle your playlist to Collaborative. Open the playlist's 3-dot context menu and select "Manage Collaborators" to invite other users to contribute tracks by entering their exact username or email address. Collaborative track additions display "Added by [User]" inline. Note that private playlists cannot be collaborative, and switching a playlist to private automatically clears out all existing collaborators. Private songs uploaded by you will automatically be stripped from another user's playlist, even if they have collaborative edit permissions.
• Drag-and-Drop Reordering: Inside your custom Playlists or your Favorites tab (when sorted by "My Order"), click and drag a song to manually reposition it. The new order is automatically saved.
• Metadata & Synced Lyrics: Use "Edit Info" to modify tags (Title, Artist, Album, Genre, Lyrics) and assign custom cover art. Synchronized LRC lyrics will automatically display and scroll in real-time.
  • Formatting LRC Lyrics: Ensure that each timestamp is followed by a space so the parser reads it correctly.
    Correct [00:15.30] Never gonna give you up
    

    Incorrect [00:15.30]Never gonna give you up
• Sharing: Click the share icon on any album, artist, playlist, track, or blog to generate direct social links (Facebook, X, WhatsApp, Telegram) with direct query parameters.
• Developer Tools & API Playground: Access the API Documentation and visual Playground from the sidebar. You can inspect endpoints, generate test calls, copy payload structures, and evaluate live JSON responses directly.
• PWA Cache: If changes don't appear, use the "Clear Cache" button in the sidebar to securely wipe the IndexedDB version tracking and unregister the Service Worker dynamically.

PHP Music is built to minimize dependencies while maximizing performance:

• Single File Architecture: The index.php file operates both as the client HTML/CSS/JS payload and the backend REST JSON API via the ?action= router.
• Audio Routing (Web Audio API): Connects dual HTML5 audio elements (audio and audioB) through dedicated gain nodes to BiquadFilterNodes (EQ), routing into a DynamicsCompressorNode (Volume Normalization) before reaching the audio destination. This enables clean 3-second gapless crossfades.
• Database Schema (SQLite): Persistent data is stored cleanly inside music.db:
  • users: Manages credentials, profile pictures (WebP blobs), quotas, and verification.
  • music: Stores scanned track details, lyrics, optimized embedded artwork, and the is_private privacy state.
  • favorites & playlist_songs: Pivot tables mapping user relations and custom positional ordering, along with the `added_by` collaborator tracker.
  • playlists: Holds playlist details, collaborative preferences, and the is_private privacy state.
  • playlist_collaborators: Maps authorized editors to specific playlists.
  • offline_songs: Pivot table mapping user-specific offline songs.
  • listen_later: Stores user bookmarks and position maps.
  • personal_notes: Stores sandboxed personal notebook content.
  • tasks: Stores task lists with JSON items, categories, and starred state.
  • blogs: Stores blog titles, markdown content, public/private status, category pointers, and unique 8-byte hexadecimal `public_id` handles.
  • blog_categories: User-defined category mappings for organizing blog posts.
  • blog_comments: Threaded comment trees for blogs with parent-child nesting.
  • blog_reactions & blog_comment_reactions: Tracks user likes and dislikes on blog posts and individual comments.
  • song_reactions: Stores user likes/dislikes on tracks.
  • song_comments: Stores song-level comment logs.
  • comment_reactions: Stores likes/dislikes on individual comments.
  • community_posts: Stores public feed status updates.
  • community_reactions: Stores likes/dislikes on social posts.
  • messages: Stores peer-to-peer direct messages, image attachments, read statuses, and edit tracking.
  • blocks: Stores user-to-user block relationships.
  • history & play_counts: Continuous playback logs (registered after 30 seconds) fueling the recommendations engine.
  • follows: Map representing user-to-user and user-to-artist following relationships.
  • rhythm_scores: Stores personal rhythm game scores, perfect/great/good hit metrics, and maximum combo counts.
  • rhythm_favorites: Pivot table mapping user-specific favorite game tracks.
  • arts, art_files, art_series: PHPShares artwork storage, images, series, and metadata.
  • art_comments, art_comment_reactions: Comments and reactions for artworks.
  • imageditor_projects: Stores image editor project states (JSON) with title, dimensions, category, and starred status.
• Audio Streaming & SW: The get_stream endpoint natively handles HTTP_RANGE requests. The Service Worker intercepts streams, caching them in browser Cache Storage and generating custom 206 Partial Content range responses on local buffers for perfect offline seeking.
• PHPEditor (IDE): Integrated Ace Editor (`ace.js`) providing dark-mode syntax highlighting for PHP, JS, CSS, HTML, and JSON files, auto-saving buffers, and managing file history snapshots for instant rollbacks via the Drive API.
• ImagEditor: Built on Fabric.js for canvas manipulation. Supports layers, filters (brightness, contrast, saturation, blur, sepia, grayscale, invert), brush tools with symmetry, and exports to PNG, JPEG, WEBP, SVG, or JSON project files.
• PHPAudio: Uses the Web Audio API for decoding and waveform rendering. Trimming uses the AudioBuffer API. Metadata writing uses getID3's write functions. File versioning stored in `.file_version/` directories.
• PHPShares: Uploaded images are stored in `phpshares/uid_"/` with thumbnails. Series grouping, tags, and metadata are indexed in the database. The manga reader uses lazy loading for pages.

Access the administrative dashboard by appending ?access=admin to your URL. Log in using the admin password (default: your admin password). Admin sessions are highly persistent and securely cached in the browser via a 1-year cookie.

• User Management: View a paginated list (20 users/page) of registered users, searchable by ID, Email, or Artist name.
• Verification: Toggle verification status. Unverified accounts cannot upload files.
• Ban System: Instantly suspend malicious accounts. Suspended users are locked out of the app.
• Account Deletion & Purging: Permanently delete any user and purge all of their uploaded files, playlists, notes, tasks, blogs, and categories from the server database.
• System Library Context: Tracks scanned directly from the host disk are assigned to a virtual administrator account named "Music Library" (ID dynamically resolved).
• Drive Manager: An integrated file manager for server assets (?access=admin&page=drive). Features include native .zip extraction via context menus, dynamic URL deep linking for active files, an optimized 2-column mobile grid, and recursive folder property calculations (displaying total files, subdirectories, and byte size).
• PHPEditor (IDE): A browser-based code editing suite (?access=admin&page=ide) featuring a file tree explorer, multi-tab Ace Editor, version history rollback, media viewer, and an interactive terminal console (`git`, `ls`, `pwd`, `php -v`).
• PHPDBManager: A web-based SQLite database manager (?access=admin&page=dbmanager) for browsing tables, running SQL queries, inserting/updating/deleting rows, exporting/importing CSV or SQL dumps, managing indexes and foreign keys, and performing maintenance (VACUUM, integrity check).
• Song Management: List, search, bulk edit, ban/unban, and soft/permanent delete songs. Transfer ownership between users.
• Artwork Management: Manage uploaded artwork (PHPShares) with metadata editing, bulk actions, and permanent deletion with file cleanup.
• Activity Logs: View a chronological list of all admin actions performed, including user and target details.
• Profile Reports: Manage user reports submitted by other users, with options to ban or dismiss.
• Ban Appeals: Review and approve/reject appeals from banned users, with ability to restore access.
• API Keys: Manage system-wide API keys for developer integrations. Generate, verify, ban/unban, and delete keys.
• Storage Stats: Visual breakdown of disk usage, audio files, non-audio assets, and per-user storage footprint with charts.

The backend operates via GET/POST requests targeting ?action=.... All responses (except file streams and images) return strict JSON.