yt-dlp-gui

URL 기반 다운로드 인터페이스

프로그램 상단의 입력란에 동영상 URL을 붙여넣고 형식 드롭다운에서 원하는 해상도 또는 오디오 전용 옵션을 고른 뒤 다운로드 버튼을 누르면 yt-dlp가 해당 작업을 수행합니다.

프레셋과 구성 파일

저장소 루트의 config.toml 파일에서 [presets] 테이블을 수정해 자주 쓰는 옵션을 키-값 형태로 저장할 수 있으며, preset 값은 문자열 또는 리스트로 정의합니다. 정의한 인자는 기본 yt-dlp 인자에 추가되어 동작합니다.

썸네일 임베드 등 워크플로우

README 예시에는 mp4_thumbnail 프리셋이 제공되어 bv*[vcodec^=avc]+ba[ext=m4a]/b 포맷 선택과 –embed-thumbnail 옵션을 묶어 실행할 수 있습니다.

오류 추적과 디버그 로그

프리셋 실행이 실패하면 같은 위치의 debug.log 파일에서 원인을 확인할 수 있습니다.

포터블 빌드(Windows)

GitHub Releases의 stable 또는 nightly 빌드 ZIP 파일을 내려받아 압축을 해제합니다. ZIP 안에는 실행 파일과 필요한 의존 모듈이 함께 들어 있어 별도 설치 없이 바로 실행할 수 있습니다.

소스 실행(플랫폼 독립)

Python 3.9+가 설치된 환경에서 저장소를 clone한 뒤 requirements.txt를 pip로 설치하고 app 디렉터리의 app.py를 python으로 실행합니다. 이 방법은 Windows뿐 아니라 PySide6가 동작하는 다른 운영체제에서도 사용할 수 있습니다.

winget을 통한 설치

winget 패키지 매니저 사용 환경에서는 winget install –id dsymbol.yt-dlp-gui –exact 명령으로 등록된 빌드를 설치할 수 있습니다.

yt-dlp-gui는 어떤 프로그램인가요?

yt-dlp 명령줄 도구를 그래픽 인터페이스로 감싼 크로스플랫폼 GUI 래퍼로, PySide6로 작성되어 있습니다.

설치 방법은 무엇인가요?

Windows에서는 Releases의 ZIP 포터블 빌드를 그대로 사용할 수 있고, 그 외 환경에서는 Python 3.9+에 requirements.txt를 설치한 뒤 소스에서 실행할 수 있습니다.

FFmpeg가 필요한가요?

동영상·오디오 스트림 병합이나 변환 등 yt-dlp 후처리 단계에서 FFmpeg가 사용되므로 별도 설치가 필요합니다.

프리셋은 어떻게 정의하나요?

저장소 루트의 config.toml 안 [presets] 테이블에 키-값 형태로 옵션을 추가하면 기본 yt-dlp 인자에 덧붙여 실행됩니다.