YouTube 동영상 다운로더
품질과 형식 설정을 완벽하게 제어하여 YouTube 동영상을 다운로드하세요.
빠른 시작
동영상을 다운로드하는 가장 간단한 방법:
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
이 명령은 최고 화질의 MP4 동영상을 /mnt/user-data/outputs/에 다운로드합니다.
옵션
화질 설정
-q 또는 --quality를 사용하여 동영상 화질을 지정하세요:
best(기본값): 사용 가능한 최고 화질1080p: 풀 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 설치를 자동으로 처리합니다
- 단일 동영상만 다운로드됩니다 (재생 목록은 기본적으로 건너뜁니다)
- 고화질 동영상은 다운로드 시간이 더 오래 걸리고 더 많은 디스크 공간을 사용할 수 있습니다