Go to file
Nemo c4b1b42461 feat: Parse as durations IFF first timestamp is >0 2021-07-28 17:22:05 +05:30
.github [ci] Run tests on all supported node versions 2021-07-21 13:22:32 +05:30
src feat: Parse as durations IFF first timestamp is >0 2021-07-28 17:22:05 +05:30
test feat: Parse as durations IFF first timestamp is >0 2021-07-28 17:22:05 +05:30
.editorconfig Initial commit 2017-06-08 01:44:09 +05:30
.gitignore Version Bump (1.0.4) 2021-06-28 15:04:41 +05:30
.npmignore add npm ignore 2021-06-01 12:35:39 +05:30
CHANGELOG.md [dep] Dependency Updates 2021-07-21 12:08:49 +05:30
README.md [docs] Update README as per #72 2021-07-21 13:50:48 +05:30
index.js Add a --timestamps-are-durations flag 2021-07-21 13:44:47 +05:30
package-lock.json [dep] Dependency Updates 2021-07-21 12:08:49 +05:30
package.json [dep] Dependency Updates 2021-07-21 12:08:49 +05:30


youtube-cue npm Libraries.io dependency status for latest release NPM Snyk Vulnerabilities for npm package Total Dependencies

Generate CUE sheet from timestamps in youtube video description.

What is this for?

  1. If you have DJ-mix or album on YouTube that you'd like to generate a CUE sheet for.
  2. The video has timestamps in the video description.
  3. The video is publicly available on Youtube.

youtube-cue will read the video description, get the timestamps and generate a CUE sheet accordingly. It will also work if track durations are used instead of timestamps.


  1. It does not download tracks from YouTube
  2. It does not split your tracks
  3. It does not tag your tracks.

For all of the above, there are better tools available, such as youtube-dl, m4acut, mp3splt, cuetools, beets and many more. youtube-cue tries to do one thing well.


npm install -g youtube-cue


npm update -g youtube-cue


You need to pass 2 parameters, a Youtube URL and a output CUE filename. YouTube short URLs (youtu.be) are accepted. You can additionally pass a audio-file argument which is used for the FILE specified in the CUE file.

youtube-cue [--audio-file audio.m4a] <youtube_url> [output_file]

  --help, Show help
  --audio-file, Input Audio File (optional) that is written to the CUE sheet

  The default audio file is set to %VIDEOTITLE.m4a
  The default output file is set to %VIDEOTITLE.cue

  where $VIDEOTITLE is the title of the YouTube video.

--timestamps-only Do not try to parse the timestamps as track durations
--timestamps-are-durations Parse timestamps as durations

The above 2 are only needed to force behaviour in very specific edge cases, they should
not be required for most files.

  $ youtube-cue --audio-file audio.m4a "https://www.youtube.com/watch?v=THzUassmQwE"
    "T A Y L O R  S W I F T  Folklore [Full album].cue" saved
  $ youtube-cue "https://youtu.be/THzUassmQwE" folklore.cue
    folklore.cue saved

Personal Usage

I have this in my .bashrc to download, split, tag, and import albums:

function ytdl.album() {
  cd $(mktemp -d)
  youtube-dl -f "bestaudio[ext=m4a]" --output "audio.m4a" "$1"
  youtube-cue --audio-file "audio.m4a" "$1" tracks.cue
  m4acut -C tracks.cue "audio.m4a" && \
  trash audio.m4a && \
  beet import -map .


  • If it does not work on a specific video, please attach the complete output
  • Pull Requests are welcome that add support for a better parser without breaking the existing tests
  • Please add tests for any new functionality


Licensed under the MIT License