2.6 KiB
twitch-dl clips
List or download clips for given CHANNEL_NAME.
USAGE
twitch-dl clips [OPTIONS] CHANNEL_NAME
OPTIONS
| -a, --all | Fetch all clips, overrides --limit |
| -c, --compact | Show clips in compact mode, one line per video |
| -d, --download | Download clips in given period (in source quality) |
| -l, --limit INTEGER | Number of clips to fetch. Defaults to 40 in compact mode, 10 otherwise. |
| -p, --pager INTEGER | Number of clips to show per page. Disabled by default. |
| -P, --period TEXT | Period from which to return clips Possible values: last_day, last_week, last_month, all_time. [default: all_time] |
| -t, --target-dir | Target directory when downloading clips [default: .] |
| --json | Print data as JSON rather than human readable text |
Listing clips
By default returns top 10 clips of all time.
twitch-dl clips bananasaurus_rex
Increase the number of clips returned.
twitch-dl clips bananasaurus_rex --limit 50
Return all clips, may require multiple requests, see notes.
twitch-dl clips bananasaurus_rex --all
Return clips from past day/week/month by changing the period:
twitch-dl clips bananasaurus_rex --period past_week
List all clips, 10 clips at the time:
twitch-dl clips bananasaurus_rex --pager
Print clips data in JSON. Useful for scripting.
twitch-dl clips bananasaurus_rex --json
Download all clips of the past week, won't overwrite exisitng ones:
twitch-dl clips bananasaurus_rex --download --period last_week
Notes
Clips are fetched in batches no larger than 100. When requesting more than 100
clips, it takes more than one request so it can take a little time. You can see
individual requests by passing the --debug flag.
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.