🎵 Haven — Modern Local Music Player

A sleek, futuristic music player built entirely with HTML, CSS, and Vanilla JavaScript.

Haven lets you browse and play your local MP3 collection directly from your browser using the File System Access API. No installation, accounts, or uploads required.

---

✨ Features

🎶 Music Library

• Open any folder containing MP3 files
• Recursive folder scanning
• Automatic song detection
• Search songs instantly
• Display song duration
• Browse by folder

▶ Playback Controls

• Play / Pause
• Previous / Next
• Seek bar
• Volume control
• Mute / Unmute
• Shuffle
• Repeat One
• Repeat All

❤️ Library Features

• Favorites
• Recently Played
• Shuffle entire library
• Search songs

🎨 Modern Interface

• Glassmorphism design
• Animated vinyl records
• Dynamic colors
• Animated particle background
• Equalizer animation
• Toast notifications
• Smooth transitions
• Responsive layout

💾 Saves Your Preferences

Automatically remembers:

• Favorites
• Recently Played
• Volume
• Shuffle mode
• Repeat mode
• Mute state

using your browser's Local Storage.

---

📂 Project Files

Haven/
│
├── index.html
└── README.md

Everything is contained inside a single HTML file.

No frameworks.

No external JavaScript files.

No installation required.

---

🚀 How to Use

1. Open index.html in a modern Chromium-based browser such as:

   • Google Chrome
   • Microsoft Edge
   • Brave
   • Opera

2. Click Open Folder.

3. Select a folder containing your MP3 files.

4. Haven will automatically:

   • Scan all folders
   • Detect MP3 files
   • Build your music library
   • Load song durations

5. Enjoy your music!

---

⌨ Keyboard Shortcuts

Key	Action
Space	Play / Pause
←	Previous Song
→	Next Song
↑	Increase Volume
↓	Decrease Volume

---

🛠 Built With

• HTML5
• CSS3
• Vanilla JavaScript (ES6)
• HTML Audio API
• File System Access API
• Local Storage API

---

🌟 Highlights

• Single HTML file
• Lightweight
• Fast
• Offline capable
• Responsive
• Privacy friendly
• Modern UI
• Local music playback

---

🌐 Browser Support

Browser	Support
Google Chrome	✅
Microsoft Edge	✅
Brave	✅
Opera	✅
Firefox	❌ Limited
Safari	❌ Limited

---

🔒 Privacy

Haven never uploads your music.

All files stay on your computer and are only accessed after you choose a folder.

No cloud services.

No tracking.

No accounts.

---

📸 Screenshots

You can add screenshots here later.

screenshots/
├── home.png
├── library.png
├── player.png
└── mobile.png

---

🚧 Future Ideas

• Playlist support
• Album artwork
• Lyrics support
• Audio visualizer
• Theme customization
• Equalizer
• FLAC & WAV support
• Drag-and-drop folder loading

---

📄 License

Free to use for personal and educational purposes.

---

🎵 Haven

Your local music. Beautifully played.