twitch-dlp
라이브 방송 중 시작부터 모든 트위치 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 │
└─────────┴──────────────┴──────────────┴──────┴───────────────┴────────┘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없이 채널 링크로 다운로드할 경우)