ComposioHQ/youtube-downloader

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 HD
• 720p: HD
• 480p: 표준 화질
• 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

전체 예시

1. 1080p MP4 비디오 다운로드:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p

2. 오디오만 MP3로 다운로드:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a

3. 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 설치를 자동으로 처리합니다
• 단일 비디오만 다운로드됩니다 (재생 목록은 기본적으로 건너뜀)
• 고화질 비디오는 다운로드 시간이 더 오래 걸리고 더 많은 디스크 공간을 사용할 수 있습니다