Sign upSign up Sign inSign in

Files Commits Branches

rg3 / youtube-dl

PUBL

IC Co deCo de Net wo rkNet wo rk Pull Request s Pull Request s Issues Issues GraphsGraphs 1010 19 119 1

Re ad-Only access

Small command- line program to download videos from YouTube.com and other video sites Read moreht tp://rg3.github.io/youtube-dl/

ZIPZIP SSHSSH Git Re ad-OnlyG it Re ad-Only https://github.com/rg3/youtube-dl.git

Tags 109 mastermaster 5

1000+ commits

latest commit 951b9dfd94

Merge pull request # 866 from yasoob/master

Filo So t t ile authored 2 days ago

bin 6 months ago adding the script hook [gcmalloc]

devscripts 2 months ago Change rg3.github.com to rg3.github.io almost everywhere [rg3]

test 2 days ago Merge pull request #866 from yasoob/master [FiloSottile]

youtube_dl 2 days ago Merge pull request #866 from yasoob/master [FiloSottile]

.gitignore 3 months ago forgot to fix this. [JohnyMoSwag]

.travis.yml 2 months ago Add myself to travis notifications [jaimeMF]

CHANGELOG 5 months ago release 2013.01.02 [FiloSottile]

LATEST_VERSION 5 months ago Less confusing player version [phihag]

youtube-dl /

HTTPHTTP

1,808 4 10

Search or type a commandThis re positoryThis re pository

PDFmyURL.com

LICENSE 5 months ago addedd a serious Public Domain dedication, see http://unlicense.org/ [FiloSottile]

MANIFEST.in 4 months ago include bash completion and manpage in PyPi dist [phihag]

Makefile a month ago only install to /etc if PREFIX is /usr or /usr/local [chocolateboy]

README.md 24 days ago release 2013.05.13 [phihag]

setup.py 4 months ago Try setuptools first, then fallback to distutils.core [dcoppa]

youtube-dl 2 months ago Change rg3.github.com to rg3.github.io almost everywhere [rg3]

youtube-dl.exe 5 months ago The new updates system, relies on gh-pages, secured by RSA, uses exte [FiloSottile]

README.md README.md

% YOUTUBE-DL(1)

youtube-dl

youtube-dl [OPTIONS] URL [URL...]

NAME

SYNOPSIS

PDFmyURL.com

youtube-dl is a small command-line program to download videos f rom YouTube.com and a few more sites. It requires thePython interpreter, version 2.6, 2.7, or 3.3+, and it is not plat form specif ic. It should work on your Unix box, on Windows oron Mac OS X. It is released to the public domain, which means you can modify it , redist ribute it or use it however you like.

-h, --help print this help text and exit--version print program version and exit-U, --update update this program to latest version-i, --ignore-errors continue on download errors-r, --rate-limit LIMIT maximum download rate (e.g. 50k or 44.6m)-R, --retries RETRIES number of retries (default is 10)--buffer-size SIZE size of download buffer (e.g. 1024 or 16k) (default is 1024)--no-resize-buffer do not automatically adjust the buffer size. By default, the buffer size is automatically resized from an initial value of SIZE.--dump-user-agent display the current browser identification--user-agent UA specify a custom user agent--referer REF specify a custom referer, use if the video access is restricted to one domain--list-extractors List all supported extractors and the URLs they would handle--proxy URL Use the specified HTTP/HTTPS proxy--no-check-certificate Suppress HTTPS certificate validation.

DESCRIPTION

OPTIONS

PDFmyURL.com

--playlist-start NUMBER playlist video to start at (default is 1)--playlist-end NUMBER playlist video to end at (default is last)--match-title REGEX download only matching titles (regex or caseless sub-string)--reject-title REGEX skip download for matching titles (regex or caseless sub-string)--max-downloads NUMBER Abort after downloading NUMBER files--min-filesize SIZE Do not download any videos smaller than SIZE (e.g. 50k or 44.6m)--max-filesize SIZE Do not download any videos larger than SIZE (e.g. 50k or 44.6m)--date DATE download only videos uploaded in this date--datebefore DATE download only videos uploaded before this date--dateafter DATE download only videos uploaded after this date

-t, --title use title in file name (default)--id use only video ID in file name-l, --literal [deprecated] alias of --title-A, --auto-number number downloaded files starting from 00000-o, --output TEMPLATE output filename template. Use %(title)s to get the title, %(uploader)s for the uploader name, %(uploader_id)s for the uploader nickname if different, %(autonumber)s to get an automatically incremented number, %(ext)s for the filename extension, %(upload_date)s for the upload date (YYYYMMDD), %(extractor)s for the provider (youtube, metacafe, etc), %(id)s for the video id , %(playlist)s for the playlist the video is in,

Video Selection:

Filesystem Options:

PDFmyURL.com

