SoundCloud용 yt-dlp 명령어 생성기

SoundCloud의 트랙과 set용 yt-dlp 명령어를 만듭니다. 태그까지 붙어 음악 라이브러리에 바로 들어갑니다.

영상, 재생목록 또는 채널 URL

선택 사항입니다. 비워 두면 명령어가 URL 로 끝나므로 나중에 직접 채우면 됩니다.

만들어진 명령어

yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata -o '%(uploader)s - %(title)s.%(ext)s' https://soundcloud.com/artist/track

기본

무엇을 원하나요

영상 오디오만

오디오만 고르면 소리 트랙만 뽑고 영상은 버립니다.

영상과 화질

최대 화질 -f

높이 상한을 정합니다. yt-dlp는 그 상한 이하에서 가장 좋은 트랙을 고릅니다.

Container --merge-output-format ffmpeg 필요

분리된 영상과 오디오 트랙을 병합해 담을 파일 형식입니다.

고급 옵션 (3)

직접 쓰는 format selector -f

화질 선택을 대체합니다. format 문법을 이미 아는 분을 위한 항목입니다.

remux 대상 --remux-video ffmpeg 필요

재인코딩 없이 다시 포장만 합니다. 빠르고 손실이 없습니다.

재인코딩 대상 --recode-video ffmpeg 필요

영상을 다시 인코딩합니다. 느리고 손실이 있습니다 —— remux로 안 될 때만 쓰세요.

오디오

오디오 형식 --audio-format ffmpeg 필요

오디오를 변환할 대상 형식입니다.

오디오 품질 --audio-quality ffmpeg 필요

VBR은 용량 대비 품질이 가장 좋고, 고정 bitrate는 용량을 예상하기 쉽습니다.

자막

삽입은 자막을 영상 안에 넣고, 저장은 옆에 별도의 .srt 파일을 만듭니다.

자막 언어 --sub-langs

쉼표로 구분합니다. 사용 가능한 모든 언어를 원하면 all 이라고 쓰세요.

자동 생성 자막 --write-auto-subs 사람이 만든 자막이 없을 때 기계가 만든 자막도 포함합니다.

재생목록과 채널

재생목록 처리

URL이 영상과 재생목록에 동시에 속할 때 어떻게 할지 정합니다.

어떤 항목 -I

범위와 목록 모두 됩니다. 예를 들어 1-10,15, 또는 끝에서부터 하나씩 건너뛰는 -5::2.

고급 옵션 (1)

기록 파일 --download-archive

이미 내려받은 항목을 적어 두어 다시 실행할 때 건너뜁니다. 채널을 계속 동기화하는 방법이 바로 이것입니다.

구간과 챕터

고급 옵션 (2)

일부 구간만 내려받기 --download-sections ffmpeg 필요

*00:01:30-00:03:00 같은 시간 범위, 또는 챕터 이름입니다. 앞의 별표는 시각이라는 뜻입니다.

챕터별로 나누기 --split-chapters ffmpeg 필요 긴 파일 하나가 아니라 챕터마다 파일 하나를 만듭니다.

메타데이터와 표지

썸네일 삽입 --embed-thumbnail ffmpeg 필요 영상 썸네일을 표지로 씁니다.

메타데이터 삽입 --embed-metadata ffmpeg 필요 제목, 업로더, 날짜를 파일 자체에 기록합니다.

챕터 삽입 --embed-chapters ffmpeg 필요 플레이어에서 건너뛸 수 있는 챕터 표시를 넣습니다.

고급 옵션 (3)

썸네일 파일 저장 --write-thumbnail 표지 이미지를 영상 옆에 저장합니다.

설명 저장 --write-description 설명을 .description 파일에 저장합니다.

메타데이터 JSON 저장 --write-info-json yt-dlp가 그 영상에 대해 아는 모든 것을 .info.json 파일에 저장합니다.

SponsorBlock

구간 제거 --sponsorblock-remove ffmpeg 필요

SponsorBlock 데이터를 바탕으로 커뮤니티가 표시한 구간을 파일에서 잘라냅니다.

고급 옵션 (1)

구간을 챕터로 표시 --sponsorblock-mark

구간은 남기고 표시만 해서 직접 건너뛸 수 있게 합니다.

파일과 폴더

파일 이름 템플릿 -o

필드 이름은 %(...)s 안에 씁니다. 슬래시는 폴더를 만듭니다.

안전한 (ASCII만) 파일 이름 --restrict-filenames 악센트, 공백, 그리고 까다로운 파일 시스템이 거부할 수 있는 문자를 없앱니다.

기존 파일 덮어쓰기 --force-overwrites 이미 있는 파일을 대체합니다.

중단된 내려받기 이어서 -c 멈춘 지점부터 계속합니다.

고급 옵션 (4)

내려받을 폴더 -P

파일을 저장할 위치입니다. 위 템플릿과 조합하면 하위 폴더도 만들 수 있습니다.

