Metadata-Version: 2.4
Name: setlist-organiser
Version: 0.2.0
Summary: CLI tool for musical directors to classify and organise audio stem exports by instrument category.
Author-email: Alex Hollingsworth <alex@hsoundworks.co.uk>
License: MIT
Project-URL: Homepage, https://github.com/alex-hollingsworth1/setlist_and_stem_organiser
Project-URL: Issues, https://github.com/alex-hollingsworth1/setlist_and_stem_organiser/issues
Keywords: audio,music,stems,ableton,playback,musical-director,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: flask>=3.0.0
Requires-Dist: lxml>=5.0.0
Dynamic: license-file

# Setlist Organiser

[![PyPI](https://img.shields.io/pypi/v/setlist-organiser)](https://pypi.org/project/setlist-organiser/)
[![Python](https://img.shields.io/pypi/pyversions/setlist-organiser)](https://pypi.org/project/setlist-organiser/)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

CLI tool for classifying audio stem filenames into categories and organising them into folder structure via copy or move operations.

## What it does

- Scans a source folder for audio files
- Classifies each file by filename keywords (e.g. `DRUMS`, `BASS`, `VOX`)
- Copies or moves files to `OUTPUT_ROOT/<CATEGORY>/...`
- Supports dry-run, recursive scan, custom keyword config, and interactive review for `OTHER` files

## Requirements

- Python `>=3.11`

## Install

Install from PyPI:

```bash
pip install setlist-organiser
```

Or install from source:

```bash
git clone https://github.com/alex-hollingsworth1/setlist_and_stem_organiser.git
cd setlist_and_stem_organiser
python -m venv .venv
source .venv/bin/activate
pip install -e .
```

This exposes the command:

```bash
setlist-organiser --help
```