%(playlist_index)s for the position in the playlist and %% for a literal percent. Use - to output to stdout. Can also be used to download to a different directory, for example with -o '/my/d ownloads/%(uploader)s/%(title)s-%(id)s.%(ext)s' .--autonumber-size NUMBER Specifies the number of digits in %(autonumber)s when it is present in output filename template or --autonumber option is given--restrict-filenames Restrict filenames to only ASCII characters, and avoid "&" and spaces in filenames-a, --batch-file FILE file containing URLs to download ('-' for stdin)-w, --no-overwrites do not overwrite files-c, --continue resume partially downloaded files--no-continue do not resume partially downloaded files (restart from beginning)--cookies FILE file to read cookies from and dump cookie jar in--no-part do not use .part files--no-mtime do not use the Last-modified header to set the file modification time--write-description write video description to a .description file--write-info-json write video metadata to a .info.json file--write-thumbnail write thumbnail image to disk

-q, --quiet activates quiet mode-s, --simulate do not download the video and do not write anything to disk--skip-download do not download the video-g, --get-url simulate, quiet but print URL-e, --get-title simulate, quiet but print title--get-id simulate, quiet but print id--get-thumbnail simulate, quiet but print thumbnail URL--get-description simulate, quiet but print video description

Verbosity / Simulation Options:

PDFmyURL.com

--get-filename simulate, quiet but print output filename--get-format simulate, quiet but print output format--newline output progress bar as new lines--no-progress do not print progress bar--console-title display progress in console titlebar-v, --verbose print various debugging information--dump-intermediate-pages print downloaded pages to debug problems(very verbose)

-f, --format FORMAT video format code, specifiy the order of preference using slashes: "-f 22/17/18"--all-formats download all available video formats--prefer-free-formats prefer free video formats unless a specific one is requested--max-quality FORMAT highest quality format to download-F, --list-formats list all available formats (currently youtube only)--write-sub write subtitle file (currently youtube only)--only-sub [deprecated] alias of --skip-download--all-subs downloads all the available subtitles of the video (currently youtube only)--list-subs lists all available subtitles for the video (currently youtube only)--sub-format LANG subtitle format [srt/sbv] (default=srt) (currently youtube only)--sub-lang LANG language of the subtitles to download (optional) use IETF language tags like 'en'

Video Format Options:

Authentication Options: PDFmyURL.com

-u, --username USERNAME account username-p, --password PASSWORD account password-n, --netrc use .netrc authentication data

-x, --extract-audio convert video files to audio-only files (requires ffmpeg or avconv and ffprobe or avprobe)--audio-format FORMAT "best", "aac", "vorbis", "mp3", "m4a", "opus", or "wav"; best by default--audio-quality QUALITY ffmpeg/avconv audio quality specification, insert a value between 0 (better) and 9 (worse) for VBR or a specific bitrate like 128K (default 5)--recode-video FORMAT Encode the video to another format if necessary (currently supported: mp4|flv|ogg|webm)-k, --keep-video keeps the video file on disk after the post- processing; the video is erased by default--no-post-overwrites do not overwrite post-processed files; the post- processed files are overwritten by default

You can conf igure youtube-dl by placing default arguments (such as --extract-audio --no-mtime to always ext ract theaudio and not copy the mt ime) into /etc/youtube-dl.conf and/or ~/.config/youtube-dl.conf .

Post-processing Options:

CONFIGURATION

OUTPUT TEMPLATE PDFmyURL.com

The -o opt ion allows users to indicate a template for the output f ile names. The basic usage is not to set any templatearguments when downloading a single f ile, like in youtube-dl -o funny_video.flv "http://some/video" . However, it maycontain special sequences that will be replaced when downloading each video. The special sequences have the format%(NAME)s . To clarif y, that is a percent symbol followed by a name in parenthesis, followed by a lowercase S. Allowed

names are:

id : The sequence will be replaced by the video ident if ier.url : The sequence will be replaced by the video URL.uploader : The sequence will be replaced by the nickname of the person who uploaded the video.upload_date : The sequence will be replaced by the upload date in YYYYMMDD format .title : The sequence will be replaced by the video t it le.ext : The sequence will be replaced by the appropriate extension (like f lv or mp4).epoch : The sequence will be replaced by the Unix epoch when creat ing the f ile.autonumber : The sequence will be replaced by a f ive-digit number that will be increased with each download, start ing

at zero.playlist : The name or the id of the playlist that contains the video.playlist_index : The index of the video in the playlist , a f ive-digit number.

The current default template is %(id)s.%(ext)s , but that will be switchted to %(title)s-%(id)s.%(ext)s (which can berequested with -t at the moment ).

In some cases, you don't want special characters such as , spaces, or &, such as when t ransferring the downloadedf ilename to a Windows system or the f ilename through an 8bit -unsafe channel. In these cases, add the--restrict-filenames f lag to get a shorter t it le:

$ youtube-dl --get-filename -o "%(title)s.%(ext)s" BaW_jenozKcyoutube-dl test video ''_..mp4 # All kinds of weird character$ youtube-dl --get-filename -o "%(title)s.%(ext)s" BaW_jenozKc --restrict-filenamesyoutube-dl_test_video_.mp4 # A simple file name

