]> gitweb @ CieloNegro.org - youtube-dl.git/commitdiff
Merge remote-tracking branch 'FiloSottille/vbr'
authorPhilipp Hagemeister <phihag@phihag.de>
Thu, 27 Sep 2012 18:18:29 +0000 (20:18 +0200)
committerPhilipp Hagemeister <phihag@phihag.de>
Thu, 27 Sep 2012 18:18:29 +0000 (20:18 +0200)
Conflicts:
youtube-dl
youtube-dl.exe

1  2 
README.md
youtube-dl.1
youtube-dl.bash-completion
youtube_dl/__init__.py

diff --cc README.md
index 05f437db91466f52e1116e5809fa10db94fa9e18,8a6742d941ec5b547c1c3084a403a6bd2853d26d..51501684b3607ac12f312bb7337177358fc1993a
+++ b/README.md
@@@ -21,6 -18,6 +21,7 @@@ which means you can modify it, redistri
      -r, --rate-limit LIMIT   download rate limit (e.g. 50k or 44.6m)
      -R, --retries RETRIES    number of retries (default is 10)
      --dump-user-agent        display the current browser identification
++    --user-agent None        specify a custom user agent
      --list-extractors        List all supported extractors and the URLs they
                               would handle
  
diff --cc youtube-dl.1
index 09bb843f445b5e0cb9e05ac0e350f81aacd8550a,0000000000000000000000000000000000000000..1220a3a578d806cb293499f572ef08db10d36d59
mode 100644,000000..100644
--- /dev/null
@@@ -1,192 -1,0 +1,194 @@@
- --audio-quality\ QUALITY\ \ ffmpeg/avconv\ audio\ bitrate\ specification,\ 128k\ by
- \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ default
 +.TH youtube-dl 1 "" 
 +.SH NAME
 +.PP
 +youtube-dl
 +.SH SYNOPSIS
 +.PP
 +\f[B]youtube-dl\f[] [OPTIONS] URL [URL...]
 +.SH DESCRIPTION
 +.PP
 +\f[B]youtube-dl\f[] is a small command-line program to download videos
 +from YouTube.com and a few more sites.
 +It requires the Python interpreter, version 2.x (x being at least 6),
 +and it is not platform specific.
 +It should work in your Unix box, in Windows or in Mac OS X.
 +It is released to the public domain, which means you can modify it,
 +redistribute it or use it however you like.
 +.SH OPTIONS
 +.IP
 +.nf
 +\f[C]
 +-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\ \ \ download\ rate\ limit\ (e.g.\ 50k\ or\ 44.6m)
 +-R,\ --retries\ RETRIES\ \ \ \ number\ of\ retries\ (default\ is\ 10)
 +--dump-user-agent\ \ \ \ \ \ \ \ display\ the\ current\ browser\ identification
