Fix some formatting

This commit is contained in:
felixphew 2014-08-15 12:17:13 +10:00
parent 314ce3d535
commit 62c5642b4e
2 changed files with 53 additions and 75 deletions

View File

@ -1,20 +1,20 @@
youtube-dl(1) - download videos from youtube.com or other video platforms
youtube-dl(1) -- download videos from youtube.com or other video platforms
=========================================================================
## SYNOPSIS
**youtube-dl** [OPTIONS] URL [URL...]
`youtube-dl` [<options>] <url> [<url>...]
## DESCRIPTION
**youtube-dl** is a small command-line program to download videos from YouTube.com and a few more sites. It requires the Python interpreter, version 2.6, 2.7, or 3.3+, and it is not platform specific. It should work on your Unix box, on Windows or on Mac OS X. It is released to the public domain, which means you can modify it, redistribute it or use it however you like.
## OPTIONS
* `-h, --help`:
* `-h`, `--help`:
print this help text and exit
* `--version`:
print program version and exit
* `-U, --update`:
* `-U`, `--update`:
update this program to latest version. Make sure that you have sufficient permissions (run with sudo if needed)
* `-i, --ignore-errors`:
* `-i`, `--ignore-errors`:
continue on download errors, for example to skip unavailable videos in a playlist
* `--abort-on-error`:
Abort downloading of further videos (in the playlist or the command line) if an error occurs
@ -28,41 +28,41 @@ youtube-dl(1) - download videos from youtube.com or other video platforms
Use the specified HTTP/HTTPS proxy. Pass in an empty string (--proxy "") for direct connection
* `--socket-timeout`:
Time to wait before giving up, in seconds
* `--default-search PREFIX`:
* `--default-search` <prefix>:
Use this prefix for unqualified URLs. For example "gvsearch2:" downloads two videos from google videos for youtube-dl "large apple". Use the value "auto" to let youtube-dl guess ("auto_warning" to emit a warning when guessing). "error" just throws an error. The default value "fixup_error" repairs broken URLs, but emits an error if this is not possible instead of searching.
* `--ignore-config`:
Do not read configuration files. When given in the global configuration file /etc/youtube-dl.conf: do not read the user configuration in ~/.config/youtube-dl.conf (%APPDATA%/youtube-dl/config.txt on Windows)
### Video Selection:
* `--playlist-start NUMBER`:
* `--playlist-start` <number>:
playlist video to start at (default is 1)
* `--playlist-end NUMBER`:
* `--playlist-end` <number>:
playlist video to end at (default is last)
* `--match-title REGEX`:
* `--match-title` <regex>:
download only matching titles (regex or caseless sub-string)
* `--reject-title REGEX`:
* `--reject-title` <regex>:
skip download for matching titles (regex or caseless sub-string)
* `--max-downloads NUMBER`:
* `--max-downloads` <number>:
Abort after downloading NUMBER files
* `--min-filesize SIZE`:
* `--min-filesize` <size>:
Do not download any videos smaller than SIZE (e.g. 50k or 44.6m)
* `--max-filesize SIZE`:
* `--max-filesize` <size>:
Do not download any videos larger than SIZE (e.g. 50k or 44.6m)
* `--date DATE`:
* `--date` <date>:
download only videos uploaded in this date
* `--datebefore DATE`:
* `--datebefore` <date>:
download only videos uploaded on or before this date (i.e. inclusive)
* `--dateafter DATE
* `--dateafter` <date>:
download only videos uploaded on or after this date (i.e. inclusive)
* `--min-views COUNT`:
* `--min-views` <count>:
Do not download any videos with less than COUNT views
* `--max-views COUNT`:
* `--max-views` <count>:
Do not download any videos with more than COUNT views
* `--no-playlist`:
download only the currently playing video
* `--age-limit YEARS`:
* `--age-limit` <years>:
download only videos suitable for the given age
* `--download-archive FILE`:
* `--download-archive` <file>:
Download only videos not listed in the archive file. Record the IDs of all downloaded videos in it.
* `--include-ads`:
Download advertisements as well (experimental)
@ -70,62 +70,40 @@ youtube-dl(1) - download videos from youtube.com or other video platforms
Try to download the DASH manifest on YouTube videos (experimental)
### Download Options:
-r, --rate-limit LIMIT maximum download rate in bytes per second
(e.g. 50K or 4.2M)
-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.
* `-r`, `--rate-limit` <limit>:
maximum download rate in bytes per second (e.g. 50K or 4.2M)
* `-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.
### Filesystem Options:
-a, --batch-file FILE file containing URLs to download ('-' for
stdin)
--id use only video ID in file name
-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, %(format)s for the
format description (like "22 - 1280x720" or
"HD"), %(format_id)s for the unique id of
the format (like Youtube's itags: "137"),
%(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, %(playlist_index)s for the
position in the playlist and %% for a
literal percent. %(height)s and %(width)s
for the width and height of the video
format. %(resolution)s for a textual
description of the resolution of the video
format. Use - to output to stdout. Can also
be used to download to a different
directory, for example with -o '/my/downloa
ds/%(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 --auto-number option
is given
--restrict-filenames Restrict filenames to only ASCII
characters, and avoid "&" and spaces in
filenames
-t, --title [deprecated] use title in file name
(default)
-l, --literal [deprecated] alias of --title
-w, --no-overwrites do not overwrite files
-c, --continue force resume of partially downloaded files.
By default, youtube-dl will resume
downloads if possible.
--no-continue do not resume partially downloaded files
(restart from beginning)
--no-part do not use .part files
* `-a`, `--batch-file` <file>:
file containing URLs to download ('-' for stdin)
* `--id`:
use only video ID in file name
* `-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, %(format)s for the format description (like "22 - 1280x720" or "HD"), %(format_id)s for the unique id of the format (like Youtube's itags: "137"), %(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, %(playlist_index)s for the position in the playlist and %% for a literal percent. %(height)s and %(width)s for the width and height of the video format. %(resolution)s for a textual description of the resolution of the video format. Use - to output to stdout. Can also be used to download to a different directory, for example with -o '/my/downloads/%(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 --auto-number option is given
* `--restrict-filenames`:
Restrict filenames to only ASCII characters, and avoid "&" and spaces in filenames
* `-t`, `--title`:
[deprecated] use title in file name (default)
* `-l`, `--literal`:
[deprecated] alias of --title
* `-w`, `--no-overwrites`:
do not overwrite files
* `-c`, `--continue`:
force resume of partially downloaded files. By default, youtube-dl will resume downloads if possible.
* `--no-continue`:
do not resume partially downloaded files (restart from beginning)
* `--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

View File

@ -1,4 +1,4 @@
youtube-dl(3) - download videos from youtube.com or other video platforms
youtube-dl(3) -- download videos from youtube.com or other video platforms
=========================================================================
## SYNOPSIS