.TH "TRACKRENAME" 1 "2024-04-06" "" "Audio File Renamer"
.SH NAME
trackrename \- renames files based on metadata
.SH SYNOPSIS
trackrename [OPTIONS] <track 1> [track 2] ...
.SH DESCRIPTION
.PP
trackrename takes a list of audio files and renames them based on external or internal metadata.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
show a list of options and exit
.TP
\fB\-I\fR, \fB\-\-interactive\fR
edit format string in interactive mode prior to renaming tracks
.TP
\fB\-\-format\fR=\fISTRING\fR
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.
.TP
\fB\-V\fR, \fB\-\-verbose\fR=\fIVERBOSITY\fR
The level of output to display. Choose between 'normal', 'quiet' and 'debug'.
.SH EXAMPLES
.LP
Rename all of the FLAC files in the current directory based on their FLAC tag metadata:
.IP
track2rename *.flac

.LP
Rename file.flac with a custom template:
.IP
trackrename "--format=%(track_number)2.2d - %(album_name)s - %(track_name)s.%(suffix)s" file.flac

.SH FORMAT STRING FIELDS
.TS
tab(:);
| c   s |
| c | c |
| r | l |.
_
Template Fields
Key:Value
=
\fC%(track_number)2.2d\fR:the track's number on the CD
\fC%(track_total)d\fR:the total number of tracks on the CD
\fC%(album_number)d\fR:the CD's album number
\fC%(album_total)d\fR:the total number of CDs in the set
\fC%(album_track_number)s\fR:combination of album and track number
\fC%(track_name)s\fR:the track's name
\fC%(album_name)s\fR:the album's name
\fC%(artist_name)s\fR:the track's artist name
\fC%(performer_name)s\fR:the track's performer name
\fC%(composer_name)s\fR:the track's composer name
\fC%(conductor_name)s\fR:the track's conductor name
\fC%(media)s\fR:the track's source media
\fC%(ISRC)s\fR:the track's ISRC
\fC%(catalog)s\fR:the track's catalog number
\fC%(copyright)s\fR:the track's copyright information
\fC%(publisher)s\fR:the track's publisher
\fC%(year)s\fR:the track's publication year
\fC%(date)s\fR:the track's original recording date
\fC%(suffix)s\fR:the track's suffix
\fC%(basename)s\fR:the track's original name, without suffix
_
.TE
.SH SEE ALSO
.BR audiotools-config (1),
.BR audiotools.cfg (5),
.BR cdda2track (1),
.BR cddainfo (1),
.BR cddaplay (1),
.BR coverdump (1),
.BR covertag (1),
.BR coverview (1),
.BR dvda2track (1),
.BR dvdainfo (1),
.BR track2cdda (1),
.BR track2track (1),
.BR trackcat (1),
.BR trackcmp (1),
.BR trackinfo (1),
.BR tracklength (1),
.BR tracklint (1),
.BR trackplay (1),
.BR tracksplit (1),
.BR tracktag (1),
.BR trackverify (1)
.SH AUTHOR
Brian Langenberger