++--user-agent\ None\ \ \ \ \ \ \ \ specify\ a\ custom\ user\ agent
 +--list-extractors\ \ \ \ \ \ \ \ List\ all\ supported\ extractors\ and\ the\ URLs\ they
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ would\ handle
 +\f[]
 +.fi
 +.SS Video Selection:
 +.IP
 +.nf
 +\f[C]
 +--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
 +\f[]
 +.fi
 +.SS Filesystem Options:
 +.IP
 +.nf
 +\f[C]
 +-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,\ --output\ TEMPLATE\ \ \ \ output\ filename\ template.\ Use\ %(stitle)s\ to\ get\ the
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ title,\ %(uploader)s\ for\ the\ uploader\ name,
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ %(autonumber)s\ to\ get\ an\ automatically\ incremented
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ number,\ %(ext)s\ for\ the\ filename\ extension,
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ %(upload_date)s\ for\ the\ upload\ date\ (YYYYMMDD),\ and
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ %%\ for\ a\ literal\ percent.\ Use\ -\ to\ output\ to
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ stdout.
 +-a,\ --batch-file\ FILE\ \ \ \ file\ containing\ URLs\ to\ download\ (\[aq]-\[aq]\ 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
 +\f[]
 +.fi
 +.SS Verbosity / Simulation Options:
 +.IP
 +.nf
 +\f[C]
 +-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-thumbnail\ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ thumbnail\ URL
 +--get-description\ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ video\ description
 +--get-filename\ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ output\ filename
 +--get-format\ \ \ \ \ \ \ \ \ \ \ \ \ simulate,\ quiet\ but\ print\ output\ format
 +--no-progress\ \ \ \ \ \ \ \ \ \ \ \ do\ not\ print\ progress\ bar
 +--console-title\ \ \ \ \ \ \ \ \ \ display\ progress\ in\ console\ titlebar
 +-v,\ --verbose\ \ \ \ \ \ \ \ \ \ \ \ print\ various\ debugging\ information
 +\f[]
 +.fi
 +.SS Video Format Options:
 +.IP
 +.nf
 +\f[C]
 +-f,\ --format\ FORMAT\ \ \ \ \ \ video\ format\ code
 +--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-srt\ \ \ \ \ \ \ \ \ \ \ \ \ \ write\ video\ closed\ captions\ to\ a\ .srt\ file
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (currently\ youtube\ only)
 +--srt-lang\ LANG\ \ \ \ \ \ \ \ \ \ language\ of\ the\ closed\ captions\ to\ download
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (optional)\ use\ IETF\ language\ tags\ like\ \[aq]en\[aq]
 +\f[]
 +.fi
 +.SS Authentication Options:
 +.IP
 +.nf
 +\f[C]
 +-u,\ --username\ USERNAME\ \ account\ username
 +-p,\ --password\ PASSWORD\ \ account\ password
 +-n,\ --netrc\ \ \ \ \ \ \ \ \ \ \ \ \ \ use\ .netrc\ authentication\ data
 +\f[]
 +.fi
 +.SS Post-processing Options:
 +.IP
 +.nf
 +\f[C]
 +--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",\ 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)
 +-k,\ --keep-video\ \ \ \ \ \ \ \ \ keeps\ the\ video\ file\ on\ disk\ after\ the\ post-
 +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ processing;\ the\ video\ is\ erased\ by\ default
 +\f[]
 +.fi
 +.SH FAQ
 +.SS Can you please put the -b option back?
 +.PP
 +Most people asking this question are not aware that youtube-dl now
 +defaults to downloading the highest available quality as reported by
 +YouTube, which will be 1080p or 720p in some cases, so you no longer
 +need the -b option.
 +For some specific videos, maybe YouTube does not report them to be
 +available in a specific high quality format you\[aq]\[aq]re interested
 +in.
 +In that case, simply request it with the -f option and youtube-dl will
 +try to download it.
 +.SS I get HTTP error 402 when trying to download a video. What\[aq]s
 +this?
 +.PP
 +Apparently YouTube requires you to pass a CAPTCHA test if you download
 +too much.
 +We\[aq]\[aq]re considering to provide a way to let you solve the
 +CAPTCHA (https://github.com/rg3/youtube-dl/issues/154), but at the
 +moment, your best course of action is pointing a webbrowser to the
 +youtube URL, solving the CAPTCHA, and restart youtube-dl.
 +.SS I have downloaded a video but how can I play it?
 +.PP
 +Once the video is fully downloaded, use any video player, such as
 +vlc (http://www.videolan.org) or mplayer (http://www.mplayerhq.hu/).
 +.SS The links provided by youtube-dl -g are not working anymore
 +.PP
 +The URLs youtube-dl outputs require the downloader to have the correct
 +cookies.
 +Use the \f[C]--cookies\f[] option to write the required cookies into a
 +file, and advise your downloader to read cookies from that file.
 +Some sites also require a common user agent to be used, use
 +\f[C]--dump-user-agent\f[] to see the one in use by youtube-dl.
 +.SS ERROR: no fmt_url_map or conn information found in video info
 +.PP
 +youtube has switched to a new video info format in July 2011 which is
 +not supported by old versions of youtube-dl.
 +You can update youtube-dl with \f[C]sudo\ youtube-dl\ --update\f[].
 +.SH COPYRIGHT
 +.PP
 +youtube-dl is released into the public domain by the copyright holders.
 +.PP
 +This README file was originally written by Daniel Bolton
 +(<https://github.com/dbbolton>) and is likewise released into the public
 +domain.
 +.SH BUGS
 +.PP
 +Bugs and suggestions should be reported at:
 +<https://github.com/rg3/youtube-dl/issues>
 +.PP
 +Please include:
 +.IP \[bu] 2
 +Your exact command line, like
 +\f[C]youtube-dl\ -t\ "http://www.youtube.com/watch?v=uHlDtZ6Oc3s&feature=channel_video_title"\f[].
 +A common mistake is not to escape the \f[C]&\f[].
 +Putting URLs in quotes should solve this problem.
 +.IP \[bu] 2
 +The output of \f[C]youtube-dl\ --version\f[]
 +.IP \[bu] 2
 +The output of \f[C]python\ --version\f[]
 +.IP \[bu] 2
 +The name and version of your Operating System ("Ubuntu 11.04 x64" or
 +"Windows 7 x64" is usually enough).
index 8704d0fd3aca82f16e7fb9d2d419035626f66ffe,0000000000000000000000000000000000000000..1eca2adf30cc5d5d6444e515755dce1e467bd2e3
mode 100644,000000..100644
--- /dev/null
@@@ -1,14 -1,0 +1,14 @@@
-     opts="--all-formats --audio-format --audio-quality --auto-number --batch-file --console-title --continue --cookies --dump-user-agent --extract-audio --format --get-description --get-filename --get-format --get-thumbnail --get-title --get-url --help --ignore-errors --keep-video --list-extractors --list-formats --literal --match-title --max-downloads --max-quality --netrc --no-continue --no-mtime --no-overwrites --no-part --no-progress --output --password --playlist-end --playlist-start --prefer-free-formats --quiet --rate-limit --reject-title --retries --simulate --skip-download --srt-lang --title --update --username --verbose --version --write-description --write-info-json --write-srt"
 +__youtube-dl()
 +{
 +    local cur prev opts
 +    COMPREPLY=()
 +    cur="${COMP_WORDS[COMP_CWORD]}"
++    opts="--all-formats --audio-format --audio-quality --auto-number --batch-file --console-title --continue --cookies --dump-user-agent --extract-audio --format --get-description --get-filename --get-format --get-thumbnail --get-title --get-url --help --ignore-errors --keep-video --list-extractors --list-formats --literal --match-title --max-downloads --max-quality --netrc --no-continue --no-mtime --no-overwrites --no-part --no-progress --output --password --playlist-end --playlist-start --prefer-free-formats --quiet --rate-limit --reject-title --retries --simulate --skip-download --srt-lang --title --update --user-agent --username --verbose --version --write-description --write-info-json --write-srt"
 +
 +    if [[ ${cur} == * ]] ; then
 +        COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
 +        return 0
 +    fi
 +}
 +
 +complete -F __youtube-dl youtube-dl
Simple merge