GitXplorerGitXplorer
c

mack

public
43 stars
6 forks
13 issues

Commits

List of commits on branch master.
Unverified
00324b6e3dbdb39fec7f279f8b0ba1abb91bc19c

deps: Update

ccdown committed 2 months ago
Unverified
963cbd3ecd43c3c9d01e71beb9cbce9f1bde996f

deps: Update and bump MSRV

ccdown committed 3 months ago
Unverified
8126ea80290d8d294933bc34165bf88e737e8683

deps: Update

ccdown committed 3 months ago
Unverified
12af2f7d7c6567ee7b927238e698111b1fd42518

release: 1.4.1

ccdown committed 7 months ago
Unverified
30db349c3002696a6ca5dab9fe7ee086c7527187

fixers: Fix new clippy warnings

ccdown committed 8 months ago
Unverified
8710d5bcebb4cfe0193af6ab5a4ff5da703ce304

deps: Update

ccdown committed 8 months ago

README

The README file for this repository.

mack | Tests

mack is an opinionated, fast music organiser. It enforces:

  • Directory layout
  • File name format
  • Metadata consistency (e.g., consistent "feat" tagging)
  • Format consistency (e.g., ID3 version)
  • ...and more!

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}", or another format specified with --fmt

Usage

See --help. An example invocation is:

% mack --dry-run -o Music .
01 Pyramid.mp3: renamed to Music/宇宙コンビニ/染まる音を確認したら/01 Pyramid.mp3
02 8films.mp3: renamed to Music/宇宙コンビニ/染まる音を確認したら/02 8films.mp3
03 tobira.mp3: renamed to Music/宇宙コンビニ/染まる音を確認したら/03 tobira.mp3
04 Compass.mp3: renamed to Music/宇宙コンビニ/染まる音を確認したら/04 Compass.mp3
05 strings.mp3: renamed to Music/宇宙コンビニ/染まる音を確認したら/05 strings.mp3

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

Installation

cargo install mack

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.005 seconds to run over ~3500 files under most circumstances (0.015 seconds on the very first run).

Configuration

If you don't want a particular file to be touched by mack, add _NO_MACK as a substring anywhere in the comment tag.