---
name: "trackrename"
section: "1"
platform: "linux"
package: "audiotools"
version: "3.1.1-1.1+b12"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/trackrename"
---

# trackrename(1)

renames files based on metadata

## 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-config/1.md), [**audiotools.cfg**(5)](/audiotools.cfg/5.md), [**cdda2track**(1)](/cdda2track/1.md), [**cddainfo**(1)](/cddainfo/1.md), [**cddaplay**(1)](/cddaplay/1.md), [**coverdump**(1)](/coverdump/1.md), [**covertag**(1)](/covertag/1.md), [**coverview**(1)](/coverview/1.md), [**dvda2track**(1)](/dvda2track/1.md), [**dvdainfo**(1)](/dvdainfo/1.md), [**track2cdda**(1)](/track2cdda/1.md), [**track2track**(1)](/track2track/1.md), [**trackcat**(1)](/trackcat/1.md), [**trackcmp**(1)](/trackcmp/1.md), [**trackinfo**(1)](/trackinfo/1.md), [**tracklength**(1)](/tracklength/1.md), [**tracklint**(1)](/tracklint/1.md), [**trackplay**(1)](/trackplay/1.md), [**tracksplit**(1)](/tracksplit/1.md), [**tracktag**(1)](/tracktag/1.md), [**trackverify**(1)](/trackverify/1.md)

## AUTHOR

Brian Langenberger