YTSage

핵심 다운로드 기능

YTSage는 YouTube 영상을 다양한 화질과 형식으로 다운로드할 수 있으며, 오디오만 추출하여 음악 파일로 저장할 수도 있습니다. 자막을 선택하여 다운로드하거나 영상에 직접 병합할 수 있으며, 재생목록 전체 또는 선택된 영상만 다운로드하도록 설정할 수 있습니다.

고급 기능

SponsorBlock 통합을 통해 광고 구간을 자동으로 건너뛸 수 있으며, 영상의 특정 구간만 잘라내어 다운로드하는 트리밍 기능도 제공합니다. 챕터 정보를 영상 메타데이터에 내장하거나, 썸네일과 설명을 별도 파일로 저장할 수 있습니다. 또한 Generic Mode를 활성화하면 yt-dlp가 지원하는 다른 사이트(예: Dailymotion, TikTok 등)에서도 사용할 수 있습니다.

출력 및 파일 설정

사용자는 출력 파일 이름 형식을 커스터마이징할 수 있으며(%(title)s, %(uploader)s 등의 변수 사용 가능), 비디오 컨테이너 형식(MP4, MKV, WebM 등)을 강제 지정할 수 있습니다. 오디오 전용 다운로드 시 다양한 형식(MP3, AAC, FLAC, Opus 등)으로 변환할 수 있으며, EBU R128 표준에 따른 오디오 정규화도 적용할 수 있습니다. 다운로드 속도 제한 및 동시 연결 수 조절을 통해 네트워크 사용을 관리할 수 있습니다.

다운로드·설치 방법

Windows 사용자를 위한 설치는 세 가지 주요 방법으로 제공됩니다. 먼저 실행 파일 설치자(.exe)를 다운로드하여 더블클릭하면 setup wizard가 안내에 따라 설치를 완료합니다. 둘째, 포터블 버전(.zip)을 원하는 폴더에 압축 해제한 후 ytsage.exe를 직접 실행하여 설치 없이 사용할 수 있습니다. 셋째, FFmpeg가 포함된 버전을 선택하면 별도의 FFmpeg 설치 없이도 고품질 영상과 오디오 스트림을 병합하여 저장할 수 있습니다.

기본 사용법/명령어

YTSage를 실행한 후, 다운로드하고 싶은 YouTube 영상의 URL을 입력창에 붙여넣고 ‘Analyze’ 버튼을 클릭합니다. 분석이 완료되면 ‘Video’ 또는 ‘Audio Only’ 중 원하는 형식을 선택하고, 자막 언어 선택, 썸네일 저장, SponsorBlock 활성화 등의 옵션을 조정합니다. 출력 디렉토리를 지정한 후 ‘Download’ 버튼을 누르면 다운로드가 시작되며, 기본적으로 사용자의 ‘Downloads’ 폴더에 파일이 저장됩니다.

플레이리스트 다운로드 방법

플레이리스트 URL을 입력하고 ‘Analyze’를 클릭하면 영상 목록이 표시됩니다. 여기서 전체 선택 또는 개별 영상을 선택한 후 원하는 형식과 품질을 설정하고 다운로드를 시작할 수 있습니다. 다운로드 완료 후 재생목록을 .txt, .csv, .m3u, .json 형식으로 내보낼 수 있습니다.

Generic Mode 사용법

YouTube以外의 사이트에서 영상을 다운로드하려면 ‘Download Settings’에서 ‘Generic Mode’를 켜야 합니다. 활성화 후 지원되는 사이트의 URL을 입력하고 일반적인 절차에 따라 분석 및 다운로드를 진행하면 됩니다. 다만 대상 사이트가 설치된 yt-dlp 버전에서 지원되어야 하며, 일부 사이트는 쿠키나 프록시 설정이 추가로 필요할 수 있습니다.

지원 환경·시스템 요구사항

YTSage는 Windows 10 이상에서 실행되며, Python 3.11 이상이 필요합니다. 실행 파일 버전의 경우 Python이 사전에 설치되어 있지 않아도 사용할 수 있으나, 소스 코드로부터 설치하거나 pip를 통한 설치 시에는 Python 환경이 필수적입니다. 고품질 영상 다운로드를 위해서는 영상과 오디오 스트림을 병합하기 위한 FFmpeg가 시스템에 설치되어 있어야 하며, 이는 FFmpeg가 포함된 버전을 다운로드하거나 별도로 설치하여 해결할 수 있습니다.

최신 버전·업데이트

현재 버전은 5.5.0이며, GitHub 저장소의 ‘Releases’ 페이지에서 최신 버전을 확인할 수 있습니다. 애플리케이션 내부에는 ‘Updater Tab’이 내장되어 있어 yt-dlp의 안정版 또는 나이트리 채널 간 전환 및 업데이트 확인을 한 곳에서 관리할 수 있습니다. 또한 FFmpeg 및 Deno 런타임 버전도 확인하고 관련 설치 가이드로 이동할 수 있는 기능이 제공됩니다.

제한 사항·확인 사항

FFmpeg가 설치되지 않았거나 시스템 경로에 등록되지 않은 경우, 고화질 영상 다운로드 시 영상과 오디오가 별도 파일로 저장될 수 있습니다. 이 문제를 해결하려면 FFmpeg를 설치하고 PATH에 등록하거나, YTSage 공식 배포판 중 FFmpeg가 포함된 버전을 다운로드하여 사용해야 합니다. 일부 antivirus 소프트웨어에서 실행 파일을 오탐지할 수 있으나, 이는 패키징된 애플리케이션에 흔히 발생하는 현상으로, pip 설치를 이용하거나 소스로부터 빌드하여 false positive를 피할 수 있습니다.