twitchdl

README

twitch-downloader

Easily download twitch VODs and Clips.

Usage

Download

You can download the latest release for Windows, Macos and Linux here: https://github.com/jybp/twitch-downloader/releases

Flags

Flag	Description
-url	The URL of the twitch VOD or Clip to download.
-q	Quality of the video to download. Omit this flag to print the available qualities. Use "best" to automatically select the highest quality.
-o	Path where the video will be downloaded. (optional)
-start	Specify "start" to download a subset of the VOD. Example: 1h23m45s (optional)
-end	Specify "end" to download a subset of the VOD. Example: 1h34m56s (optional)
-client-id	Use a specific twitch.tv API client ID. Using any other client id other than twitch own client id might not work. (optional)
-v	Verbose errors. (optional)

Build from source

1. Install the latest version of Go https://golang.org/
2. Clone the git repository
3. Set the current directory to cmd/twitchdl and run go build -ldflags "-X main.defaultClientID=TwitchClientID"

Documentation

Index

• func Download(ctx context.Context, client *http.Client, clientID, vURL, quality string, ...) (io.ReadCloser, error)
• func Name(ctx context.Context, client *http.Client, clientID, vURL string) (string, error)
• func Qualities(ctx context.Context, client *http.Client, clientID, vURL string) ([]string, error)

Functions

func Download

func Download(ctx context.Context, client *http.Client, clientID, vURL, quality string, start, end time.Duration) (io.ReadCloser, error)

Download sets up the download of the VOD "vodId" with quality "quality" using the provided http.Client. The download is actually perfomed when the returned io.Reader is being read.

func Name

func Name(ctx context.Context, client *http.Client, clientID, vURL string) (string, error)

Name return the name of the video: Channel Name - Video name.

func Qualities

func Qualities(ctx context.Context, client *http.Client, clientID, vURL string) ([]string, error)

Qualities return the qualities available.