# shanty-org

Music file organization and renaming for [Shanty](ssh://connor@git.rcjohnstone.com:2222/Shanty/shanty.git).

Organizes music files into a clean directory structure based on metadata,
using configurable format templates. Works standalone (reading embedded tags)
or from the Shanty database.

## Usage

```sh
# Organize from a directory (standalone, reads tags from files)
shanty-org --source /music/messy --target /music/organized

# Organize all tracks in the database
shanty-org --from-db --target /music/organized

# Custom format template
shanty-org --source /music --target /music --format "{album_artist}/{album}/{disc_number}-{track_number} {title}.{ext}"

# Dry run (preview only)
shanty-org --source /music/messy --target /music/organized --dry-run -vv

# Copy instead of move
shanty-org --source /music/messy --target /music/organized --copy
```

## Default Format

```
{artist}/{album}/{track_number} - {title}.{ext}
```

Example: `Pink Floyd/The Dark Side of the Moon/03 - Time.flac`