Helps you download music compilations from youtube
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.


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)


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


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


npm install -g youtube-ripper


youtube-ripper ""


  • 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)


  • 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
  • This project follows Readme Driven Development, and as such the README may include "Forward Looking Statements"


Licensed under the MIT License