Skip to content

v0.5.0 - UX polish, docs site, and landing page

Latest

Choose a tag to compare

@Rouzax Rouzax released this 12 Apr 12:45
· 27 commits to main since this release

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 --check subcommand 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 --workers help and clearer handling of missing / invalid inputs.
  • tracksplit.toml.example ships 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.toml gets license, readme, and [project.urls] metadata.

Fixes

  • Docs and README corrected to reflect the actual output folder layout (Artist/Festival Year (Stage)/, not Artist/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