Skip to content

Releases: Rouzax/TrackSplit

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

12 Apr 12:45
@Rouzax Rouzax
v0.5.0
92c9670

Choose a tag to compare

View all tags
v0.5.0 - UX polish, docs site, and landing page Latest
Latest

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
Assets 2
Loading

v0.1.0-alpha

11 Apr 16:48
@Rouzax Rouzax
v0.1.0-alpha
3c35f7d

Choose a tag to compare

View all tags
v0.1.0-alpha Pre-release
Pre-release

TrackSplit v0.1.0-alpha

First alpha release. Extract audio from video files with chapters into tagged music albums for Jellyfin and Lyrion.

Features

  • Six-step pipeline: probe, extract, split, tag, cover art, output
  • Codec-aware output: Opus stream-copy for lossy sources, FLAC for lossless
  • Per-track artist parsing from chapter titles (ARTIST + ALBUMARTIST)
  • CrateDigger-style cover art with accent colors, glow lines, DJ artwork
  • Artist folder covers (folder.jpg + artist.jpg) for Jellyfin and Lyrion
  • Two-tier metadata: basic (any video with chapters) or enriched (CrateDigger tags)
  • Re-run detection: skip unchanged albums
  • --format flag: auto, flac, or opus
  • Rich CLI output with status indicators and summary panels

Requirements

  • Python 3.11+
  • ffmpeg / ffprobe
  • mkvextract (optional, for MKV cover art)

Install

pip install -e .
Loading