twitch-dlp
在直播期间从头开始下载任何 Twitch VOD
功能
- 从头开始下载直播 VOD（
--live-from-start） - 下载正在进行的隐藏 VOD（或在直播期间被隐藏的）
- 下载已结束的隐藏 VOD
- 只需使用 twitchtracker.com、streamscharts.com 或 sullygnome.com 链接（详情）
- 下载视频的特定部分（
--download-sections） - 下载剪辑（包括竖屏版本）
- 可能时自动取消静音静音部分
- 继续下载部分下载的视频（以防网络/断电中断）
- 监控频道状态。如果变为直播，开始下载（
--retry-streams DELAY） - 类似于
yt-dlp（youtube-dl）的语法
使用方法
安装最新的 Node.js 版本（v22 或更高）。
# npm (comes with Node.js)
npx twitch-dlp LINKpnpm
pnpm dlx twitch-dlp LINKyarn v2+
yarn dlx twitch-dlp LINKbun
bunx twitch-dlp LINK示例
# Download a VOD from start using channel link, continue until stream ends
npx twitch-dlp https://www.twitch.tv/xqc --live-from-startDownload a VOD
npx twitch-dlp https://www.twitch.tv/videos/2022789761Download live stream from the current time using streamlink
npx twitch-dlp https://www.twitch.tv/xqcDownload a hidden VOD
Just use twitchtracker.com, streamscharts.com or sullygnome.com links
npx twitch-dlp https://twitchtracker.com/xqc/streams/51582913581
npx twitch-dlp https://streamscharts.com/channels/lirik/streams/51579711693
npx twitch-dlp https://sullygnome.com/channel/summit1g/stream/315782796250
If it doesn't work for you, follow this instructions:
https://github.com/DmitryScaletta/twitch-dlp/blob/master/DOWNLOAD_PRIVATE_VIDEOS.md
Check every 60 seconds is channel live
If it's live, start to download it using streamlink
npx twitch-dlp https://www.twitch.tv/xqc --retry-streams 60Check every 60 seconds is channel live
If it's live, start to download it's VOD from start
npx twitch-dlp https://www.twitch.tv/xqc --retry-streams 60 --live-from-startDownload 10 minutes in the middle of the VOD
npx twitch-dlp https://www.twitch.tv/videos/2022789761 --download-sections "*15:00-25:00"Display available formats
npx twitch-dlp https://www.twitch.tv/videos/2022789761 -FDownload specified format
npx twitch-dlp https://www.twitch.tv/videos/2022789761 -f 480p30Change output template
npx twitch-dlp https://www.twitch.tv/videos/2022789761 -o "%(title)s [%(id)s].%(ext)s"Limit download rate
npx twitch-dlp https://www.twitch.tv/videos/2022789761 -r 720kMerge already downloaded fragments (if something went wrong)
Filename must match the fragment names but without ".part-FragN"
Use --download-sections if you want to merge only specific part of the video
npx twitch-dlp "./Chillin [v2222470239].mp4" --merge-fragmentsMerge already downloaded fragments and try to unmute muted fragments
npx twitch-dlp "./Chillin [v2222470239].mp4" --merge-fragments --unmute quality选项
-h, --help Print this help text and exit
--version Print program version and exit
-f, --format FORMAT Select format to download
Available formats:
- best: best quality (default)
- FORMAT: select format by format_id
-F, --list-formats Print available formats and exit
-o, --output OUTPUT Output filename template
Available template variables:
- %(title)s
- %(id)s
- %(ext)s
- %(description)s
- %(duration)s
- %(uploader)s
- %(uploader_id)s
- %(upload_date)s
- %(release_date)s
- %(view_count)s
--live-from-start Download live streams from the start
--retry-streams DELAY Retry fetching the list of available streams until
streams are found while waiting DELAY second(s)
between each attempt
-r, --limit-rate RATE Limit download rate to RATE
--keep-fragments Keep fragments after downloading
--download-sections TEXT Download specific part of the video.
Syntax: "*start_time-end_time".
Examples: "0-12:34", "3:14:15-inf".
A "*" prefix is for yt-dlp compatibility.
Negative timestamps and multiple sections are not
supported. Cutting is done by the closest fragments
(not by keyframes), so the accuracy is not very high
--unmute POLICY Try to unmute muted fragments. Keep in mind that
160p and 360p have slightly worse audio quality.
Available values:
- quality (default for 480p and higher) - check all
formats, unmute only if best audio quality is
available
- any - check all formats, unmute if any audio
quality is available
- same_format (default for 360p and lower) - only
check downloading format, unmute if available
- off - don't try to unmute fragments
--downloader NAME Name of the external downloader to use.
Currently supports: aria2c, curl, fetch (default)
--proxy URL Use the specified HTTP/HTTPS/SOCKS proxy. To
enable SOCKS proxy, specify a proper scheme,
e.g. socks5://user:pass@127.0.0.1:1080/.
Pass in an empty string (--proxy "") for
direct connection. Currently only works with fetch
--merge-method METHOD How fragments should be merged. Merging happens
only after all fragments are downloaded.
Available values:
- ffconcat (default) - using ffmpeg's concat
demuxer, no fixup needed
- append - merge all fragments into one file and
fixup using ffmpeg (like yt-dlp does)
--merge-fragments Merge already downloaded fragments. A FILENAME
should be passed instead of a video link. The
FILENAME must match the fragment names but without
".part-FragN". Example: "npx twitch-dlp FILENAME
--merge-fragments".
Can be used with:
- --download-sections - merge only specific part
of the video
- --unmute - try to unmute downloaded fragments
according to passed unmute policy (off by
default)
- --merge-method - change merge method
It's also possible to pass streamlink twitch plugin args:
--twitch-disable-ads, --twitch-low-latency, --twitch-api-header,
--twitch-access-token-param, --twitch-force-client-integrity,
--twitch-purge-client-integrity
See https://streamlink.github.io/cli.html#twitch格式示例
针对点播视频 (VOD)
┌─────────┬──────────────┬──────────────┬──────┬───────────────┬────────┐
│ (index) │ format_id │ resolution │ fps │ total_bitrate │ source │
├─────────┼──────────────┼──────────────┼──────┼───────────────┼────────┤
│ 0 │ 'Audio_Only' │ 'audio only' │ null │ '212k' │ null │
│ 1 │ '160p' │ '284x160' │ 30 │ '225k' │ null │
│ 2 │ '360p' │ '640x360' │ 30 │ '615k' │ null │
│ 3 │ '480p' │ '852x480' │ 30 │ '1172k' │ null │
│ 4 │ '720p60' │ '1280x720' │ 60 │ '3027k' │ null │
│ 5 │ '1080p60' │ '1920x1080' │ 60 │ '5967k' │ true │
└─────────┴──────────────┴──────────────┴──────┴───────────────┴────────┘对于直播流（streamlink）
Available streams: audio_only, 160p (worst), 360p, 480p, 720p, 720p60, 1080p60 (best)Available streams: audio_only, 160p (worst), 360p, 480p, 720p, 720p60_alt, 720p60 (best)依赖项
- ffmpeg
- streamlink（如果通过频道链接下载且不使用
--live-from-start）