twitch-dl download
Download videos or clips.
Pass one or more video ID, clip slug or Twitch URL to download.
USAGE
twitch-dl download [OPTIONS] [IDS]...
OPTIONS
| -a, --auth-token TEXT | Authentication token, passed to Twitch to access subscriber only VODs. Can be copied from the auth_token cookie in any browser logged in on Twitch. |
| -c, --chapter INTEGER | Download a single chapter of the video. Specify the chapter number or use the flag without a number to display a chapter select prompt. |
| --concat | Do not use ffmpeg to join files, concat them instead. This will produce a .ts file by default. |
| -d, --dry-run | Simulate the download provcess without actually downloading any files. |
| -e, --end TEXT | Download video up to this time (hh:mm or hh:mm:ss), not supported for clips |
| -f, --format TEXT | Video format to convert into, passed to ffmpeg as the target file extension. Defaults to mp4. If --concat is passed, defaults to ts. |
| -k, --keep | Don't delete downloaded VODs and playlists after merging. |
| --no-join | Don't run ffmpeg to join the downloaded vods, implies --keep. |
| --overwrite | Overwrite target file if it already exists |
| --skip-existing | Skip target file if it already exists |
| -o, --output TEXT | Output file name template. See docs for details. [default: {date}_{id}_{channel_login}_{title_slug}.{format}] |
| -q, --quality TEXT | Video quality, e.g. 720p. Set to source to get best quality. |
| -r, --rate-limit TEXT | Limit the maximum download speed in bytes per second. Use 'k' and 'm' suffixes for kbps and mbps. |
| -s, --start TEXT | Download video from this time (hh:mm or hh:mm:ss), not supported for clips |
| -w, --max-workers INTEGER | Number of workers for downloading vods concurrently [default: 10] |
| --cache-dir TEXT | Folder where VODs are downloaded before joining. Uses placeholders similar to --output. [default: /home/ihabunek/.cache/twitch-dl/videos/{id}/{quality}] |
Examples
Download a video by ID or URL:
twitch-dl download 221837124
twitch-dl download https://www.twitch.tv/videos/221837124
Specify video quality to download to prevent a prompt:
twitch-dl download -q 720p 221837124
Setting quality to source will download the best available quality:
twitch-dl download -q source 221837124
Setting quality to audio_only will download only audio:
twitch-dl download -q audio_only 221837124
Download multiple videos one after the other:
twitch-dl download 1559928295 1557034274 1555157293 -q source
Overriding the target file name
The target filename can be defined by passing the --output option followed by
the desired file name, e.g. --output strim.mkv.
The filename uses
Python format string syntax
and may contain placeholders in curly braces which will be replaced with
relevant information tied to the downloaded video, e.g. --output "{date}_{id}.{format}".
The supported placeholders are:
| Placeholder | Description | Sample |
|---|---|---|
{id} | Video ID | 1255522958 |
{title} | Video title | Dark Souls 3 First playthrough |
{title_slug} | Slugified video title | dark_souls_3_first_playthrough |
{datetime} | Video date and time | 2022-01-07T04:00:27Z |
{date} | Video date | 2022-01-07 |
{time} | Video time | 04:00:27Z |
{channel} | Channel name | KatLink |
{channel_login} | Channel login | katlink |
{format} | File extension, see --format | mkv |
{game} | Game name | Dark Souls III |
{game_slug} | Slugified game name | dark_souls_iii |
{slug} | Clip slug (clips only) | AbrasivePlacidCatDxAbomb |
A couple of examples:
| Pattern | {date}_{id}_{channel_login}_{title_slug}.{format} (default) |
| Expands to | 2022-01-07_1255522958_katlink_dark_souls_3_first_playthrough.mkv |
| Pattern | {channel} - {game} - {title}.{format} |
| Expands to | KatLink - Dark Souls III - Dark Souls 3 First playthrough.mkv |
Downloading subscriber-only VODs
Some videos are subscriber-only and require you to be logged in. To accomplish this follow the instructions in the Authentication chapter.