MusicNamer

A desktop application for batch renaming audio files using music fingerprinting and metadata lookup services.

Features

• AcoustID fingerprinting - identifies songs by audio fingerprint
• MusicBrainz search - fuzzy metadata search
• Embedded tag reading - extracts artist/title from file metadata
• Filename guessing - parses artist and title from existing filenames
• Batch rename - rename multiple files at once
• Title case formatting - consistent filename formatting

Requirements

• Python 3.9+
• fpcalc (for AcoustID fingerprinting)

Installation

pip install .

Or for development:

pip install -e .

Usage

musicnamer

Or as a module:

python -m musicnamer

1. Browse for a folder containing audio files
2. Configure your AcoustID API key (optional, for fingerprinting)
3. Click Scan Files to populate the file list
4. Click Get Metadata to lookup artist/title information
5. Edit any fields manually if needed
6. Select files and click Rename Files

Project Structure

musicnamer/
    __init__.py      # Package metadata
    __main__.py      # Entry point
    fingerprinter.py # MusicBrainz fingerprinting
    helpers.py       # Filename utilities
    workers.py       # Background threads
    gui.py           # PyQt5 GUI

Supported Formats

MP3, FLAC, WAV, OGG, M4A, AAC, WMA

License

MIT