PDFmyURL.com

Videos can be f ilt ered by their upload date using the opt ions --date , --datebefore or --dateafter , they accept datesin two formats:

Absolute dates: Dates in the format YYYYMMDD .Relat ive dates: Dates in the format (now|today)[+-][0-9](day|week|month|year)(s)?

Examples:

$ youtube-dl --dateafter now-6months #will only download the videos uploaded in the last 6 months$ youtube-dl --date 19700101 #will only download the videos uploaded in January 1, 1970$ youtube-dl --dateafter 20000101 --datebefore 20100101 #will only download the videos uploaded between 2000 and 2010

Most people asking this quest ion are not aware that youtube-dl now default s to downloading the highest available qualit yas reported by YouTube, which will be 1080p or 720p in some cases, so you no longer need the -b opt ion. For somespecif ic videos, maybe YouTube does not report them to be available in a specif ic high qualit y format you''re interested in.In that case, simply request it with the -f opt ion and youtube-dl will t ry to download it .

VIDEO SELECTION

FAQCan you please put the -b option back?

I get HTTP error 402 when trying to download a video. What's this? PDFmyURL.com

Apparent ly YouTube requires you to pass a CAPTCHA test if you download too much. We''re considering to provide a wayto let you solve the CAPTCHA, but at the moment , your best course of act ion is point ing a webbrowser to the youtubeURL, solving the CAPTCHA, and restart youtube-dl.

Once the video is fully downloaded, use any video player, such as vlc or mplayer.

The URLs youtube-dl outputs require the downloader to have the correct cookies. Use the --cookies opt ion to write therequired cookies into a f ile, and advise your downloader to read cookies f rom that f ile. Some sites also require a commonuser agent to be used, use --dump-user-agent to see the one in use by youtube-dl.

youtube has switched to a new video info format in July 2011 which is not supported by old versions of youtube-dl. You canupdate youtube-dl with sudo youtube-dl --update .

youtube requires an addit ional signature since September 2012 which is not supported by old versions of youtube-dl. Youcan update youtube-dl with sudo youtube-dl --update .

The error

I have downloaded a video but how can I play it?

The links provided by youtube-dl -g are not working anymore

ERROR: no fmt_url_map or conn information found in video info

ERROR: unable to download video

SyntaxError: Non-ASCII character

PDFmyURL.com

File "youtube-dl", line 2SyntaxError: Non-ASCII character '\x93' ...

means you're using an outdated version of Python. Please update to Python 2.6 or 2.7.

Since June 2012 (#342) youtube-dl is packed as an executable zipf ile, simply unzip it (might need renaming toyoutube-dl.zip f irst on some systems) or clone the git repository, as laid out above. If you modify the code, you can run it

by execut ing the __main__.py f ile. To recompile the executable, run make youtube-dl .

To run the exe you need to install f irst the Microsof t Visual C++ 2008 Redist ributable Package.

youtube-dl is released into the public domain by the copyright holders.

This README f ile was originally writ ten by Daniel Bolton (ht tps://github.com/dbbolton) and is likewise released into thepublic domain.

Bugs and suggest ions should be reported at : ht tps://github.com/rg3/youtube-dl/issues

What is this binary file? Where has the code gone?

The exe throws a Runtime error from Visual C++

COPYRIGHT

BUGS PDFmyURL.com

Please include:

Your exact command line, likeyoutube-dl -t "http://www.youtube.com/watch?v=uHlDtZ6Oc3s&feature=channel_video_title" . A common mistake is not to

escape the & . Put t ing URLs in quotes should solve this problem.If possible re-run the command with --verbose , and include the full output , it is really helpful to us.The output of youtube-dl --versionThe output of python --versionThe name and version of your Operat ing System ("Ubuntu 11.04 x64" or "Windows 7 x64" is usually enough).

For discussions, join us in the irc channel #youtube-dl on f reenode.

Git HubGit HubAbout usAbout usBlogBlogContact & supportContact & supportGitHub EnterpriseGitHub EnterpriseSite statusSite status

Applicat io nsApplicat io nsGitHub for MacGitHub for MacGitHub for WindowsGitHub for WindowsGitHub for EclipseGitHub for EclipseGitHub mobile appsGitHub mobile apps

ServicesServicesGauges: Web analyticsGauges: Web analyticsSpeaker Deck: PresentationsSpeaker Deck: PresentationsGist: Code snippetsGist: Code snippetsJob boardJob board

Do cument at io nDo cument at io nGitHub HelpGitHub HelpDeveloper APIDeveloper APIGitHub Flavored MarkdownGitHub Flavored MarkdownGitHub PagesGitHub Pages

Mo reMo reTrainingTrainingStudents & teachersStudents & teachersThe ShopThe ShopPlans & pricingPlans & pricingThe OctodexThe Octodex

2013 2013 GitHubGitHub, Inc. All rights reserved., Inc. All rights reserved.Terms o f ServiceTerms o f Service PrivacyPrivacy SecuritySecurity

PDFmyURL.com