cueshit

Convert between different cue sheet / chapter / tracklist formats.

Usage

Install the command line app (once Deno is set up on your computer):

deno install --allow-read --allow-write https://deno.land/x/cueshit/cli.ts

Display the integrated help to learn how to use the CLI:

cueshit --help

The basic command to convert from one format to another looks as follows:

cueshit [input-path] --from <format> --to <format>

See the sections below for examples and an overview of the supported formats.

Note

Currently the input (--from or -f) and output (--to or -t) format options are mandatory for conversion. Future versions of the CLI might be able to automatically detect input and output format based on file extensions and/or content.

Examples

Convert chapters from a YouTube description into a MusicBrainz track parser listing. Input is read from standard input (via cat), output is written to standard output (by default):

$ cat << --- | cueshit --from youtube --to musicbrainz
Lines which do not start with a timestamp will be skipped.
0:00 Test Title
2:56 Another Title
4:17 Final Title
---
1. Test Title (2:56)
2. Another Title (1:21)
3. Final Title (?:??)

Extract chapters from a FLAC audio file using ffprobe and store them as a cue sheet (test.cue):

ffprobe -v error -of json -show_format -show_streams -show_chapters test.flac | cueshit -f ffprobe -t cue -o test.cue

Create a cue sheet from an Audacity label track (labels.txt) which belongs to the audio from test.wav. Since the input format only contains chapters and does not know about the audio file, it has to be specified manually:

cueshit -f audacity labels.txt -t cue -o test.cue --sheet.media-file test.wav

Additional cue sheet properties can be specified via the --sheet.title and --sheet.performer options.

Supported Formats

Not all formats are supported as both input and output format (currently).

ID           Name                                             Input  Output
-----------  -----------------------------------------------  -----  ------
audacity     Audacity Label Track (TSV)                         X      X
cue          Cue Sheet                                                 X
ffprobe      ffprobe Metadata with Chapters (JSON)              X
losslesscut  LosslessCut Segments (CSV)                         X      X
musicbrainz  MusicBrainz Track Parser Listing                   X      X
ogm          OGM Tools Chapters / MKVToolNix Simple Chapters           X
youtube      Youtube Description with Chapters                  X      X

List all formats which are currently available for the CLI:

cueshit formats