1
1
mirror of https://github.com/ytdl-org/youtube-dl synced 2024-12-28 03:45:50 +01:00

[README.md] Document using output template in batch files (Closes #9717)

This commit is contained in:
Sergey M․ 2016-06-12 06:39:31 +07:00
parent 98960c911c
commit a936ac321c
No known key found for this signature in database
GPG Key ID: 2C393E0F18A9236D

View File

@ -553,6 +553,10 @@ 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:
#### Output template and Windows batch files
If you are using output template inside a Windows batch file then you must escape plain percent characters (`%`) by doubling, so that `-o "%(title)s-%(id)s.%(ext)s"` should become `-o "%%(title)s-%%(id)s.%%(ext)s"`. However you should not touch `%`'s that are not plain characters, e.g. environment variables for expansion should stay intact: `-o "C:\%HOMEPATH%\Desktop\%%(title)s.%%(ext)s"`.
#### Output template examples
Note on Windows you may need to use double quotes instead of single.