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

Go to file

Ivan Habunek 78295a492c Improve parsing inputs for download command * Fix overzealous regex which caused video patterns to be identified as clips by testing for videos before clips. * Allow URLs with or without `www.`. * Add tests which verify this actually works. fixes #28		2020-08-09 11:45:39 +02:00
tests	Improve parsing inputs for download command	2020-08-09 11:45:39 +02:00
twitchdl	Improve parsing inputs for download command	2020-08-09 11:45:39 +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	Bump version, update changelog and readme	2020-08-07 16:38:55 +02:00
LICENSE	Initial commit	2018-01-25 11:09:20 +01:00
Makefile	Improve parsing inputs for download command	2020-08-09 11:45:39 +02:00
README.md	Bump version, update changelog and readme	2020-08-07 16:38:55 +02:00
requirements-dev.txt	Improve parsing inputs for download command	2020-08-09 11:45:39 +02:00
setup.py	Bump version, update changelog and readme	2020-08-07 16:38: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/

Requirements

Python 3.5+
ffmpeg must be installed and in the path

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

Specify video quality to download:

twitch-dl download -q 720p 221837124

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".

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