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