youtube-dl

youtube-dl은 YouTube.com과 수많은 다른 동영상 플랫폼에서 동영상을 다운로드하는 명령줄 프로그램입니다. 파이썬으로 작성되었으며 리눅스, macOS, Windows 등 모든 플랫폼에서 작동하고 Python 2.6/2.7 또는 3.2+가 필요합니다. ## 설치 방법 다양한 방법으로 설치할 수 있습니다: - 직접 바이너리 다운로드: `sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl -o /usr/local/bin/youtube-dl` - pip: `sudo -H pip install --upgrade youtube-dl` - macOS Homebrew: `brew install youtube-dl` - macOS MacPorts: `sudo port install youtube-dl` - Windows: `.exe` 파일을 다운로드하여 PATH에 추가 (System32에는 넣지 마세요). ## 핵심 기능 - 전용 추출기를 사용해 1000개 이상의 지원 사이트에서 동영상과 자막 다운로드. - 범위 선택(`--playlist-start`, `--playlist-end`, `--playlist-items`), 역순, 랜덤 순서 등 전체 플레이리스트 지원. - 해상도, 컨테이너, 코덱, 파일 크기, 재생 시간, 조회수, 날짜 등으로 포맷 선택 및 필터링. - 가짜 X-Forwarded-For 헤더, 사용자 지정 국가 코드, IP 예외 등을 통한 지리 제한 우회. - HTTP/HTTPS/SOCKS 프록시, IPv4/IPv6 강제, 소켓 타임아웃, 사용자 지정 사용자 에이전트 및 리퍼러 등 네트워크 옵션. - 고급 다운로드 상황을 위한 외부 다운로드 프로그램 지원 (aria2c, curl, ffmpeg, wget, axel 등). - 부분적으로 다운로드된 파일 재개; 전체 청크 및 개별 청크 모두 재시도 가능. - 제목, 업로더, 업로드 날짜, 해상도, 포맷 등 다양한 메타데이터 키를 사용하는 출력 파일명 템플릿. - 선택적 출력 artifact: 썸네일(단일 또는 모든 포맷), `.info.json` 메타데이터, `.description` 파일, `.annotations.xml`. ## 일반적인 사용 예시 기본 다운로드: `youtube-dl <URL>` 플레이리스트 5~10번 항목 다운로드: `youtube-dl --playlist-items 5-10 <playlist_URL>` 최고 품질 영상만 다운로드: `youtube-dl -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" <URL>` 출력 템플릿 설정: `youtube-dl -o "%(title)s [%(id)s].%(ext)s" <URL>` 자막 다운로드: 명령에 `--write-subs --sub-langs en` 추가. 다운로드 없이 확인만: `youtube-dl --skip-download <URL>` JSON 메타데이터 덤프: `youtube-dl --dump-json <URL>` 속도 제한: `youtube-dl --limit-rate 50K <URL>` ## 설정 옵션은 설정 파일에 저장할 수 있습니다: - 전역: `/etc/youtube-dl.conf` - 사용자: `~/.config/youtube-dl/config` (Linux/macOS) 또는 `%APPDATA%/youtube-dl/config.txt` (Windows) `--config-location`으로 사용자 지정 경로를 지정하거나, `--ignore-config`로 모든 설정 파일 읽기를 무시할 수 있습니다. ## 임베딩 youtube-dl은 파이썬 라이브러리로 사용 가능하며, 스크립트나 애플리케이션에 추출 및 다운로드 로직을 포함시킬 수 있습니다. ## 라이선스 퍼블릭 도메인으로 공개되었습니다 — 어떠한 방식이든 수정, 재배포, 사용이 자유롭습니다.