STREAMLINK(1) Streamlink STREAMLINK(1) (NAME) streamlink - (SYNOPSIS) streamlink [OPTIONS] [STREAM] (EXAMPLES) streamlink --loglevel debug youtu.be/VIDEO-ID best streamlink --player mpv --player-args '--no-border --no-keepaspect-window' twitch.tv/CHANNEL 1080p60 streamlink --player-external-http --player-external-http-port 8888 URL STREAM streamlink --output /path/to/file --http-timeout 60 URL STREAM streamlink --stdout URL STREAM | ffmpeg -i pipe:0 ... streamlink --http-header 'Authorization=OAuth TOKEN' --http-header 'Referer=URL' URL STREAM streamlink --hls-live-edge 5 --stream-segment-threads 5 'hls://https://host/playlist.m3u8' best streamlink --twitch-low-latency -p mpv -a '--cache=yes --demuxer-max-back-bytes=2G' twitch.tv/CHANNEL best (OPTIONS) (Positional arguments) URL (URL) . http(s) (https://) . URL --url . STREAM () . best worst . (fallback) : "720p,480p,best" --default-stream . (General options) -h --help . -V --version . --version-check . --auto-version-check {yes,true,1,on,no,false,0,off} Streamlink. : "no". --config FILENAME . . --no-config . --locale LOCALE (locale) . [language_code]_[country_code] en_US es_ES. : system locale. -l LEVEL --loglevel LEVEL . (verbosity): none, critical, error, warning, info, debug, trace, all : "info". --logformat FORMAT . LogRecord logging.Formatter . Streamlink ({}) . . (trace all): : "[{asctime}][{threadName}][{name}][{levelname}] {message}". : : "[{name}][{levelname}] {message}". --logdateformat DATEFORMAT . asctime LogRecord strftime() . . (trace all): : "%H:%M:%S.%f". : : "%H:%M:%S". --logfile FILE FILE stdout/stderr. FILE . - ( ) ISO8601 . Windows: %TEMP%\streamlink\logs macOS: ${HOME}/Library/Logs/streamlink Linux/BSD: ${XDG_STATE_HOME:-${HOME}/.local/state}/streamlink/logs -Q --quiet . -j --json JSON . . (Plugin options) --plugins . --show-matchers PLUGIN ( regex URL ). YAML . --json . --can-handle-url URL Streamlink URL . 0 1 . . --can-handle-url-no-redirect URL --can-handle-url (redirects) URL. --no-plugin-cache / (I/O) - . . . --no-plugin-sideloading (sideloading) . (plugin-sideloading) . --plugin-dir DIRECTORY . . --plugin-dirs DIRECTORY . () --interface INTERFACE IP . : o if! o host! IP (hostname) o ifhost!! IP : IP . -4 --ipv4 IPv4 (resolve) . --ipv6 . -6 --ipv6 IPv6 (resolve) . --ipv4 . (Player options) -p PATH --player PATH ( ). PATH . --player-args . : --player . 6.0.0 . : VLC . -a ARGUMENTS --player-args ARGUMENTS --player (tokenize) . { } . {{ }} (escape) . : {playerinput} --player . (stdin) - ( ) URL . . {playertitleargs} --player . --title . . : streamlink -p vlc -a "--play-and-exit --no-one-instance" [stream] : "". --player-env KEY=VALUE Streamlink/Python --player . . . -v --player-verbose stdout/stderr --player stdout/stderr Streamlink . --verbose-player --player-verbose . -n --player-fifo --player (named pipe) stdin . --fifo --player-fifo . --player-http --player stdin HTTP . --player-continuous-http --player HTTP --player-http . HTTP . <<>> ("repeat mode") . --player-external-http --player HTTP . . --player-continuous-http (loopback) . --player-external-http-interface --player-external-http-port . --player-external-http-continuous Streamlink . URL CTRL-C . --player-external-http-continuous {yes,true,1,on,no,false,0,off} --player-external-http (continuous) (non-continuous) . Streamlink HTTP CTRL-C . Streamlink . : true. --player-external-http-interface INTERFACE HTTP . 0.0.0.0 . --player-external-http-port PORT HTTP . (>1024) 0 . --player-passthrough TYPES --player URL Streamlink . URL : hls, http . --player-no-close Streamlink --player . Streamlink . . . -t TITLE --title TITLE --player. "Metadata variables" Streamlink "Plugins" . : o mpv o PotPlayer o VLC : streamlink -p mpv --title "{author} - {category} - {title}" [STREAM] -O --stdout stdout --player. -o FILENAME --output FILENAME FILENAME --player. FILENAME - ( ) --stdout stdout . . --force Streamlink FILENAME . "Metadata variables" Streamlink "Plugins" . (_) . : streamlink --output "~/recordings/{author}/{category}/{id}-{time:%Y%m%d%H%M%S}.ts" [STREAM] -r FILENAME --record FILENAME FILENAME --player --stdout. FILENAME - ( ) --stdout stdout . . --force Streamlink FILENAME . "Metadata variables" Streamlink "Plugins" . (_) . : streamlink --record "~/recordings/{author}/{category}/{id}-{time:%Y%m%d%H%M%S}.ts" [STREAM] -R FILENAME --record-and-pipe FILENAME --stdout --record=FILENAME . --fs-safe-rules {POSIX,Windows} . . Streamlink Windows NTFS USB VFAT exFAT CIFS . : o POSIX: \x00-\x1F / o Windows: \x00-\x1F \x7F " * / : < > ? \ | -f --force --output --record (). --skip --output --record ( ). --force . --progress {yes,force,no} --output --record . : yes. --url URL URL . (plugin) http(s) (https://). URL . --default-stream STREAM . best worst . (fallback) : "720p,480p,best" . --stream-url URL . --retry-streams DELAY DELAY . --retry-max . --retry-max 1 . --retry-streams --retry-max 0 . . --retry-max COUNT COUNT . --retry-streams 0 Streamlink . --retry-streams . --retry-open ATTEMPTS ATTEMPTS . : 1 . --stream-types TYPES --stream-priority TYPES . . . * () (wildcard) dash . : "hls,http,*" . --stream-sorting-excludes STREAMS best worst . best worst best-unfiltered worst-unfiltered (fallback) . (filter-expression) : [operator] > >= < <=. . "480p" : --stream-sorting-excludes ">480p" . : --stream-sorting-excludes ">480p,>medium" --ringbuffer-size SIZE (ringbuffer). ( ) M K . (player) . Streamlink . . . (pause) Streamlink . : "16M". --stream-segment-attempts ATTEMPTS (segment) . DASH HLS . : 3. --stream-segment-threads THREADS (thread pool) . 1 10 . DASH HLS . : 1. --stream-segment-timeout TIMEOUT . DASH HLS . : 10.0. --stream-segmented-duration [[XX:]XX:]XX[.XX] | [XXh][XXm][XX[.XX]s] HLS DASH. . 0 . : 0. --stream-segmented-queue-deadline FACTOR / . (segment-queue-deadline) . Streamlink (read-timeout) . --stream-timeout . . . 0 . : 3.0. . --stream-timeout TIMEOUT (unfiltered). DASH HLS HTTP . : 60.0. --stream-passthrough-encrypted . DASH HLS . --mux-subtitles (mux) . . HLS (HLS options) --hls-live-edge SEGMENTS . . (latency) Streamlink . --stream-segment-threads HLS --hls-playlist-reload-time . : 3. : / . . --player-args . --hls-segment-stream-data . --hls-playlist-reload-attempts ATTEMPTS HLS . : 3. --hls-playlist-reload-time TIME HLS : o segment: o live-edge: o default: (metadata) : default. --hls-segment-queue-threshold FACTOR --stream-segmented-queue-deadline . --hls-segment-ignore-names NAMES () . : --hls-segment-ignore-names 000,001,002 000.ts 001.ts 002.ts . : None. --hls-segment-key-uri URI URI . URI : {url} {scheme} {netloc} {path} {query} : --hls-segment-key-uri "https://example.com/hls/encryption_key" --hls-segment-key-uri "{scheme}://1.2.3.4{path}{query}" --hls-segment-key-uri "{scheme}://{netloc}/custom/path/to/key" : None. --hls-audio-select CODE . * () . : --hls-audio-select "English,German" --hls-audio-select "en,de" --hls-audio-select "*" : (locale) . --hls-start-offset [[XX:]XX:]XX[.XX] | [XXh][XXm][XX[.XX]s] () . ( ). : 0. --hls-duration [[XX:]XX:]XX[.XX] | [XXh][XXm][XX[.XX]s] --stream-segmented-duration . --hls-live-restart . DASH --dash-manifest-reload-attempts ATTEMPTS DASH . : 3. FFmpeg --ffmpeg-ffmpeg FILENAME FFmpeg PATH . (mux) DASH HLS FFmpeg . : --ffmpeg-ffmpeg "/usr/local/bin/ffmpeg" --ffmpeg-no-validation FFmpeg. --ffmpeg-verbose stderr FFmpeg stderr Streamlink. --ffmpeg-verbose-path PATH stderr FFmpeg PATH. --ffmpeg-loglevel LOGLEVEL -loglevel FFmpeg LOGLEVEL. --ffmpeg-verbose --ffmpeg-verbose-path . : "info". --ffmpeg-fout OUTFORMAT OUTFORMAT. muxing . : "matroska". : --ffmpeg-fout "mpegts" --ffmpeg-video-transcode CODEC (transcode) CODEC. muxing . : "copy". : --ffmpeg-video-transcode "h264" --ffmpeg-audio-transcode CODEC (transcode) CODEC. muxing . : "copy". : --ffmpeg-audio-transcode "aac" --ffmpeg-copyts -copyts FFmpeg . --ffmpeg-start-at-zero -start_at_zero FFmpeg --ffmpeg-copyts. --ffmpeg-validation-timeout SECONDS FFmpeg. : 4.0. FFmpeg . HTTP --http-proxy HTTP_PROXY HTTP HTTP HTTPS WebSocket. : --http-proxy "http://hostname:port/" --http-cookie KEY=VALUE HTTP. . --http-cookies-file PATH HTTP . . HTTP (MozillaCookieJar curl ) cookies.txt . RFC 2965 port . --http-cookie . --http-header KEY=VALUE HTTP. . --http-query-param KEY=VALUE HTTP. . --http-ignore-env HTTP (HTTP_PROXY ) ~/.netrc. --http-no-ssl-verify TLS/SSL. TLS/SSL . --http-disable-dh Diffie Hellman. TLS/SSL . --http-ssl-cert PEM_FILENAME SSL : .pem. --http-ssl-cert-crt-key CRT_FILENAME KEY_FILENAME SSL : .crt .key. --http-timeout TIMEOUT HTTP . : 20.0. --webbrowser {yes,true,1,on,no,false,0,off} API Streamlink. (API) Streamlink JavaScript HTTP Python . . Streamlink Chromium Chrome Devtools Protocol (CDP) . Chromium Google Chrome Microsoft Edge Brave Vivaldi Chromium . Chromium Google Chrome . : true. --webbrowser-executable PATH . webbrowser API . . --webbrowser-timeout TIME . --webbrowser-cdp-host HOST (Host) ( CDP). : 127.0.0.1. --webbrowser-cdp-port PORT ( CDP). . --webbrowser-cdp-timeout TIME CDP. --webbrowser-headless {yes,true,1,on,no,false,0,off} (headless) . () . headless . : false. (Plugin-specific options) Bbciplayer --bbciplayer-username USERNAME bbc.co.uk. --bbciplayer-password PASSWORD bbc.co.uk --bbciplayer-username. --bbciplayer-hd HD SD HD . Clubbingtv --clubbingtv-username Clubbing TV. --clubbingtv-password Clubbing TV --clubbingtv-username. Kick --kick-low-latency (prefetching) HLS. --hls-segment-stream-data true --hls-live-edge 2 . --hls-live-edge 1 . / . (bitrate) Kick . . --player-args . : Kick . --hls-live-edge . Nicolive --niconico-email EMAIL Niconico . --niconico-password PASSWORD Niconico . --niconico-user-session VALUE (user-session). . --niconico-purge-credentials Niconico . --niconico-timeshift-offset [[XX:]XX:]XX | [XXh][XXm][XXs] . : 0. --openrectv-email EMAIL openrectv openrectv . --openrectv-password PASSWORD openrectv --openrectv-email. Pixiv --pixiv-sessionid SESSIONID (sessionid) pixiv.net PHPSESSID pixiv . --pixiv-devicetoken DEVICETOKEN (device token) pixiv.net device_token pixiv . --pixiv-purge-credentials Pixiv . --pixiv-performer USER (co-host) . Raiplay --raiplay-email EMAIL raiplay.it. --raiplay-password PASSWORD raiplay.it --raiplay-email. --raiplay-purge-credentials RaiPlay . Soop --soop-username USERNAME sooplive.com. --soop-password PASSWORD sooplive.com --soop-username. --soop-purge-credentials Soop . --soop-stream-password STREAM_PASSWORD . Steam --steam-email EMAIL Steam (friends/private). --steam-password PASSWORD Steam --steam-email. Streann --streann-url URL URL iframe URL ott.streann.com . Tf1 --tf1-email EMAIL tf1.fr. --tf1-password PASSWORD tf1.fr --tf1-email. --tf1-purge-credentials tf1.fr . Twitcasting --twitcasting-password PASSWORD Twitcasting. Twitch --twitch-low-latency (low latency) HLS . --hls-segment-stream-data true --hls-live-edge 2 . --hls-live-edge 1 . / (player) . (bitrate) Twitch . . --player-args . : Twitch . --hls-live-edge . --twitch-supported-codecs CODECS Twitch . . : "h264" . h264 h265 av1. "h264,h265,av1" . h265 av1 . Twitch h264 . --twitch-api-header KEY=VALUE HTTP Twitch API. . . . --twitch-access-token-param KEY=VALUE API (streaming access token). . --twitch-force-client-integrity client-integrity . --twitch-purge-client-integrity client-integrity Twitch . --ustream-password PASSWORD UStream.tv. Ustvnow --ustvnow-username USERNAME USTV Now --ustvnow-password PASSWORD USTV Now Wwenetwork --wwenetwork-email EMAIL WWE Network WWE Network . --wwenetwork-password PASSWORD WWE Network --wwenetwork-email. Yupptv --yupptv-boxid BOXID boxid yupptv.com BoxId . --yupptv-yuppflixtoken YUPPFLIXTOKEN yuppflixtoken yupptv.com YuppflixToken . --yupptv-purge-credentials YuppTV . Zattoo --zattoo-email EMAIL zattoo zattoo . --zattoo-password PASSWORD zattoo --zattoo-email. --zattoo-purge-credentials zattoo . --zattoo-stream-types TYPES . : dash, hls7 : "dash" . (BUGS) Streamlink GitHub : https://github.com/streamlink/streamlink/issues (SEE ALSO) CLI Streamlink : https://streamlink.github.io/cli.html : https://streamlink.github.io/plugins.html (AUTHORS) Streamlink (COPYRIGHT) 2026, Streamlink 8.5.0 August 1, 2026 STREAMLINK(1)