Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Replica, the id3 metadata cloner

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 replica
Octocat-spinner-32 test
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rst

Replica, the id3 cloner

Oh sure, she is showing off a sexy face. Perfect metatags shaped by you to fullfill your media management OCD. But deep inside, you know this track lacks some inner beauty.
Is it about low bitrate or crackling noises? Doesn't matter, the quality is just not there.
So you buys a copy that possesses a purest soul, a crystal clear 320kbps version ... only to realize that it needs a boatload of plastic surgery to make it look like the original.

Replica can help you having it both ways by cloning id3 metadata from the original file to the 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. Preserving filepaths enables you to migrate id3 metatags to new files while keeping the information stored by your music player (such as ratings or play counts) valid.


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.


Replica is by Fabrice Laporte.

Something went wrong with that request. Please try again.