youtube-cue/README.md

1.3 KiB

youtube-ripper

Helps you download music compilations from youtube. Will automatically download the video, split it into chunks, and apply proper id3v2 tags on all the files (including cover-art)

Dependencies

  • Asssumes that youtube-dl and ffmpeg are available in $PATH
  • Takes care of everything else

Opinions

This software has opinions:

  • You care about metadata and tagging your music properly
  • All music must have cover art embedded
  • You have youtube-dl and ffmpeg already installed
  • I am smart enough to parse youtube descriptions

Installation

npm install -g youtube-ripper

Usage

youtube-ripper "https://www.youtube.com/watch?v=41Y6xov0ppw"

Configuration

  • Pass a cue file instead of using the youtube description
  • --album-art Pass custom album art image (Uses the youtube thumbnail by default)
  • --album-artist Pass a specific Album Artist. (Picks up the artist from the video by default)
  • --genre Pass a specific genre to use. (Picks up from the video by default)

HACKING

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

License

Licensed under the MIT License