twitch-dl/docs/commands/videos.md
2024-03-29 08:43:30 +01:00

2.0 KiB

twitch-dl videos

List or download clips for given CHANNEL_NAME.

USAGE

twitch-dl videos [OPTIONS] CHANNEL_NAME

OPTIONS

-a, --all Fetch all clips, overrides --limit
-c, --compact Show videos in compact mode, one line per video
-l, --limit INTEGER Number of videos to fetch. Defaults to 40 in compact mode, 10 otherwise.
-p, --pager INTEGER Number of videos to show per page. Disabled by default.
-g, --game TEXT Show videos of given game (can be given multiple times)
-s, --sort TEXT Sorting order of videos Possible values: views, time. [default: time]
-t, --type TEXT Broadcast type Possible values: archive, highlight, upload. [default: archive]
--json Print data as JSON rather than human readable text

Examples

List recent channel videos (10 by default):

twitch-dl videos bananasaurus_rex

Limit to videos of one or more games:

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

List all channel videos at once:

twitch-dl videos bananasaurus_rex --all

List all channel videos in pages of 10:

twitch-dl videos bananasaurus_rex --pager

Page size can be adjusted by passing number of items per page:

twitch-dl videos bananasaurus_rex --pager 5

Returns all videos as a JSON list. Useful for scripting.

twitch-dl videos bananasaurus_rex --json --all