yt-dlp로 YouTube를 MP3로

YouTube 영상을 태그와 표지가 붙은 MP3로 바꾸는 yt-dlp 명령어를 만듭니다.

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

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

만들어진 명령어

yt-dlp -x --audio-format mp3 --audio-quality 0 --no-playlist --embed-thumbnail --embed-metadata -o '%(artist,uploader)s - %(title)s.%(ext)s' 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

기본

무엇을 원하나요

영상 오디오만

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

영상과 화질

최대 화질 -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 영상 썸네일을 표지로 씁니다.
메타데이터 삽입 --embed-metadata 제목, 업로더, 날짜를 파일 자체에 기록합니다.

쓸 만한 MP3를 얻으려면

오디오 추출은 변환이므로 ffmpeg가 반드시 필요합니다 —— 새로 설치한 환경에서 명령어가 실패하는 이유가 이것입니다. 최고(VBR)가 올바른 기본값입니다: 용량 대비 품질이 가장 좋고, 고정 bitrate를 높여도 원본에 없던 품질이 생기지는 않습니다.

표지와 메타데이터는 이름 없는 파일이 가득한 폴더를 음악 플레이어가 정리할 수 있는 것으로 바꿔 줍니다. 여기 이름 템플릿은 아티스트를 앞에 두고, 태그에 아티스트가 없으면 업로더 이름을 씁니다.

자주 묻는 질문

› MP3 품질은 무엇을 골라야 하나요?

대부분은 최고(VBR) —— 용량 대비 품질이 가장 좋습니다. 320 kbps는 뒤쪽 어딘가에서 고정 bitrate를 요구할 때만 의미가 있습니다. 둘 다 원본에 없던 품질을 만들어 내지는 않습니다.

› MP3 추출이 실패하는 이유는?

오디오 변환에는 ffmpeg가 필요합니다. 설치한 뒤 ffmpeg -version 으로 확인하세요.

› VBR이냐 고정 bitrate냐?

VBR은 필요한 곳에 비트를 쓰므로 같은 체감 품질에서 용량이 작습니다. 고정 bitrate는 기기나 프로그램이 요구할 때만 쓰세요.

› 재생목록 전체를 MP3로 바꿀 수 있나요?

가능합니다 —— 오디오 출력에 재생목록 전체 모드를 더하면 됩니다. 기록 파일도 더하면 다시 실행할 때 변환을 되풀이하지 않습니다.