API tools faq
paste
Advertisement
Guest User

Untitled

a guest
Jan 30th, 2015
231
0
Never
Add comment
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 20.02 KB | None | 0 0
raw download clone embed print report
  1. Usage: youtube-dl [OPTIONS] URL [URL...]
  2.  
  3. Options:
  4. General Options:
  5. -h, --help print this help text and exit
  6. --version print program version and exit
  7. -U, --update update this program to latest version. Make
  8. sure that you have sufficient permissions
  9. (run with sudo if needed)
  10. -i, --ignore-errors continue on download errors, for example to
  11. skip unavailable videos in a playlist
  12. --abort-on-error Abort downloading of further videos (in the
  13. playlist or the command line) if an error
  14. occurs
  15. --dump-user-agent display the current browser identification
  16. --list-extractors List all supported extractors and the URLs
  17. they would handle
  18. --extractor-descriptions Output descriptions of all supported
  19. extractors
  20. --default-search PREFIX Use this prefix for unqualified URLs. For
  21. example "gvsearch2:" downloads two videos
  22. from google videos for youtube-dl "large
  23. apple". Use the value "auto" to let
  24. youtube-dl guess ("auto_warning" to emit a
  25. warning when guessing). "error" just throws
  26. an error. The default value "fixup_error"
  27. repairs broken URLs, but emits an error if
  28. this is not possible instead of searching.
  29. --ignore-config Do not read configuration files. When given
  30. in the global configuration file /etc
  31. /youtube-dl.conf: Do not read the user
  32. configuration in ~/.config/youtube-
  33. dl/config (%APPDATA%/youtube-dl/config.txt
  34. on Windows)
  35. --flat-playlist Do not extract the videos of a playlist,
  36. only list them.
  37.  
  38. Network Options:
  39. --proxy URL Use the specified HTTP/HTTPS proxy. Pass in
  40. an empty string (--proxy "") for direct
  41. connection
  42. --socket-timeout SECONDS Time to wait before giving up, in seconds
  43. --source-address IP Client-side IP address to bind to
  44. (experimental)
  45. -4, --force-ipv4 Make all connections via IPv4
  46. (experimental)
  47. -6, --force-ipv6 Make all connections via IPv6
  48. (experimental)
  49.  
  50. Video Selection:
  51. --playlist-start NUMBER playlist video to start at (default is 1)
  52. --playlist-end NUMBER playlist video to end at (default is last)
  53. --match-title REGEX download only matching titles (regex or
  54. caseless sub-string)
  55. --reject-title REGEX skip download for matching titles (regex or
  56. caseless sub-string)
  57. --max-downloads NUMBER Abort after downloading NUMBER files
  58. --min-filesize SIZE Do not download any videos smaller than
  59. SIZE (e.g. 50k or 44.6m)
  60. --max-filesize SIZE Do not download any videos larger than SIZE
  61. (e.g. 50k or 44.6m)
  62. --date DATE download only videos uploaded in this date
  63. --datebefore DATE download only videos uploaded on or before
  64. this date (i.e. inclusive)
  65. --dateafter DATE download only videos uploaded on or after
  66. this date (i.e. inclusive)
  67. --min-views COUNT Do not download any videos with less than
  68. COUNT views
  69. --max-views COUNT Do not download any videos with more than
  70. COUNT views
  71. --no-playlist If the URL refers to a video and a
  72. playlist, download only the video.
  73. --age-limit YEARS download only videos suitable for the given
  74. age
  75. --download-archive FILE Download only videos not listed in the
  76. archive file. Record the IDs of all
  77. downloaded videos in it.
  78. --include-ads Download advertisements as well
  79. (experimental)
  80.  
  81. Download Options:
  82. -r, --rate-limit LIMIT maximum download rate in bytes per second
  83. (e.g. 50K or 4.2M)
  84. -R, --retries RETRIES number of retries (default is 10)
  85. --buffer-size SIZE size of download buffer (e.g. 1024 or 16K)
  86. (default is 1024)
  87. --no-resize-buffer do not automatically adjust the buffer
  88. size. By default, the buffer size is
  89. automatically resized from an initial value
  90. of SIZE.
  91. --playlist-reverse Download playlist videos in reverse order
  92.  
  93. Filesystem Options:
  94. -a, --batch-file FILE file containing URLs to download ('-' for
  95. stdin)
  96. --id use only video ID in file name
  97. -o, --output TEMPLATE output filename template. Use %(title)s to
  98. get the title, %(uploader)s for the
  99. uploader name, %(uploader_id)s for the
  100. uploader nickname if different,
  101. %(autonumber)s to get an automatically
  102. incremented number, %(ext)s for the
  103. filename extension, %(format)s for the
  104. format description (like "22 - 1280x720" or
  105. "HD"), %(format_id)s for the unique id of
  106. the format (like Youtube's itags: "137"),
  107. %(upload_date)s for the upload date
  108. (YYYYMMDD), %(extractor)s for the provider
  109. (youtube, metacafe, etc), %(id)s for the
  110. video id, %(playlist_title)s,
  111. %(playlist_id)s, or %(playlist)s (=title if
  112. present, ID otherwise) for the playlist the
  113. video is in, %(playlist_index)s for the
  114. position in the playlist. %(height)s and
  115. %(width)s for the width and height of the
  116. video format. %(resolution)s for a textual
  117. description of the resolution of the video
  118. format. %% for a literal percent. Use - to
  119. output to stdout. Can also be used to
  120. download to a different directory, for
  121. example with -o '/my/downloads/%(uploader)s
  122. /%(title)s-%(id)s.%(ext)s' .
  123. --autonumber-size NUMBER Specifies the number of digits in
  124. %(autonumber)s when it is present in output
  125. filename template or --auto-number option
  126. is given
  127. --restrict-filenames Restrict filenames to only ASCII
  128. characters, and avoid "&" and spaces in
  129. filenames
  130. -A, --auto-number [deprecated; use -o
  131. "%(autonumber)s-%(title)s.%(ext)s" ] number
  132. downloaded files starting from 00000
  133. -t, --title [deprecated] use title in file name
  134. (default)
  135. -l, --literal [deprecated] alias of --title
  136. -w, --no-overwrites do not overwrite files
  137. -c, --continue force resume of partially downloaded files.
  138. By default, youtube-dl will resume
  139. downloads if possible.
  140. --no-continue do not resume partially downloaded files
  141. (restart from beginning)
  142. --no-part do not use .part files - write directly
  143. into output file
  144. --no-mtime do not use the Last-modified header to set
  145. the file modification time
  146. --write-description write video description to a .description
  147. file
  148. --write-info-json write video metadata to a .info.json file
  149. --write-annotations write video annotations to a .annotation
  150. file
  151. --write-thumbnail write thumbnail image to disk
  152. --load-info FILE json file containing the video information
  153. (created with the "--write-json" option)
  154. --cookies FILE file to read cookies from and dump cookie
  155. jar in
  156. --cache-dir DIR Location in the filesystem where youtube-dl
  157. can store some downloaded information
  158. permanently. By default $XDG_CACHE_HOME
  159. /youtube-dl or ~/.cache/youtube-dl . At the
  160. moment, only YouTube player files (for
  161. videos with obfuscated signatures) are
  162. cached, but that may change.
  163. --no-cache-dir Disable filesystem caching
  164. --rm-cache-dir Delete all filesystem cache files
  165.  
  166. Verbosity / Simulation Options:
  167. -q, --quiet activates quiet mode
  168. --no-warnings Ignore warnings
  169. -s, --simulate do not download the video and do not write
  170. anything to disk
  171. --skip-download do not download the video
  172. -g, --get-url simulate, quiet but print URL
  173. -e, --get-title simulate, quiet but print title
  174. --get-id simulate, quiet but print id
  175. --get-thumbnail simulate, quiet but print thumbnail URL
  176. --get-description simulate, quiet but print video description
  177. --get-duration simulate, quiet but print video length
  178. --get-filename simulate, quiet but print output filename
  179. --get-format simulate, quiet but print output format
  180. -j, --dump-json simulate, quiet but print JSON information.
  181. See --output for a description of available
  182. keys.
  183. -J, --dump-single-json simulate, quiet but print JSON information
  184. for each command-line argument. If the URL
  185. refers to a playlist, dump the whole
  186. playlist information in a single line.
  187. --print-json Be quiet and print the video information as
  188. JSON (video is still being downloaded).
  189. --newline output progress bar as new lines
  190. --no-progress do not print progress bar
  191. --console-title display progress in console titlebar
  192. -v, --verbose print various debugging information
  193. --dump-intermediate-pages print downloaded pages to debug problems
  194. (very verbose)
  195. --write-pages Write downloaded intermediary pages to
  196. files in the current directory to debug
  197. problems
  198. --print-traffic Display sent and read HTTP traffic
  199. -C, --call-home Contact the youtube-dl server for
  200. debugging.
  201. --no-call-home Do NOT contact the youtube-dl server for
  202. debugging.
  203.  
  204. Workarounds:
  205. --encoding ENCODING Force the specified encoding (experimental)
  206. --no-check-certificate Suppress HTTPS certificate validation.
  207. --prefer-insecure Use an unencrypted connection to retrieve
  208. information about the video. (Currently
  209. supported only for YouTube)
  210. --user-agent UA specify a custom user agent
  211. --referer URL specify a custom referer, use if the video
  212. access is restricted to one domain
  213. --add-header FIELD:VALUE specify a custom HTTP header and its value,
  214. separated by a colon ':'. You can use this
  215. option multiple times
  216. --bidi-workaround Work around terminals that lack
  217. bidirectional text support. Requires bidiv
  218. or fribidi executable in PATH
  219.  
  220. Video Format Options:
  221. -f, --format FORMAT video format code, specify the order of
  222. preference using slashes, as in -f 22/17/18
  223. . Instead of format codes, you can select
  224. by extension for the extensions aac, m4a,
  225. mp3, mp4, ogg, wav, webm. You can also use
  226. the special names "best", "bestvideo",
  227. "bestaudio", "worst". By default, youtube-
  228. dl will pick the best quality. Use commas
  229. to download multiple audio formats, such as
  230. -f
  231. 136/137/mp4/bestvideo,140/m4a/bestaudio.
  232. You can merge the video and audio of two
  233. formats into a single file using -f <video-
  234. format>+<audio-format> (requires ffmpeg or
  235. avconv), for example -f
  236. bestvideo+bestaudio.
  237. --all-formats download all available video formats
  238. --prefer-free-formats prefer free video formats unless a specific
  239. one is requested
  240. --max-quality FORMAT highest quality format to download
  241. -F, --list-formats list all available formats
  242. --youtube-skip-dash-manifest Do not download the DASH manifest on
  243. YouTube videos
  244. --merge-output-format FORMAT If a merge is required (e.g.
  245. bestvideo+bestaudio), output to given
  246. container format. One of mkv, mp4, ogg,
  247. webm, flv.Ignored if no merge is required
  248.  
  249. Subtitle Options:
  250. --write-sub write subtitle file
  251. --write-auto-sub write automatic subtitle file (youtube
  252. only)
  253. --all-subs downloads all the available subtitles of
  254. the video
  255. --list-subs lists all available subtitles for the video
  256. --sub-format FORMAT subtitle format (default=srt) ([sbv/vtt]
  257. youtube only)
  258. --sub-lang LANGS languages of the subtitles to download
  259. (optional) separated by commas, use IETF
  260. language tags like 'en,pt'
  261.  
  262. Authentication Options:
  263. -u, --username USERNAME login with this account ID
  264. -p, --password PASSWORD account password
  265. -2, --twofactor TWOFACTOR two-factor auth code
  266. -n, --netrc use .netrc authentication data
  267. --video-password PASSWORD video password (vimeo, smotri)
  268.  
  269. Post-processing Options:
  270. -x, --extract-audio convert video files to audio-only files
  271. (requires ffmpeg or avconv and ffprobe or
  272. avprobe)
  273. --audio-format FORMAT "best", "aac", "vorbis", "mp3", "m4a",
  274. "opus", or "wav"; "best" by default
  275. --audio-quality QUALITY ffmpeg/avconv audio quality specification,
  276. insert a value between 0 (better) and 9
  277. (worse) for VBR or a specific bitrate like
  278. 128K (default 5)
  279. --recode-video FORMAT Encode the video to another format if
  280. necessary (currently supported:
  281. mp4|flv|ogg|webm|mkv)
  282. -k, --keep-video keeps the video file on disk after the
  283. post-processing; the video is erased by
  284. default
  285. --no-post-overwrites do not overwrite post-processed files; the
  286. post-processed files are overwritten by
  287. default
  288. --embed-subs embed subtitles in the video (only for mp4
  289. videos)
  290. --embed-thumbnail embed thumbnail in the audio as cover art
  291. --add-metadata write metadata to the video file
  292. --xattrs write metadata to the video file's xattrs
  293. (using dublin core and xdg standards)
  294. --fixup POLICY (experimental) Automatically correct known
  295. faults of the file. One of never (do
  296. nothing), warn (only emit a warning),
  297. detect_or_warn(check whether we can do
  298. anything about it, warn otherwise
  299. --prefer-avconv Prefer avconv over ffmpeg for running the
  300. postprocessors (default)
  301. --prefer-ffmpeg Prefer ffmpeg over avconv for running the
  302. postprocessors
  303. --exec CMD Execute a command on the file after
  304. downloading, similar to find's -exec
  305. syntax. Example: --exec 'adb push {}
  306. /sdcard/Music/ && rm {}'
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement
Public Pastes
Advertisement
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy.  OK, I Understand
Not a member of Pastebin yet?
Sign Up, it unlocks many cool features!