A collection of tools for manipulating and interacting with music metadata.
Project description
music-metadata-tools
A collection of tools for manipulating and interacting with music metadata.
id3autosort - metadata-based music organization utility
id3autosort organizes music libraries based on each track's metadata. Supports AAC, AIFF, FLAC, MP3, OGG and WMA formats.
Usage
$ id3autosort [-u] [-n] [-v] [-s <desired structure>] /path/to/music [/path/to/music ...] /path/music/should/go
General Options
--windows-unsafe, -u Use all characters in metadata for new directories,
including ones Windows filesystems normally choke on
--dry-run, -n Simulate the actions instead of actually doing them
--verbose, -v Increase logging verbosity
Structure Option
The -s
switch allows the user to define the way they wish their music to be structured, which will be obeyed so long as the user's music has the necessary tags.
Supported structure metatags: d (date), g (genre), l (album), r (artist)
For example, if a user specifies the structure "r/l (d)" with a destination directory of /tmp/music, results would be similar to these:
/tmp/music/Nirvana/Nevermind (1991)/Smells Like Teen Spirit.mp3 /tmp/music/The Eagles/Hotel California (1976)/Hotel California.flac /tmp/music/Tupac/All Eyez On Me (1996)/California Love.ogg
Whereas if a user specifies the structure "g/d/r" with the same destination directory, results would be similar to these:
/tmp/music/House/2001/Daft Punk/Crescendolls.wma /tmp/music/Pop/2014/Taylor Swift/Shake It Off.aiff /tmp/music/Dubstep/2006/Skream/Midnight Request Line.m4a
Characters that are not already reserved for expansion are passed through to the generated structure, but no guarantee is made that other letters will not be used to expand other tags in the future.
apic-tool - music file image manipulation utility
apic-tool allows the user to insert and extract image data from music files. Currently supports mp3 files.
Usage
General Options
--dry-run, -d Simulate the actions instead of actually doing them
--verbose, -v Change the program's verbosity
--force Whether or not the tool should allow things to happen that may have complications
Extracting Images From Music Files
Extract image from file to specified location:
$ apic-tool extract /path/to/file.mp3 /path/for/outfile.jpg
Note that if not forced, the actual extension used may change depending on the image type in the file.
Extract image from file with no specified location:
$ apic-tool extract /path/to/file.mp3
Image will be saved to /path/to/file.xyz, with xyz
changing depending on the image type in the file.
Inserting Images Into Music Files
Insertion Options
--pic, -p /path/to/image.jpg Image to insert into music files
(currently support GIF, JPEG, PNG)
--dir, -d /path/to/music [/path/to/other/music ...], Directory or directories containing files to insert image into
NOTE: does not recurse
--file, -f /path/to/file.mp3 [/path/to/other/file.mp3 ...] Individual files to insert image into
--keep, -k Don't delete image after inserting it
Put an image into a file:
$ apic-tool insert --file /path/to/file.mp3 --pic /path/to/image.jpg
Put an image into a directory of files:
$ apic-tool insert --d /path/to/dir --p /path/to/image.jpg
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for music-metadata-tools-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5d5acb97a7461027ae6f11a3abcfb4cd3d0e929a0feca9a288cea89a781ff8fc |
|
MD5 | 1f2117fe6260a139cced344d1a07849f |
|
BLAKE2b-256 | 431258b13927544b91ef8fccfe80d3c9389335a7e903a9e79a771bad1f7eec36 |
Hashes for music_metadata_tools-1.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 59f3da162f8f599e290ae478f3bc449743c416e9bccad064662df2fe614c8b85 |
|
MD5 | 89a5765b05be3fd576f86b1c82c94311 |
|
BLAKE2b-256 | f69ecd95090396d0661e024807b74517311f015d439511f0b4cfbc4cb4d880bf |