TrackSplit

Chapter-based audio extractor for music servers

Turn your chaptered video library into gapless, tagged FLAC or Opus albums ready for Jellyfin and Lyrion.

Get Started View on GitHub

What it does

Chapters in, albums out

Sample-accurate splitting

Cut at chapter boundaries down to the sample. Gapless playback across every track, no clicks, no duplicated audio.

Codec-aware output

FLAC stays lossless. Opus stream-copies when safe, re-encodes transparently when not. Override with --format.

Rich metadata & art

Writes full Vorbis comments plus festival, stage, and venue. Embeds 1:1 cover art and generates an artist folder image.

Re-run detection

A per-album manifest tracks chapter hashes and source mtime. Re-runs on an unchanged library finish in milliseconds.

Generated artwork

Covers that match the set

TrackSplit composes two kinds of art from the source: album covers embedded in every track, and artist folder images your music server uses for artist pages.

Album Covers

Artist Covers

Three steps

From video chapters to a tagged album

Install & check

Install the CLI, then confirm that ffmpeg and ffprobe are reachable.

pip install -e . && tracksplit --check

Point at a video or folder

One file or a whole directory. Parallel workers spread the load.

tracksplit ~/videos/ --output ~/music/library/

Enjoy the library

Tagged FLAC or Opus albums, embedded covers, artist folder images. Re-runs skip unchanged sets instantly.

tracksplit ~/videos/ --format opus --workers 4

Get started

Up and running in minutes

Prerequisites

Python 3.11 or newer
FFmpeg (ships ffmpeg and ffprobe)
MKVToolNix (optional, MKV cover extraction)

Install

Terminal

pip install git+https://github.com/Rouzax/TrackSplit.git

Then verify the toolchain is reachable: