HarmonyHaven

🎵 Your Music. Your Rules. Your Collection.

A free, open-source music library manager & player for Windows.
No streaming. No subscriptions. No internet. No accounts.
Just you and your music files.

Developed by Alejandro X. Solis — TechFusion Repairs LLC

---

🎧 What is HarmonyHaven?

HarmonyHaven combines a full music player with a powerful library management toolkit — all running locally on your PC. Your files never leave your computer. Scan any folder, organize your collection, wipe out duplicates, build playlists, and listen to your music from one clean, fast interface.

---

✨ Features

🎵 Music Playback

Full transport controls — previous, play, pause, stop, next — with an adjustable volume slider. Double-click any track to play it instantly.
Supports: MP3 · FLAC · WAV · M4A · OGG · AAC

📂 Directory Scanner

Point HarmonyHaven at any folder and it recursively finds every audio file in every subfolder — thousands of tracks loaded in seconds.

⧉ Duplicate Finder

Years of downloads pile up fast. HarmonyHaven calculates an MD5 fingerprint of every file and identifies exact duplicates — even ones with different names or in different folders. Review and delete with one click.

⊞ Auto-Organize by ID3 Tags

Your music already has Artist, Album, Genre, and Year embedded inside it. HarmonyHaven reads those tags and automatically moves your files into a clean folder structure of your choice — one click to go from chaos to organized.

🔍 Search

Find any track instantly by filename, or use Advanced Search to filter your entire library by Artist and Genre using embedded metadata.

📋 Playlists

Create named playlists, save them as portable files, load them back any time, and delete ones you no longer need.

🗄 SQLite Library Database

A fast local database keeps your library indexed for snappy searches and lookups across thousands of files — no re-scanning every time.

↗ Export to CSV

Export your full track list as a spreadsheet — great for inventorying your collection or keeping a backup record.

⌫ Empty Folder Cleanup

After organizing or removing files, HarmonyHaven finds and removes all the empty folders left behind in one click.

---

🚀 What's New in Version 2.0

• ⭐ Brand-new dark UI — deep navy, sky blue, and light cyan palette matched to the app logo
• ⭐ Logo in the header and About section
• ⭐ Rebuilt transport controls with circular buttons and hover effects
• ⭐ Pause/resume fixed — pause now correctly toggles back to playing
• ⭐ New Contact tab — clickable email, WhatsApp, website, and PayPal donate links
• ⭐ Faster database layer — bulk inserts, advanced search, safe connections
• ⭐ New formats — OGG and AAC support added
• ⭐ CSV export now uses a Save As dialog
• ⭐ Delete Playlist button added
• ⭐ 10 bug fixes across playback, search, file ops, and the UI

---

💻 System Requirements

• ✅ Windows 10 or Windows 11 (64-bit)
• ✅ 2 GB RAM minimum
• ✅ ~50 MB disk space
• ✅ No Python required — bundled inside the .exe
• ✅ No internet connection required
• ✅ No account required — ever

---

📥 How to Run

1. Download HarmonyHaven.exe
2. Move it to its own folder (e.g. C:\HarmonyHaven\)
3. Double-click to launch — no installer, no setup

⚠ First launch only: Windows SmartScreen may show "Windows protected your PC." This is a false positive. Click More info → Run anyway. It won't appear again.

If you see a VCRUNTIME error, install the free Microsoft Visual C++ Redistributable and try again.

---

⌨ Keyboard Shortcuts

Ctrl + O	Scan / open a music folder
Ctrl + P	Play selected track
Space	Pause / Resume
→ Right Arrow	Next track
← Left Arrow	Previous track
Double-click	Play track from the list

---

💙 Free Forever

HarmonyHaven is completely free and always will be, released under the MIT License. Use it, share it, modify it — no strings attached.

Donations are never required, but deeply appreciated — they help fund development and keep new features coming. A PayPal donate button is available inside the app's Contact tab.

---

📬 Contact & Support

Developer: Alejandro X. Solis — TechFusion Repairs LLC
Email: TechFusionRepairs@gmail.com
WhatsApp: (940) 808-5105
Website: TechFusion Repairs LLC
GitHub: github.com/TechFusionRepairs/HarmonyHaven

We respond to all messages within 24–48 hours.

---

© 2024 TechFusion Repairs LLC · MIT License · Free Forever