R-yan/l1ving_youtube-dl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Converted "Verbosity / Simulation Options" section

Browse Source 
It’s getting there…
This commit is contained in:
felixphew 2014-08-21 14:25:43 +10:00
parent 2d15e2a85b
commit f6eb8c249f
1 changed files with 78 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

140
youtube-dl.1.ronn
View File

@ -104,55 +104,68 @@ youtube-dl(1) -- download videos from youtube.com or other video platforms
do not resume partially downloaded files (restart from beginning) do not resume partially downloaded files (restart from beginning)
* `--no-part`: * `--no-part`:
do not use .part files do not use .part files
--no-mtime do not use the Last-modified header to set * `--no-mtime`:
the file modification time do not use the Last-modified header to set the file modification time
--write-description write video description to a .description * `--write-description`:
file write video description to a .description file
--write-info-json write video metadata to a .info.json file * `--write-info-json`:
--write-annotations write video annotations to a .annotation write video metadata to a .info.json file
file * `--write-annotations`:
--write-thumbnail write thumbnail image to disk write video annotations to a .annotation file
--load-info FILE json file containing the video information * `--write-thumbnail`:
(created with the "--write-json" option) write thumbnail image to disk
--cookies FILE file to read cookies from and dump cookie * `--load-info FILE`:
jar in json file containing the video information (created with the "--write-json" option)
--cache-dir DIR Location in the filesystem where youtube-dl * `--cookies FILE`:
can store some downloaded information file to read cookies from and dump cookie jar in
permanently. By default $XDG_CACHE_HOME * `--cache-dir DIR`:
/youtube-dl or ~/.cache/youtube-dl . At the Location in the filesystem where youtube-dl can store some downloaded information permanently. By default $XDG_CACHE_HOME /youtube-dl or ~/.cache/youtube-dl . At the moment, only YouTube player files (for videos with obfuscated signatures) are cached, but that may change.
moment, only YouTube player files (for * `--no-cache-dir`:
videos with obfuscated signatures) are Disable filesystem caching
cached, but that may change. * `--rm-cache-dir`:
--no-cache-dir Disable filesystem caching Delete all filesystem cache files
--rm-cache-dir Delete all filesystem cache files
### Verbosity / Simulation Options: ### Verbosity / Simulation Options:
-q, --quiet activates quiet mode * `-q`, `--quiet`:
--no-warnings Ignore warnings activates quiet mode
-s, --simulate do not download the video and do not write * `--no-warnings`:
anything to disk Ignore warnings
--skip-download do not download the video * `-s`, `--simulate`:
-g, --get-url simulate, quiet but print URL do not download the video and do not write anything to disk
-e, --get-title simulate, quiet but print title * `--skip-download`:
--get-id simulate, quiet but print id do not download the video
--get-thumbnail simulate, quiet but print thumbnail URL * `-g`, `--get-url`:
--get-description simulate, quiet but print video description simulate, quiet but print URL
--get-duration simulate, quiet but print video length * `-e`, `--get-title`:
--get-filename simulate, quiet but print output filename simulate, quiet but print title
--get-format simulate, quiet but print output format * `--get-id`:
-j, --dump-json simulate, quiet but print JSON information. simulate, quiet but print id
See --output for a description of available * `--get-thumbnail`:
keys. simulate, quiet but print thumbnail URL
--newline output progress bar as new lines * `--get-description`:
--no-progress do not print progress bar simulate, quiet but print video description
--console-title display progress in console titlebar * `--get-duration`:
-v, --verbose print various debugging information simulate, quiet but print video length
--dump-intermediate-pages print downloaded pages to debug problems * `--get-filename`:
(very verbose) simulate, quiet but print output filename
--write-pages Write downloaded intermediary pages to * `--get-format`:
files in the current directory to debug simulate, quiet but print output format
problems * `-j`, `--dump-json`:
--print-traffic Display sent and read HTTP traffic simulate, quiet but print JSON information. See --output for a description of available keys.
* `--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)
* `--write-pages`:
Write downloaded intermediary pages to files in the current directory to debug problems
* `--print-traffic`:
Display sent and read HTTP traffic
### Workarounds: ### Workarounds:
--encoding ENCODING Force the specified encoding (experimental) --encoding ENCODING Force the specified encoding (experimental)
@ -241,25 +254,28 @@ You can configure youtube-dl by placing default arguments (such as `--extract-au
The `-o` option allows users to indicate a template for the output file names. The basic usage is not to set any template arguments when downloading a single file, like in `youtube-dl -o funny_video.flv "http://some/video"`. However, it may contain special sequences that will be replaced when downloading each video. The special sequences have the format `%(NAME)s`. To clarify, that is a percent symbol followed by a name in parenthesis, followed by a lowercase S. Allowed names are: The `-o` option allows users to indicate a template for the output file names. The basic usage is not to set any template arguments when downloading a single file, like in `youtube-dl -o funny_video.flv "http://some/video"`. However, it may contain special sequences that will be replaced when downloading each video. The special sequences have the format `%(NAME)s`. To clarify, 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 identifier. * `id`: The sequence will be replaced by the video identifier.
- `url`: The sequence will be replaced by the video URL. * `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. * `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. * `upload_date`: The sequence will be replaced by the upload date in YYYYMMDD format.
- `title`: The sequence will be replaced by the video title. * `title`: The sequence will be replaced by the video title.
- `ext`: The sequence will be replaced by the appropriate extension (like flv or mp4). * `ext`: The sequence will be replaced by the appropriate extension (like flv or mp4).
- `epoch`: The sequence will be replaced by the Unix epoch when creating the file. * `epoch`: The sequence will be replaced by the Unix epoch when creating the file.
- `autonumber`: The sequence will be replaced by a five-digit number that will be increased with each download, starting at zero. * `autonumber`: The sequence will be replaced by a five-digit number that will be increased with each download, starting at zero.
- `playlist`: The name or the id of the playlist that contains the video. * `playlist`: The name or the id of the playlist that contains the video.
- `playlist_index`: The index of the video in the playlist, a five-digit number. * `playlist_index`: The index of the video in the playlist, a five-digit number.
The current default template is `%(title)s-%(id)s.%(ext)s`. The current default template is `%(title)s-%(id)s.%(ext)s`.
In some cases, you don't want special characters such as 中, spaces, or &, such as when transferring the downloaded filename to a Windows system or the filename through an 8bit-unsafe channel. In these cases, add the `--restrict-filenames` flag to get a shorter title: In some cases, you don't want special characters such as 中, spaces, or &, such as when transferring the downloaded filename to a Windows system or the filename through an 8bit-unsafe channel. In these cases, add the `--restrict-filenames` flag to get a shorter title:
```bash
$ youtube-dl --get-filename -o "%(title)s.%(ext)s" BaW_jenozKc $ youtube-dl --get-filename -o "%(title)s.%(ext)s" BaW_jenozKc
youtube-dl test video ''_ä↭𝕐.mp4 # All kinds of weird characters youtube-dl test video ''_ä↭𝕐.mp4 # All kinds of weird characters
$ youtube-dl --get-filename -o "%(title)s.%(ext)s" BaW_jenozKc --restrict-filenames ```
youtube-dl_test_video_.mp4 # A simple file name ```bash
$ youtube-dl --get-filename -o "%(title)s.%(ext)s" BaW_jenozKc --restrict-filenames
youtube-dl_test_video_.mp4 # A simple file name
```
## VIDEO SELECTION ## VIDEO SELECTION