Basic Commands¶
scan¶
After installing, the first thing you would probably want to do is scan a directory of MP3s to extract their tags. This can be done with:
pyTagger scan path/to/mp3s
This will scan basic MP3 information about each file into a snapshot
Several options are available to control the scanning. These can be found by running:
pyTagger scan --help
Related Code
pyTagger.actions.scan.process()
pyTagger.models.Snapshot.columnsFromArgs()
pyTagger.operations.hash.hashBuffer()
pyTagger.operations.on_directory.buildSnapshot()
pyTagger.operations.on_directory.walk()
pyTagger.operations.on_directory.walkAll()
pyTagger.proxies.id3.ID3Proxy.extractTags()
pyTagger.proxies.id3.ID3Proxy.extractTagsFromTrack()
pyTagger.proxies.id3.ID3Proxy.loadID3()
images¶
pyTagger not only extracts the ID3 information from MP3s, it can also extract any embedded images from the files:
pyTagger images path/to/mp3s path/to/where/images/are/stored
This command will extract any images from the MP3s found in the given path and place them in the destination directory.
- The name of the image files take the form
<artist> - <album> - <title>
- If the image is the same for all MP3s in an album, only one image file will be extracted
Related Code
rename¶
This command is used to apply (my) naming standards to a directory of MP3s
pyTagger rename path/to/mp3s path/to/new/home
The naming format is: <artist:40>/<album:40>/<track> <title>
Related Code
to-csv¶
Without developer tools, it can be difficult to read or update snapshot files. Often, it is more convenient to use Excel, or similar tools to view the MP3 tags.
pyTagger to-csv path/to/snapshot
This will convert the snapshot into a tabular format.
Several options are available to control the conversion. These can be found by running:
pyTagger to-csv --help
Related Code
convert-csv¶
Of course, if there is a way to create a tabular version of a snapshot, there needs to be a way to convert back to the snapshot format:
pyTagger convert-csv path/to/csv
This will convert the tabular version into the pyTagger format.
Several options are available to control the conversion. These can be found by running:
pyTagger convert-csv --help
Related Code
update¶
After changes have been made to a snapshot, either directly, or through the CSV process, you can write the changes into the MP3 files with this command:
pyTagger update path/to/snapshot
This will update the ID3 tags in the MP3 files.
Several options are available to control the updates. These can be found by running:
pyTagger update --help
Related Code