- - `id`: The sequence will be replaced by the video identifier.
- - `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.
- - `upload_date`: The sequence will be replaced by the upload date in YYYYMMDD format.
- - `title`: The sequence will be replaced by the video title.
- - `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.
- - `autonumber`: The sequence will be replaced by a five-digit number that will be increased with each download, starting at zero.
- - `playlist`: The sequence will be replaced by the name or the id of the playlist that contains the video.
- - `playlist_index`: The sequence will be replaced by the index of the video in the playlist padded with leading zeros according to the total length of the playlist.
- - `format_id`: The sequence will be replaced by the format code specified by `--format`.
- - `duration`: The sequence will be replaced by the length of the video in seconds.
+ - `id`: Video identifier.
+ - `url`: Video URL.
+ - `uploader`: Nickname of the person who uploaded the video.
+ - `upload_date`: Upload date in YYYYMMDD format.
+ - `title`: Video title.
+ - `ext`: Video filename extension.
+ - `epoch`: Unix epoch when creating the file.
+ - `autonumber`: Five-digit number that will be increased with each download, starting at zero.
+ - `playlist`: Name or id of the playlist that contains the video.
+ - `playlist_index`: Index of the video in the playlist padded with leading zeros according to the total length of the playlist.
+ - `format_id`: Format code specified by `--format`.
+ - `duration`: Length of the video in seconds.
+
+Available for the video that belongs to some logical chapter or section:
+ - `chapter`: Name or title of the chapter the video belongs to.
+ - `chapter_number`: Number of the chapter the video belongs to.
+ - `chapter_id`: Id of the chapter the video belongs to.
+
+Available for the video that is an episode of some series or programme:
+ - `series`: Title of the series or programme the video episode belongs to.
+ - `season`: Title of the season the video episode belongs to.
+ - `season_number`: Number of the season the video episode belongs to.
+ - `season_id`: Id of the season the video episode belongs to.
+ - `episode`: Title of the video episode.
+ - `episode_number`: Number of the video episode within a season.
+ - `episode_id`: Id of the video episode, as a unicode string.
+
+Each aforementioned sequence when referenced in output template will be replaced by the actual value corresponding to the sequence name. Note that some of the sequences are not guaranteed to be present since they depend on the metadata obtained by particular extractor, such sequences will be replaced with `NA`.
+
+For example for `-o %(title)s-%(id)s.%(ext)s` and mp4 video with title `youtube-dl test video` and id `BaW_jenozKcj` this will result in a `youtube-dl test video-BaW_jenozKcj.mp4` file created in the current directory.
+
+Output template can also contain arbitrary hierarchical path, e.g. `-o %(playlist)s/%(playlist_index)s - %(title)s.%(ext)s` that will result in downloading each video in a directory corresponding to this path template. Any missing directory will be automatically created for you.