Replica, the id3 metadata cloner
Switch branches/tags
Nothing to show
Clone or download
Latest commit 724f726 May 11, 2018
Failed to load latest commit information.
replica Use pipenv May 11, 2018
LICENSE initial commit Apr 28, 2012 Remove test/ May 11, 2018
Pipfile Use pipenv May 11, 2018
Pipfile.lock Use pipenv May 11, 2018 Update May 11, 2018 Update Dec 30, 2014 Use pipenv May 11, 2018

Replica, the id3 cloner

When considering to make a new purchase of mp3 files to get them in better quality, losing the id3 metadata in the process may be an hindrance to the upgrade.

Replica can help you having it both ways by cloning id3 metadata from the original file to the enhanced copy.


If you replicate full albums, please make sure that tracks filenames are similarly ordered in both source and destination folders.

$ replica -u Library/Sam_Cooke-Ain_t_that_good_news-128kbps-2003 Incoming/sam_cook-good-news-320kbps
Cloning id3 metadata... Done
Renaming files......... Done

In addition to id3 cloning, replica can handle files renaming too so that upgrading mp3 files becomes a no-brainer.

Consider the -u option to remove the source files and replace them by their upgraded version. By doing so, it instantly migrates id3 metatags to new files while keeping the information stored by your music player (ratings, play counts, etc) valid as the tracks filepaths get unmodified.


Replica modifies mp3 files with no provision provided to undo the changes. I would highly recommend a backup of your mp3 prior to running replica on them.


You can install replica by typing pip install replica.