:musical_score: Fixes music metadata and adds album art.

3 years after


PyPI License: MIT

Fix .mp3 files in the current directory (Adds song details,album art)
  • Fixes .mp3 files in the current working directory.
  • Adds lyrics to song.
  • Ignores songs already containing metadata.
  • Changes file name to correct song title.

> Adds artist name, album name, album art

> Adds Lyrics


Python 2.x
$ pip install musicrepair
Python 3.x
$ pip3 install musicrepair

(If it doesn't work for Windows users, check this out)


$ musicrepair -h
usage: musicrepair [-h] [-d REPAIR_DIRECTORY] [-R] [-r REVERT_DIRECTORY] [-n]
                   [--format RENAME_FORMAT]

Fix .mp3 files in any directory (Adds song details, album art)

optional arguments:

  -h, --help            show this help message and exit

  -d , --dir 
                        Specifies the directory where the music files are

  -R, --recursive       Specifies whether or not to run recursively in the
                        given music directory

  -r , --revert
                        Specifies the directory where music files that need to
                        be reverted are located

  -n, --norename        Does not rename files to song title

                        Specify the title format used in renaming, these
                        keywords will be replaced respectively:

How to use

$ musicrepair


To do

  • [ ] Add view mode (Doesn't change metadata, just shows changes)
  • [x] Add a revert mode (Removes all metadata from songs)
  • [x] Add a no rename mode (Doesn't change file name)


The MIT License (MIT) Copyright (c) 2016 Lakshay Kalbhor

Top Contributors

lakshaykalbhor brandonb927 MCManuelLP moyiz rohanpandula baif666