NAME
trackrename - renames files based on metadata
SYNOPSIS
trackrename [OPTIONS] <track 1> [track 2] ...
DESCRIPTION
trackrename takes a list of audio files and renames them based on external or internal metadata.
OPTIONS
- -h, --help
-
show a list of options and exit
- -I, --interactive
-
edit format string in interactive mode prior to renaming tracks
- --format=STRING
-
The format string to use for new filenames. Template fields are replaced with metadata values when new tracks are created. All other text is left as-is. If this option is omitted, a default format string is used.
- -V, --verbose=VERBOSITY
-
The level of output to display. Choose between 'normal', 'quiet' and 'debug'.
EXAMPLES
Rename all of the FLAC files in the current directory based on their FLAC tag metadata:
-
track2rename *.flac
Rename file.flac with a custom template:
-
trackrename "--format=%(track_number)2.2d - %(album_name)s - %(track_name)s.%(suffix)s" file.flac
FORMAT STRING FIELDS
| Template Fields | |
| Key | Value |
%(track_number)2.2d | the track's number on the CD |
%(track_total)d | the total number of tracks on the CD |
%(album_number)d | the CD's album number |
%(album_total)d | the total number of CDs in the set |
%(album_track_number)s | combination of album and track number |
%(track_name)s | the track's name |
%(album_name)s | the album's name |
%(artist_name)s | the track's artist name |
%(performer_name)s | the track's performer name |
%(composer_name)s | the track's composer name |
%(conductor_name)s | the track's conductor name |
%(media)s | the track's source media |
%(ISRC)s | the track's ISRC |
%(catalog)s | the track's catalog number |
%(copyright)s | the track's copyright information |
%(publisher)s | the track's publisher |
%(year)s | the track's publication year |
%(date)s | the track's original recording date |
%(suffix)s | the track's suffix |
%(basename)s | the track's original name, without suffix |
SEE ALSO
audiotools-config(1), audiotools.cfg(5), cdda2track(1), cddainfo(1), cddaplay(1), coverdump(1), covertag(1), coverview(1), dvda2track(1), dvdainfo(1), track2cdda(1), track2track(1), trackcat(1), trackcmp(1), trackinfo(1), tracklength(1), tracklint(1), trackplay(1), tracksplit(1), tracktag(1), trackverify(1)
AUTHOR
Brian Langenberger