Track Renamer

CLI tool for formatting and renaming audio files. Originally written in Python, and then re-written in Rust, which is now the primary version.

Formats artist and title tags, and renames filenames to match tags. If tag data is missing, will try to extract artist and title from the filename.

Rust version

Supports MP3 and AIFF via ID3 tags, and FLAC via Vorbis comments.

./build.sh
./install.sh

The convert option requires ffmpeg to be available in path.

See the test data for formatting examples. The formatting rules and functions are specified in src/formatting.rs.

Usage

Usage: trackrename [OPTIONS] [PATH]

Arguments:
  [PATH]  Optional input directory or audio file to format

Options:
  -a, --all-tags   Resave tags for all files with ID3v2.4
  -c, --convert    Convert failed MP3 files to AIFF using ffmpeg
  -d, --debug      Enable debug prints
  -f, --force      Do not ask for confirmation
  -l, --log        Log files that can't be read
  -p, --print      Only print changes without modifying files
  -r, --rename     Rename all audio files
  -S, --silent     Suppress running index and directory output
  -s, --sort       Sort audio files by name
  -t, --tags-only  Only fix tags without renaming files
  -v, --verbose    Verbose output
  -h, --help       Print help
  -V, --version    Print version

User config

An optional user config can be put under ~/.config/track-rename.toml. It supports specifying track names to exclude, which will be skipped during the processing. These can include a file extension or not, and should not contain a path, just the filename. See the track-rename.toml template for more details and supported options.

Tests

cargo test

Code Coverage

Code coverage is generated using cargo-llvm-cov with cargo-nextest.

# Run tests with coverage (text output)
cargo llvm-cov nextest

# Generate HTML coverage report
cargo llvm-cov nextest --html

# Generate and open HTML report in browser
cargo llvm-cov nextest --html --open

The HTML report is generated in target/llvm-cov/html/.

Required Tools

cargo install --locked cargo-nextest
cargo install --locked cargo-llvm-cov

TODO

• Refactor track renamer functions
• Support other tag / filetypes as well