The mp3 retagger can take a directory and create a 'backup' of information to ensure that regardless of any modifications made to the files within, the directory can be reverted back to seedable form in the event that someone requests a reseed. Under normal circumstances, renaming files, deleting sfv or nfo files, or altering file tags will prevent one from reseeding. This tool will eliminate that problem.

The backup is created in the following manner. When a directory is chosen, a list is compiled of all files in the directory. This scan is recursive, and will compile a list of all files in subdirectories as well. Any file that is not audio or video is written into the backup. This includes any text files (nfo, m3u, sfv, txt, etc) and images. This is done so that the files may be restored in the event they are deleted. For mp3 files, the id3 tags (both v1 and v2) are written into the backup, along with a sha1 hash value for just the AV segment of the file, so a lookup can be done later to determine how the new files map to the old files.

When a restore is run, the program iterates down the backup, recreating text and image files, and calculating the sha1 values for the AV segment of all mp3s. When the sha1 is determined, a lookup is done against the backup file to determine if the mp3 was part of the initial torrent. If it is not found, no action is taken (so even if you run the restore on a full discography of a band, unrelated files will not be touched). If the SHA1 lookup yields a result, the id3 tags are replaced with the originals, and the files renamed to their original names, leaving exact copies of the originals.

The program is pretty easy to understand. It consists of a single panel, which looks like this:

There are four buttons:

Backup ID3 Tags to *.tags file will prompt you for a directory to backup, and then for a name for the backup. Once these two variables are specified, it will iterate through the directory and backup all required data into the specified filename. All data will be GZipped to take up less space. This file should be very small, even for large discographies, unless there are large quantities of ID3 tags containing images.

Restore ID3 Tags from *.tags file will prompt you to choose a *.tags file. This file must be located in the directory you wish to treat as the 'root' of the renaming. While it is entirely possible to choose the C: drive and still have everything work okay, having the program iterate through every file on the drive until it finds the relevent ones will prove to not be worth your time. When the relevent files are encountered, they will be renamed and retagged, and any missing text/image files will be recreated. The window will be unresponsive as this progresses, so just wait it out. The 'informations' frame will say 'done' when it's done. At this point, the directory is ready to reseed.

Obviously, the restore process will destroy your tags, so before running it, it is a good idea to create another backup *.tags file, this one containing YOUR tags, rather than the original tags. When you are finished seeding, simply restore YOUR tags file and the files will be as you want them.

Give me money is a link to paypal donation. If you like the program, make a donation. Yay!

Exit is top secret. You'll just have to click it to find out what it does.

At the very bottom is my email address. Click it if you need to send me bug reports or any other correspondance.