Skip to content

AudDMusic/Tagger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

AudD Music Tagger

Identify and organize your music files automatically. AudD Music Tagger listens to your audio files, recognizes the songs using AudD audio fingerprinting, and renames them / writes proper metadata — no existing tags needed.

Built for the common scenario of having a folder full of music files with random or meaningless filenames (like Gjzhdj3763hd72b.mp4) and no way to tell what they are.

Download

Go to Releases and download the right file for your system:

Platform Download
Windows AudD_Music_Tagger-Windows.exe
macOS AudD_Music_Tagger-macOS
Linux AudD_Music_Tagger-Linux

On macOS/Linux, you'll need to make it executable first: chmod +x AudD_Music_Tagger-*

How to use

  1. Get an API token — sign up free at dashboard.audd.io (first 300 songs are free)
  2. Open the app and paste your token
  3. Browse to your music folder
  4. Click Start — the app will go through each file, identify the song, rename it to Artist - Title, and write the metadata

That's it. You'll see results appear in real time with a progress bar and ETA.

What it does to your files

  • Renames files to Artist - Title.mp3 (or .mp4 / .m4a)
  • Writes tags — title, artist, album, year — so the songs show up properly in any music player
  • Both options can be toggled off independently

Undoing changes

Every rename is logged. Click Undo Renames to revert all files back to their original names.

Right-click menu

Right-click any row in the results table to:

  • Open the file's location in Explorer / Finder
  • Play the file
  • Open the song link (a page about the identified song)
  • Copy the artist & title, filename, or full path

Other features

  • Include subfolders — scan nested directories
  • Export CSV — save all results (including song links) to a spreadsheet
  • No file size limit — handles large files that other tools reject
  • Works with MP3, MP4, and M4A

API usage & cost

This tool uses the AudD music recognition API. Each file costs 1 API request. New accounts get 300 free requests; after that, it's $5 per 1000 requests for low request volumes. Sign up at dashboard.audd.io.


For developers

Running from source

pip install requests mutagen
python audd_music_tagger.py

Requires Python 3.8+ and tkinter (included with Python on Windows and macOS; on Linux, install python3-tk).

Building executables locally

pip install requests mutagen pyinstaller
pyinstaller --onefile --windowed --name "AudD_Music_Tagger" audd_music_tagger.py

The executable will be in the dist/ folder. On Windows you can also double-click build_exe.bat.

How it works

Each file is uploaded to the AudD enterprise endpoint with limit=1, which scans only the first 12-second chunk of audio. The top-scoring match is used for renaming and tagging. Tags are written with mutagen (ID3 for MP3, MP4 atoms for M4A/MP4).

An undo log (.audd_tagger_undo.json) is saved in the music folder so renames can be reversed.

CI/CD

The GitHub Actions workflow in .github/workflows/build.yml builds executables for Windows, macOS, and Linux. It runs automatically when a release is created and uploads the binaries as release assets.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages