Fix your songs metadata, keep all metadata with the same ID3 version and better organize your library. Batch edit the names of your mp3 files, based on their metadata.
To run the project you must have python 3 installed and added to your path. Once this step is done, you just have to clone the project, put the songs you want to edit in the folder called input
and put this commands in the windows terminal, in the directory where you have cloned the project:
pip install -r requirements.txt
python main.py
You could try python3
instead of python
if the previous command does not work
Notes:
The project has been made with python version 3.10, so its compatibility with previous versions is not guaranteed.
The program will skip files that are not in .mp3 format
In the root folder of the project you will see a folder called settings
file called settings.json
inside. In this file, you can modify several parameters to your liking:
-
input_path: Folder from which the mp3 files will be read. Defaults to "input"
-
output_path: Folder in which the new fixed mp3 files will be downloaded. If this directory does not exist, it will be created. Defaults to "output"
-
id3_version: Version of ID3 to use for the metadata. Check https://en.wikipedia.org/wiki/ID3 for more info
-
new_filename_format: Format of the names that the new created files will have. You can specify song attributes in this name by putting them in square brackets. Defaults to "{artist} - {title}". Accepted attributes are:
artist
title
album
discnumber
tracknumber
Feel free to improve and optimize the existing code. To contribute to the project, read the previous points carefully and do the next steps with the project:
- Fork it (https://github.com/enriqueloz88/ID3-Tags-and-mp3-Fixer/fork)
- Create your feature branch (
git checkout -b feature/newFeature
) - Commit your changes (
git commit -am 'Add some newFeature'
) - Push to the branch (
git push origin feature/newFeature
) - Create a new Pull Request
Feel free to contact the developer if you have any questions or suggestions about the project or how you can help with it.