MP3 Auto-Tagger

A Python command-line tool that automatically organizes your music library. It identifies albums using MusicBrainz, fetches metadata (track titles, artist, album, cover art), and applies ID3 tags and file renaming to your MP3 files.

Features:

• Automatic release lookup based on folder structure (Artist/Album).
• Interactive selection of MusicBrainz releases.
• Renames files to 01 - Track Title.mp3 format.
• Updates ID3 tags (Artist, Album, Title, Track Number) and embeds Cover Art.

Prerequisites

This project uses uv for extremely fast dependency management and virtual environment creation.

To install uv:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Via pip
pip install uv

Installation

1. Clone the repository:

   git clone <repository-url>
   cd <project-directory>

2. Create a virtual environment:

   uv venv

   This creates a virtual environment in the .venv directory.

3. Activate the environment:

   • macOS/Linux: source .venv/bin/activate
   • Windows: .venv\Scripts\activate

4. Install dependencies:

   uv pip install click musicbrainzngs mutagen

Usage

Run the script pointing to a folder containing MP3 files. The script expects the folder path to end in .../Artist Name/Album Name to help with the initial search.

python rename_and_tag.py "/path/to/music/Artist Name/Album Name"