First release with a proper project presence: a hero README, a published docs site, an animated landing page, CI, and a rounded-out CLI UX.
What's new
UX
- Pre-flight check on every run: ffmpeg / ffprobe presence is verified up front with OS-specific install hints.
- New
tracksplit --checksubcommand that probes ffmpeg, ffprobe, and mkvextract and prints their versions. - Friendly error reporting: missing tools, disk-full errors, and FFmpeg subprocess failures now surface as one-line reasons. Full tracebacks are kept behind
--debug. - Single-file runs print a final summary naming the album directory and track count.
- Expanded
--workershelp and clearer handling of missing / invalid inputs. tracksplit.toml.exampleships with the repo; README gained a Configuration section.
Docs and site
- Full MkDocs Material site at
docs/: Home, Getting Started, Usage, Configuration, Output Structure, Troubleshooting, FAQ. - Custom animated landing page at the Pages root with hero, four-card feature grid, two-row poster gallery, three-step workflow, install block, and a CrateDigger related-project card.
- README rewritten with a hero banner, badges, poster gallery (real generated covers), and a Related Projects pointer at CrateDigger.
CI / repo hygiene
- Tests workflow: pytest matrix on Python 3.11 / 3.12 / 3.13.
- Deploy Docs workflow: builds MkDocs + copies the landing page to GitHub Pages on every push to main.
- Issue templates (bug + feature) and Dependabot for pip and github-actions.
- LICENSE (GPL-3.0) added;
pyproject.tomlgetslicense,readme, and[project.urls]metadata.
Fixes
- Docs and README corrected to reflect the actual output folder layout (
Artist/Festival Year (Stage)/, notArtist/Artist @ Festival Year (Stage)/). - Help-output test made robust to Rich's line-wrapping in narrow CI terminals.
Upgrade
pip install --upgrade git+https://github.com/Rouzax/TrackSplit.git@v0.5.0
tracksplit --check