YouTube 동영상 다운로더
품질과 형식 설정을 완전히 제어하여 YouTube 동영상을 다운로드합니다.
빠른 시작
가장 간단한 동영상 다운로드 방법:
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
이 명령은 최고 품질의 동영상을 MP4 형식으로 /mnt/user-data/outputs/에 다운로드합니다.
옵션
품질 설정
-q 또는 --quality를 사용하여 동영상 품질을 지정합니다:
best(기본값): 사용 가능한 최고 품질1080p: Full HD720p: HD480p: 표준 화질360p: 낮은 화질worst: 사용 가능한 최저 품질
예시:
python scripts/download_video.py "URL" -q 720p
형식 옵션
-f 또는 --format을 사용하여 출력 형식을 지정합니다(동영상 다운로드 전용):
mp4(기본값): 가장 호환성이 좋음webm: 최신 형식mkv: Matroska 컨테이너
예시:
python scripts/download_video.py "URL" -f webm
오디오 전용
-a 또는 --audio-only를 사용하여 MP3 오디오만 다운로드합니다:
python scripts/download_video.py "URL" -a
사용자 지정 출력 디렉토리
-o 또는 --output을 사용하여 다른 출력 디렉토리를 지정합니다:
python scripts/download_video.py "URL" -o /path/to/directory
전체 예시
- 1080p MP4 동영상 다운로드:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
- MP3 오디오 전용 다운로드:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
- 720p WebM 형식으로 사용자 지정 디렉토리에 다운로드:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path
작동 방식
이 스킬은 강력한 YouTube 다운로더인 yt-dlp를 사용합니다:
- 설치되어 있지 않으면 자동으로 설치
- 다운로드 전 동영상 정보를 가져옴
- 기준에 맞는 최고 품질의 스트림을 선택
- 필요 시 비디오와 오디오 스트림을 병합
- 다양한 YouTube 동영상 형식을 지원
중요 참고 사항
- 다운로드는 기본적으로
/mnt/user-data/outputs/에 저장됩니다 - 동영상 파일 이름은 동영상 제목에서 자동 생성됩니다
- 스크립트는 yt-dlp 설치를 자동으로 처리합니다
- 단일 동영상만 다운로드됩니다(재생 목록은 기본적으로 건너뜁니다)
- 고품질 동영상은 다운로드 시간이 더 오래 걸리고 디스크 공간을 더 많이 사용할 수 있습니다