Old-School Vibes: Free MP3 Player Module

KEY FEATURES:

• 🎵 Plays MP3, WAV, OGG, M4A, MP4, MPEG formats
• 🎨 Full color customization (background, cassette, speakers, frame)
• 📂 AUTO-SCAN: Automatic directory scanning for MP3 files
• 🎧 Intelligent filename parsing (Artist - Title extraction)
• 🔄 Smart preloading with adaptive buffering
• 📱 Responsive design (desktop, tablet, mobile)
• 🎪 Audio visualization with animated bars
• ⚡ Progressive loading with connection detection
• 🎛️ Volume control, navigation, play/pause/stop
• 🏷️ Scrolling long titles with marquee effect
• 🎨 7 cassette color schemes (black, white, red, blue, green, gold, silver)

ADDITIONAL FEATURES (NEW):
• 📻 M3U playlist support (local & remote, e.g. GitHub)
• 🔊 Autoplay for tracks and radio streams
• 🌐 GitHub RAW link conversion for M3U playlists
• 🕒 Track time counter (elapsed & countdown)
• 🖱️ Bulk import: add multiple MP3 files at once (with auto-scan)
• 🧠 Advanced speaker animation: vibration, pulsation, music & beat synchronization
• 🏷️ Automatic radio stream detection from playlists
• 🛡️ Robust error handling and validation for remote playlists

INSTALLATION & SETUP:
1. Install the module in Joomla Administration
2. Upload MP3 files to /images/audio/ folder (or custom path)
3. In module configuration, set "Directory to scan" path
4. Save module - system will automatically scan and add all MP3s
5. Customize colors and appearance to your preferences

TECHNICAL DETAILS:
• Compatibility: Joomla 3.x, 4.x, 5.x, 6.x
• Languages: Polish, English
• Technology: HTML5 Audio API, CSS3 Animations, JavaScript ES6
• Optimization: Lazy loading, smart caching, connection-aware buffering
• Security: CSRF protection, input validation, sanitization