An opinionated, fast music organiser.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
.travis.yml
Cargo.lock
Cargo.toml
LICENSE
README.md

README.md

Tests

mack is to music files as black is to code formatting. It enforces standards around both consistency of the metadata (eg. ID3 version) and the metadata itself (eg. "feat" tagging).

Examples of fixes

  • Moving featured artists from the artist tag to the title
  • Enforcing a consistent "feat" format in title tags
  • Whitespace normalisation
  • Renaming files to format "{artist}/{album}/{track} {title}"

Usage

mack [DIR]

You can also see what would be changed first using --dry-run.

Building

You need TagLib installed on your system to build. This can be found in the following packages:

After that, cargo build as normal.

Performance

mack has a strong focus on performance. Files which were not updated since the last mack run will not be examined at all. On a sample modern laptop with a mid-spec SSD, this means that we only take 0.02 seconds to run over 5000 files under most circumstances (0.2 seconds on the very first run).

Configuration

In a similar philosophy to black, most things cannot be configured -- you either use mack or you don't. There is one thing you can control though: if you don't want a particular file to be touched by mack, add _NO_MACK as a substring anywhere in the comment tag.