Python program/script that analyzes, manipulates, and renames music files by extracting metadata
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


NeatBeats renames all the music files in a folder to the actual title of the song from its metadata and organizes them into folders neatly named by their album names. Extremely helpful for organizing a lot of music files downloaded from the internet, which often have obscure file names. This program essentially extracts the actual title/album/artist/tracknumber from a song and incorporates it into the actual file/folder name. Works by using Mutagen 1.3.1 to extract the metadata and also regex to standardize all the file names

HOW TO USE: Place a music folder in the file directory as and execute the python file. This will give you a list of commands of what you would like to do. Type in your commands and let it do the rest!


  • include support for more music files (Currently supports m4a, mp3, flac)
  • make it more user friendly (a GUI once I learn how to use Tkinter)
  • more options such as organizing by artist name, etc.

NeatBeats turns this Alt text

Into this Alt text

This is done by extracting the metadata from an audio file. This is particularily useful since a lot of songs downloaded from the internet tend to have inconsistent conventions for naming the files, whereas the metadata is generally the same regardless of where the song is downloaded from.