GitHub – yt-dlp/yt-dlp: A feature-rich command-line audio/video downloader
sudo apt install python3 python3-numpy python3-requests python3 -m venv myenv source myenv/bin/activate pip install yt-dlp every time you open the terminal do the ( source myenv/bin/activate ) before using yt-dlp to download music or video as show in the vi
1. 개요
yt-dlp는 YouTube 및 다양한 동영상 플랫폼에서 동영상 및 오디오를 다운로드할 수 있는 명령 줄 기반 도구입니다. youtube-dl
의 포크(fork)로 출발해 더 빠른 다운로드, 고급 포맷 선택, 자막 포함 등의 기능이 강화되었고 활발히 유지·관리되고 있습니다 GitHub위키백과.
2. 설치 방법
• 공식 릴리스 바이너리 사용 (Unix-like 시스템)
bash복사편집# curl 사용하는 경우:
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp
chmod a+rx ~/.local/bin/yt-dlp
# wget 사용하는 경우:
wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O ~/.local/bin/yt-dlp
chmod a+rx ~/.local/bin/yt-dlp
업데이트는 아래 명령으로:
bash복사편집yt-dlp -U
• pip 사용 (Python 패키지 매니저)
bash복사편집python3 -m pip install -U "yt-dlp[default]"
# --no-deps 옵션으로 불필요한 의존성 제외 가능:
python3 -m pip install --no-deps -U yt-dlp
# 또는 마스터 브랜치(최신 기능) 설치:
python3 -m pip install --force-reinstall "yt-dlp[default] @ https://github.com/yt-dlp/yt-dlp/archive/master.tar.gz"
업데이트도 pip로 간편하게 처리할 수 있습니다 GitHub.
• 패키지 관리자 사용
운영체제에 따라 아래 방법이 가능합니다:
OS | 설치 명령 |
---|---|
Ubuntu/Debian | sudo apt install yt-dlp (PPA 추가 시 최신 버전 유지) |
Arch Linux | sudo pacman -Syu yt-dlp |
Homebrew (macOS/Linux) | brew install yt-dlp |
Snap | sudo snap install --edge yt-dlp |
MacPorts | sudo port install yt-dlp |
Android (Termux) | Termux 설치 후 pip install -U yt-dlp , pkg install ffmpeg (선택) |
GitHub |
3. 주요 사용법 요약
-
기본 다운로드:
yt-dlp URL
예:yt-dlp https://www.youtube.com/watch?v=abcdef
-
플레이리스트 다운로드, 폴더 구조 지정:
bash복사편집
yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "URL" -f 'bv*[height=1080]+ba'
Reddit -
오디오만 추출 & 포맷 지정 (opus 등):
bash복사편집
yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "URL" -f 'ba' -x --audio-format opus
Reddit -
지원되는 포맷 확인:
bash복사편집
yt-dlp -F --list-formats URL
RapidSeedboxOSTechNix -
자막 다운로드:
bash복사편집
yt-dlp --write-subs --sub-langs en URL
RapidSeedbox
4. 설치 권장 사항 및 팁
- FFmpeg 설치 권장: 비디오/오디오 병합 등 후처리 기능 활용 시 필요합니다 GitHubOSTechNix.
-
자주 사용하는 옵션은 구성 파일에 저장 가능:
~/.config/yt-dlp/config
파일에 작성하면 매번 입력할 필요 없이 자동 적용돼 편리합니다 Reddit. - YouTube의 PO Token 이슈: 일부 기능은 PO 토큰이 필요할 수 있으며, 자동 생성 불가능 → 필요한 경우 외부적으로 제공해야 합니다 GitHub.
5. 최신 릴리스 정보
-
2025년 7월 21일 기준 최신 정식 버전: yt-dlp 2025.07.21
-
기본 동작이
--mtime
→--no-mtime
로 변경됨 -
Windows 환경에서
--exec
의 보안 취약점(CVE-2025-54072) 수정 GitHub
-
기본 동작이
- 마스터 브랜치(개발 빌드) 최신 커밋: 2025년 8월 10일 GitHub
요약 및 추천
-
설치 방법: 운영체제 환경에 맞는 방법 선택 (
curl
,pip
, 패키지 관리자 등) - 다운로드 예시: 기본 사용, 오디오/비디오 포맷 지정, 자막 포함 등 다채로운 활용 가능
- 유용 팁: FFmpeg 활용, 구성 파일 자동화, 최신 버전 유지 등