twitch-dl/README.md

103 lines
2.0 KiB
Markdown
Raw Normal View History

2018-01-25 10:09:20 +00:00
Twitch Downloader
=================
A simple CLI tool for downloading videos from Twitch.
2019-04-30 11:36:32 +00:00
Inspired by youtube-dl but improves upon it by using multiple concurrent
connections to make the download faster.
Resources
---------
2019-04-30 11:45:11 +00:00
* Homepage: https://github.com/ihabunek/twitch-dl
* Issues: https://github.com/ihabunek/twitch-dl/issues
* Python package: https://pypi.org/project/twitch-dl/
2019-04-30 11:36:32 +00:00
2020-05-29 11:57:02 +00:00
Requirements
------------
* Python 3.5+
* [ffmpeg](https://ffmpeg.org/) must be installed and in the path
2018-01-25 10:09:20 +00:00
Usage
-----
List recent streams for a given channel:
```
2019-04-30 11:36:32 +00:00
twitch-dl videos bananasaurus_rex
2018-01-25 10:09:20 +00:00
```
Yields (trimmed):
```
Found 33 videos
221837124
SUPER MARIO ODYSSSEY - Stream #2 / 600,000,000
Bananasaurus_Rex playing Super Mario Odyssey
Published 2018-01-24 @ 12:05:25 Length: 3h 40min
221418913
Dead Space and then SUPER MARIO ODYSSEY PogChamp
Bananasaurus_Rex playing Dead Space
Published 2018-01-23 @ 02:40:58 Length: 6h 2min
220783179
Dead Space | Got my new setup working! rexChamp
Bananasaurus_Rex playing Dead Space
Published 2018-01-21 @ 05:47:03 Length: 5h 7min
```
2020-05-17 12:46:08 +00:00
Use the `--game` option to specify one or more games to show:
```
twitch-dl videos --game "doom eternal" --game "cave story" bananasaurus_rex
```
2019-04-30 11:36:32 +00:00
Download a stream by ID or URL:
2018-01-25 10:09:20 +00:00
```
twitch-dl download 221837124
2019-04-30 11:36:32 +00:00
twitch-dl download https://www.twitch.tv/videos/221837124
```
Specify video quality to download:
```
twitch-dl download -q 720p 221837124
```
2020-04-11 14:07:17 +00:00
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".
2019-04-30 11:36:32 +00:00
Man page
--------
Building the man page for twitch-dl requires scdoc.
The source is in ``twitch-dl.1.scd``, and you can build it by running:
```
make man
2018-01-25 10:09:20 +00:00
```
License
-------
Copyright 2018 Ivan Habunek <ivan@habunek.com>
Licensed under the GPLv3: http://www.gnu.org/licenses/gpl-3.0.html