🎵 MelodiMeta: Your Symphonic Metadata Maestro 🎚️

Orchestrate your music library like a pro! 🎼✨

MelodiMeta is your ultimate companion for managing music metadata and syncing track numbers with ease. Say goodbye to messy music libraries and hello to perfectly organized tunes! 🎧🔍

🚀 Features

• 🔄 Automatic track number syncing from filenames (supports "XX. Title" format)
• 📝 Smart track number extraction with leading zero handling
• 📊 Detailed logging system with debug information
• ⚙️ Environment variable support
• 🛡️ Enhanced error handling and validation
• 🖼️ Cover image management (coming soon!)
• 🎨 Sleek interface (web app in development)

🆕 Recent Updates

• ✨ Improved track number extraction from filenames
• 🔧 Enhanced regex pattern matching for various filename formats
• 📝 Better debug logging for troubleshooting
• 🛠️ Refactored code structure with separate track utilities

🎭 Usage Scenarios

🎬 Plex

Elevate your Plex experience by ensuring all your music files have consistent and accurate metadata. MelodiMeta helps you:

• Sync track numbers for perfect playlist ordering
• Update metadata for improved search and organization
• Prepare your library for seamless Plex scanning

🧊 Jellyfin / Emby

Enhance your Jellyfin or Emby media server with pristine music metadata:

• Ensure album tracks are in the correct order
• Streamline library updates with consistent file naming
• Improve browsing experience with accurate track information

📚 General Music Library Management

Whether you're a casual listener or an audiophile, MelodiMeta helps you:

• Organize large music collections effortlessly
• Prepare files for import into any media player or server
• Maintain a clean and professional music library

To use MelodiMeta with your media server:

1. Run MelodiMeta on your music files
2. Rescan your library in Plex, Jellyfin, or Emby
3. Enjoy your perfectly organized music collection!

🛠️ Requirements

• Python 3.7+
• mutagen library
• python-dotenv

🚀 Quick Start

📥 Clone the Repository

git clone /~https://github.com/sharvinzlife/MelodiMeta.git
cd MelodiMeta

🔧 Configuration

1. Create a .env file in the project root:

MUSIC_PATH=your/music/directory/path

🏃‍♂️ Running the Script

🪟 Windows

# Setup
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

# Run using batch script
run.bat

🐧 Linux/macOS

# Setup
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Make the shell script executable
chmod +x run.sh

# Run using shell script
./run.sh

You can also specify a custom path:

# Windows
run.bat "path/to/your/music/folder"

# Linux/macOS
./run.sh "path/to/your/music/folder"

📝 Logs

Check melodimeta.log for detailed operation logs.

🧹 Deactivate the Environment

deactivate

🏷️ Tags

#MusicMetadata #Python #AudioTools #MP3 #FLAC #MusicLibrary #OpenSource

Happy organizing! 🎉🎵