CLI tool for downloading videos from twitch.tv
Inspired by youtube-dl but improves upon it by using multiple concurrent connections to make the download faster.
Go to the latest release
and download the
Run the archive by either:
a) passing it to python:
python3 twitch-dl.1.13.0.pyz --help
b) making it executable and invoking it directly (linux specific):
chmod +x twitch-dl.1.13.0.pyz ./twitch-dl.1.13.0.pyz --help
Feel free to rename the archive to something more managable, like
To upgrade to a newer version, repeat the process with the newer release.
pipx is a tool which installs python apps into isolated environments, which prevents all kinds of problems later so it's the suggested way to install twitch-dl from PYPI.
Install pipx as described in pipx install docs.
pipx install twitch-dl
Check installation worked:
If twitch-dl executable is not found, check that the pipx binary location (by
~/.local/bin) is in your PATH.
To upgrade twitch-dl to the latest version:
pipx install twitch-dl
This section does an overview of available features.
To see a list of available commands run:
And to see description and all arguments for a given command run:
twitch-dl <command> --help
Videos can be referenced by URL or ID:
twitch-dl info 863849735 twitch-dl info https://www.twitch.tv/videos/863849735
Clips by slug or ID:
twitch-dl info BusyBlushingCattleItsBoshyTime twitch-dl info https://www.twitch.tv/bananasaurus_rex/clip/BusyBlushingCattleItsBoshyTime
Shows info about the video or clip as well as download URLs for clips and playlist URLs for videos.
List recent streams for a given channel:
twitch-dl videos bananasaurus_rex
--game option to specify one or more games to show:
twitch-dl videos --game "doom eternal" --game "cave story" bananasaurus_rex
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:
twitch-dl download -q 720p 221837124
Setting quality to
source will download the best available quality:
twitch-dl download -q source 221837124
List clips for the given period:
twitch-dl clips bananasaurus_rex --period last_week
Supported periods are:
For listing a large number of clips, it's nice to page them:
twitch-dl clips bananasaurus_rex --period all_time --limit 10 --pager
This will show 10 clips at a time and ask to continue.
Download a clip by slug or URL:
twitch-dl download VenomousTameWormHumbleLife twitch-dl download https://www.twitch.tv/bananasaurus_rex/clip/VenomousTameWormHumbleLife
Specify clip quality to download:
twitch-dl download -q 720 VenomousTameWormHumbleLife
Note that twitch names for clip qualities have no trailing "p".
It's possible to download all clips for a given period:
twitch-dl clips bananasaurus_rex --period last_week --download
Clips are downloaded in source quality.
Currently it doesn't seem to be possible to get a list of clips ordered by time of creation, only by view count. Clips with the same view count seem to be returned in random order. This can break paging resulting in duplicate clips listed or clips missed.
When batch downloading a large number of clips (over 100), it's possible that some will be missed.
By default, twitch-dl will download VODs to your systems temp dir (e.g.
on Linux). To change the location where the files are downloaded you can set
TMP environment variable, e.g.
TMP=/my/tmp/path/ twitch-dl download 221837124
Building the man page for twitch-dl requires scdoc.
The source is in
twitch-dl.1.scd, and you can build it by running:
Copyright 2018-2020 Ivan Habunek [email protected]
Licensed under the GPLv3: http://www.gnu.org/licenses/gpl-3.0.html