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

                                            2024-11-13                             TRACKRENAME(1)