Skip to content

Use shazam to rename and filled the tag of a list of mp3 files

License

Notifications You must be signed in to change notification settings

davidAlgis/mp3ShazamAutoTag

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MP3 File Recognizer and Renamer

This Python script automatically recognizes MP3 files using Shazam, renames them according to the recognized song title and artist, and updates their MP3 tags and cover art.

Installation

Before running the script, you need to install the required Python libraries. You can install them using the provided requirements.txt file.

pip install -r requirements.txt

Usage

Ensure you have Python 3.6 or newer installed on your system, there might be some problem with 3.11 and 3.12 (cf. issue #1). Also MacOS seems to have some problems to install shazamio, maybe it's necessary to install it manually (cf. issue #5). Clone this repository or download the script and requirements.txt file. Install the required libraries as mentioned above. To use the script, run it from the command line with the desired options:

python main.py  [options]

Options

  • -di, --directory : Specify the directory where MP3 files are located for processing. If not specified, the script uses its current directory.

  • -t, --test: Execute a test function to verify the script's functionality. It looks for a file named "fileToTest.mp3" in a test folder and checks the renaming process.

  • -m, --modify <True/False>: Indicate whether the script should apply modifications to the MP3 tags and filenames. Defaults to True.

  • -de, --delay : Specify a delay (in seconds) to wait before retrying the Shazam API call if the initial attempt fails. Defaults to 10 seconds.

  • -n, --nbrRetry : Specify the number of retries for the Shazam API call if it fails. Defaults to 10 tries.

  • -tr, --trace: Enable tracing to print messages during the recognition and renaming process. Useful for debugging or monitoring script progress.

  • -h, --help: Display help information showing all command-line options.

About

Use shazam to rename and filled the tag of a list of mp3 files

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages