YouTube 및 다양한 동영상 플랫폼에서 동영상 및 오디오를 다운로드

GitHub – yt-dlp/yt-dlp: A feature-rich command-line audio/video downloader

https://youtu.be/8NU1zdTV6_M

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

GitHub


• 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/Debiansudo apt install yt-dlp (PPA 추가 시 최신 버전 유지)
Arch Linuxsudo pacman -Syu yt-dlp
Homebrew (macOS/Linux)brew install yt-dlp
Snapsudo snap install --edge yt-dlp
MacPortssudo 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 활용, 구성 파일 자동화, 최신 버전 유지 등