An interactive CLI tool to modify audio file metadata using Mutagen.
This software is provided "AS IS", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the author or contributors be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
By using this software you agree that the author shall not be held responsible for any damage, loss of data, or other issues that may occur.
- Manual mode — edit metadata fields (title, artist, album, year, genre, track, disk, compositor, album artist, comments, lyrics, BPM, ISRC, cover art) for a single file or in batch for entire albums.
- Automatic mode — search TheAudioDB by artist and album name, preview the retrieved metadata, then apply it to your files.
- Cover art embedding — embed JPEG cover art into audio files, or download it automatically from TheAudioDB.
MP3, FLAC, OGG, Opus, MP4, M4A, M4B, M4P, M4V, 3GP, ASF, WMA, WMV, AIF, AIFF, WAV
- Python 3.10+
- FFmpeg on PATH (required for format conversion and WAV tagging)
# Set up virtual environment
python -m venv venv
source venv/bin/activate # Linux/macOS
# or: venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
# Run
python app.py