Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

About

An opinionated, fast music organiser.

Resources

License

Packages

No packages published

Languages

You can’t perform that action at this time.