mirror of https://github.com/ihabunek/twitch-dl synced 2024-08-30 18:32:25 +00:00

Go to file

Ivan Habunek 169f15ca30 Add --game example to README		2020-05-17 14:46:08 +02:00
twitchdl	Bump version	2020-05-17 14:42:55 +02:00
.flake8	Initial commit	2018-01-25 11:09:20 +01:00
.gitignore	Add man page	2019-02-10 10:46:03 +01:00
CHANGELOG.md	Add filtering videos by game	2020-05-17 14:35:33 +02:00
LICENSE	Initial commit	2018-01-25 11:09:20 +01:00
Makefile	Bump version	2019-08-13 12:40:00 +02:00
README.md	Add --game example to README	2020-05-17 14:46:08 +02:00
requirements-dev.txt	Initial commit	2018-01-25 11:09:20 +01:00
setup.py	Bump version	2020-05-17 14:42:55 +02:00
stdeb.cfg	Bump version	2019-08-13 12:40:00 +02:00
twitch-dl.1.scd	Implement downloading clips	2020-04-11 16:07:17 +02:00

README.md

Twitch Downloader

A simple CLI tool for downloading videos from Twitch.

Inspired by youtube-dl but improves upon it by using multiple concurrent connections to make the download faster.

Resources

Homepage: https://github.com/ihabunek/twitch-dl
Issues: https://github.com/ihabunek/twitch-dl/issues
Python package: https://pypi.org/project/twitch-dl/

Usage

List recent streams for a given channel:

twitch-dl videos bananasaurus_rex

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

Use the --game option to specify one or more games to show:

twitch-dl videos --game "doom eternal" --game "cave story" bananasaurus_rex

Download a stream by ID or URL:

twitch-dl download 221837124
twitch-dl download https://www.twitch.tv/videos/221837124

Download a clip by slug or URL:

twitch-dl download VenomousTameWormHumbleLife
twitch-dl download https://www.twitch.tv/bananasaurus_rex/clip/VenomousTameWormHumbleLife

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

License

Licensed under the GPLv3: http://www.gnu.org/licenses/gpl-3.0.html