youtube-dl/readme.md

youtube-dl

Allows you to download and transcode video from supported sites. Needs ffmpeg for transcoding to work.

Supported sites

• Youtube
• Metacafe
• Dailymotion
• Google
• Photobucket
• Yahoo
• DepositFiles
• Facebook
• Sites with JW Player

Installation

$ sudo apt-get install ffmpeg # for Ubuntu
$ sudo wget --no-check-certificate https://github.com/dz0ny/youtube-dl/raw/master/youtube-dl -O /usr/local/bin/youtube-dl && sudo chmod a+x /usr/local/bin/youtube-dl

Usage

$ youtube-dl [options] url...

Options:
  -h, --help            print this help text and exit
  -v, --version         print program version and exit
  -U, --update          update this program to latest stable version
  -i, --ignore-errors   continue on download errors
  -r LIMIT, --rate-limit=LIMIT
                        download rate limit (e.g. 50k or 44.6m)
  -R RETRIES, --retries=RETRIES
                        number of retries (default is 10)
  --playlist-start=NUMBER
                        playlist video to start at (default is 1)
  --playlist-end=NUMBER
                        playlist video to end at (default is last)
  --dump-user-agent     display the current browser identification

  Authentication Options:
    -u USERNAME, --username=USERNAME
                        account username
    -p PASSWORD, --password=PASSWORD
                        account password
    -n, --netrc         use .netrc authentication data

  Video Format Options:
    -f FORMAT, --format=FORMAT
                        video format code
    --all-formats       download all available video formats
    --max-quality=FORMAT
                        highest quality format to download

  Verbosity / Simulation Options:
    -q, --quiet         activates quiet mode
    -s, --simulate      do not download video
    -g, --get-url       simulate, quiet but print URL
    -e, --get-title     simulate, quiet but print title
    --get-thumbnail     simulate, quiet but print thumbnail URL
    --get-description   simulate, quiet but print video description
    --get-filename      simulate, quiet but print output filename
    --no-progress       do not print progress bar
    --console-title     display progress in console titlebar

  Filesystem Options:
    -t, --title         use title in file name
    -l, --literal       use literal title in file name
    -A, --auto-number   number downloaded files starting from 00000
    -o TEMPLATE, --output=TEMPLATE
                        output filename template
    -a FILE, --batch-file=FILE
                        file containing URLs to download ('-' for stdin)
    -w, --no-overwrites
                        do not overwrite files
    -c, --continue      resume partially downloaded files
    --cookies=FILE      file to dump cookie jar to
    --no-part           do not use .part files
    --no-mtime          do not use the Last-modified header to set the file
                        modification time

  Transcoding Options (uses ffmpeg):
    -T FILE_TYPE, --transcode_to=FILE_TYPE
                        transcode to specific video or audio format (example:
                        mp3 mp4 mov mkv)
    --transcode_extra=ARGS
                        pass additional parameters to ffmpeg (example: -vcodec
                        libx264 -vpre slow -vpre ipod640 -b 2048k -acodec
                        libfaac -ab 96k)

License

Public domain code

Authors

• Ricardo Garcia Gonzalez
• Danny Colligan
• Benjamin Johnson
• Vasyl' Vavrychuk
• Witold Baryluk
• Paweł Paprota
• Gergely Imreh
• Janez Troha