Windows에 안전한 이름 --windows-filenames 다른 시스템에서 실행해도 Windows가 받지 않는 문자를 없앱니다.

이름 길이 제한 --trim-filenames

파일 이름의 최대 길이(문자 수)입니다.

절대 덮어쓰지 않기 -w 이미 내려받은 것은 건너뜁니다.

필터

고급 옵션 (5)

이 날짜 이후 업로드 --dateafter

YYYYMMDD, 또는 now-1month 같은 상대 날짜.

이 날짜 이전 업로드 --datebefore

YYYYMMDD, 또는 상대 날짜.

최소 크기 --min-filesize

이보다 작은 것은 건너뜁니다. 5M, 500K 같은 표기를 씁니다.

최대 크기 --max-filesize

이보다 큰 것은 건너뜁니다.

이 개수 후 중단 --max-downloads

멈추기 전까지 내려받을 파일 수입니다.

네트워크

속도 제한 -r

예를 들어 2M 또는 500K. 남은 대역폭을 다른 일에 써야 할 때 유용합니다.

고급 옵션 (5)

동시 fragment 수 -N

조각으로 나뉜 트랙을 빠르게 합니다. 4 정도로 시작하면 무리가 없습니다.

재시도 횟수 -R

실패한 조각을 몇 번 다시 시도할지. infinite 도 쓸 수 있습니다.

Proxy --proxy

HTTP, HTTPS 또는 SOCKS proxy 주소입니다.

지역 제한 우회 --geo-bypass 요청 출처를 위장합니다. 일부 사이트에서는 되지만 전부는 아닙니다.

브라우저로 위장 --impersonate

요청이 실제 브라우저에서 온 것처럼 보이게 합니다. 갑자기 403이 날 때 흔히 쓰는 해법입니다.

로그인과 cookies

브라우저에서 cookies 읽기 --cookies-from-browser

로그인된 세션을 직접 읽습니다. 비공개, 연령 제한, 멤버 전용 콘텐츠에는 필요합니다.

고급 옵션 (1)

cookies 파일 --cookies

브라우저에서 내보낸 Netscape 형식 cookies.txt 파일입니다.

라이브 방송

고급 옵션 (2)

방송 처음부터 녹화 --live-from-start 현재 시점이 아니라 라이브 방송 시작부터 녹화합니다.

방송 시작 대기 --wait-for-video

예정된 방송이 시작될 때까지 계속 확인합니다. MIN-MAX는 확인 간격(초)입니다.

우회 방법

고급 옵션 (3)

User agent --user-agent 구식

구식이며 --add-headers 로 대체되었습니다. 오래된 안내 글이 아직 많이 쓰기 때문에 남겨 두었습니다.

Referer --referer 구식

구식이며 --add-headers 로 대체되었습니다.

extractor 인자 --extractor-args

사이트별 전용 옵션입니다. 예를 들어 youtube:player_client=web.

출력과 디버그

형식 목록만 보기 -F 사용 가능한 형식을 출력하고 내려받지 않은 채 종료합니다.

고급 옵션 (2)

오류가 나도 계속 -i 실패한 항목을 건너뛰고 멈추지 않습니다. 큰 재생목록에서는 반드시 필요합니다.

모의 실행 -s 파일을 쓰는 것만 빼고 전부 수행합니다.

초기화

여기서 중요한 옵션

오디오 형식 --audio-format 오디오를 변환할 대상 형식입니다.
오디오 품질 --audio-quality VBR은 용량 대비 품질이 가장 좋고, 고정 bitrate는 용량을 예상하기 쉽습니다.
썸네일 삽입 --embed-thumbnail 영상 썸네일을 표지로 씁니다.

오디오 형식 고르기

SoundCloud는 보통 128 kbps MP3를, 때로는 Opus를 내려줍니다. 128 kbps 원본을 320 kbps로 변환하면 파일만 커지고 소리는 좋아지지 않습니다 —— "사용 가능한 최고 오디오"를 골라 원본을 그대로 두는 것이 옳습니다.

표지와 메타데이터는 켜 둘 만합니다. 이것이 없으면 내려받은 set은 제목 없는 파일이 가득한 폴더로 도착합니다. set과 재생목록은 재생목록 전체 모드로 동작합니다.

자주 묻는 질문

› SoundCloud는 어떤 음질을 주나요?

보통 128 kbps MP3, 때로는 Opus입니다. 128 kbps 원본을 320 kbps MP3로 바꾸면 파일만 커지고 좋아지지는 않습니다 —— 원본을 지키려면 "사용 가능한 최고 오디오"를 고르세요.

› SoundCloud 재생목록을 받을 수 있나요?

가능합니다. set이나 재생목록 주소를 재생목록 전체 모드로 쓰고, 반복 실행을 위해 기록 파일도 더하세요.

› 비공개나 미등록 트랙도 되나요?

비밀 링크 트랙은 완전한 주소를 넣으면 보통 됩니다. 정말 비공개인 트랙은 접근 권한이 있는 계정의 cookies가 필요합니다.