TL;DR

이 프로젝트는 yt-dlp의 추출 기능을 Tauri 2 기반 데스크톱 앱으로 포장해 사용자가 명령줄을 직접 작성하지 않고도 URL을 붙여넣어 메타데이터를 미리보고 품질을 선택해 MP4 친화적 파일을 로컬에 저장하도록 설계된 로컬 퍼스트 애플리케이션이다. 내부적으로 프런트엔드는 TypeScript/Vite로 UI를 제공하고 Rust/Tauri 백엔드가 yt-dlp, FFmpeg 같은 앱 관리 툴을 로컬에서 호출하며 tools-manifest.json에 고정된 URL과 SHA-256 해시로 툴 무결성 검증을 수행한다. 결과적으로 이 도구는 서버 기반 호스팅이나 다중 사용자 계정 없이 개인 시스템에서 안전하게 미디어를 수집하고, 쿠키 파일 지원과 설치된 툴의 검증 기능으로 배포 안정성을 확보하지만 멀티유저 동기화나 클라우드 편의 기능은 제공하지 않는다.

주요 기능

• 메타데이터 파싱과 미리보기를 제공해 제목, 썸네일, 재생 시간, 원본 URL, 설명과 선택 가능한 품질 목록을 GUI에서 확인할 수 있다. 이 과정은 내부적으로 yt-dlp를 호출해 사이트 지원 목록에 따른 추출기를 이용해 수행된다. 사용자는 별도의 CLI 옵션 작성 없이 품질을 선택하고 다운로드를 시작할 수 있다.
• 실시간 다운로드 진행률, 전송 속도, 예상 완료 시간(ETA), 취소 기능을 제공해 다운로드 상태를 데스크톱 인터페이스에서 모니터링하고 제어할 수 있다. 다운로드 완료물은 사용자가 선택한 출력 폴더에 저장되며 'Open folder' 버튼으로 빠르게 접근할 수 있다. 로그는 로컬에 보관되어 최근 앱 활동을 확인할 수 있다.
• 앱 설정에서 Netscape 형식의 cookies.txt 파일이나 한 줄 브라우저 Cookie 헤더를 사용해 인증이 필요한 사이트에서 동작하도록 쿠키를 적용할 수 있다. 이 기능은 로그인 세션을 요구하는 비공개·유료 콘텐츠를 로컬 yt-dlp 호출에 연계할 때 사용된다. 쿠키 파일은 사용자가 제공한 로컬 자원으로 처리되며 서버 전송이나 클라우드 동기화는 수행하지 않는다.
• 앱이 관리하는 툴체인을 설치·업데이트·재설치·검증할 수 있는 기능을 포함해 yt-dlp, ffmpeg, ffprobe, deno 같은 도구를 플랫폼별로 관리한다. 툴 설치 시 tools-manifest.json에 고정된 소스 URL과 SHA-256 해시로 무결성 검증을 수행한다. 개발자는 Settings에서 도구를 복원하거나 검증 실패 시 다시 설치하는 절차를 실행할 수 있다.

어떻게 동작하는가

프런트엔드는 Vite와 TypeScript로 구현된 고정 크기 데스크톱 UI이며, 네이티브 런타임과 시스템 I/O는 Tauri 2의 Rust 백엔드가 담당한다. 사용자가 URL을 붙여넣고 Parse를 누르면 내부적으로 yt-dlp를 호출해 메타데이터와 이용 가능한 포맷을 추출하고, 사용자가 품질을 선택하면 yt-dlp와 (필요 시) FFmpeg를 로컬에서 실행해 파일을 생성한다. 툴 설치와 검증은 src-tauri/tools-manifest.json에 고정된 URL과 SHA-256 해시를 참고해 앱이 관리하는 디렉토리에 바이너리를 내려받아 수행한다.

해결 문제

명령줄 옵션을 직접 작성하지 않고도 yt-dlp의 역량을 데스크톱 환경에서 간편하게 활용하도록 인터페이스를 제공한다. 이 앱은 URL 기반 메타데이터 미리보기와 포맷 선택, 다운로드 진행 제어를 통합해 사용자가 복잡한 CLI 인수 없이 파일을 획득하도록 한다. 또한 도구 체인을 앱 내부에서 설치·검증·관리함으로써 개발자와 사용자가 개별 바이너리 관리에 소요하는 수고를 줄였다.

차별점

• 로컬 퍼스트(desktop-first, local-first) 디자인을 채택해 모든 다운로드와 툴 실행이 사용자 시스템에서 이루어지며 외부 호스팅 서비스나 계정 연동을 제공하지 않는다. 이 접근은 개인정보나 미디어 파일을 외부 서버로 전송하지 않도록 하여 로컬 보안·프라이버시 요구에 부합한다. 결과적으로 멀티유저나 클라우드 동기화 기능을 제공하지 않아 서비스형 다운로더와 차별화된다.
• 설치된 툴의 무결성 검증을 위해 tools-manifest.json에 고정된 소스 URL과 SHA-256 해시를 사용해 바이너리를 검증하는 절차를 포함했다. 이 검증은 앱이 자체적으로 툴을 설치할 때 해시 불일치 시 재설치나 경고를 발생시켜 임의 바이너리 사용을 방지한다. 고정 매니페스트 방식은 최신 대신 검증된 릴리스 URL을 명시하도록 유도해 배포 안정성을 높인다.
• 간단한 GUI 중심 워크플로우를 제공해 URL 붙여넣기, Parse로 메타데이터 미리보기, 드롭다운에서 품질 선택, Download 버튼으로 즉시 파일 생성까지 직관적으로 연결했다. 이 UI 흐름은 yt-dlp 명령어와 인수 구성을 몰라도 동일한 결과를 얻도록 설계되어 동작의 진입 장벽을 낮춘다. 또한 언어 전환(영어/중국어)과 로그·출력 폴더 제어 같은 데스크톱 특화 편의 기능을 포함했다.

사용 사례

• 단일 사용자 환경에서 유튜브나 yt-dlp가 지원하는 다른 사이트의 동영상을 GUI로 손쉽게 저장하려는 경우에 적합하다. 사용자는 복잡한 인수 없이 URL을 붙여넣고 원하는 품질을 선택해 MP4 친화적 파일을 얻을 수 있다. 로컬에 툴을 설치하고 검증하는 기능이 있어 로컬 개발자 환경이나 개인용 미디어 보관용으로 유용하다.
• 회사 네트워크나 교육용 컴퓨터 등에서 중앙 서버 없이 로컬에서 미디어를 수집하고 보관해야 할 때 유용하다. 쿠키 파일 지원으로 인증된 강의나 멤버십 콘텐츠의 다운로드를 로컬에서 처리할 수 있어 수동으로 CLI를 관리하기 어려운 환경에서 작업 시간을 단축한다. 로그와 출력 폴더 관리를 통해 다운로드 기록을 검사하고 파일을 정리하는 워크플로우를 구성할 수 있다.
• 개발 중인 Tauri 기반 데스크톱 앱이나 yt-dlp 연동 사례를 참고하여 비슷한 툴체인 관리 방식을 구현하려는 엔지니어가 레퍼런스로 활용할 수 있다. tools-manifest.json과 설치 스크립트 구조는 배포 가능한 도구 설치·검증 파이프라인 샘플로 재사용 가능하다. 또한 Windows NSIS와 macOS DMG 타깃을 포함한 빌드 설정은 멀티플랫폼 릴리스 파이프라인 구성에 참고가 된다.

시작하기

Windows 10/11(또는 macOS)에서 Node.js 24+와 Rust 안정 도구체인을 준비한 뒤 저장소를 체크아웃하고 의존성을 설치해야 한다. 의존성 설치는 npm ci로 수행하고 개발용 툴 복원은 .\scripts\download-tools.ps1을 실행하거나 앱의 Settings에서 Install tools를 클릭해 수행할 수 있다. 개발 중 실행은 npm run tauri dev로 하고, 설치 이미지를 빌드하려면 npm run tauri build를 실행하면 NSIS 또는 DMG 형태의 번들이 생성된다.

요구사항

• 운영체제는 Windows 10/11에서 WebView2 Runtime이 필요하거나 macOS가 필요하다. Node.js 24 이상이 프런트엔드 빌드와 Tauri 개발 도구를 위해 요구되며 Rust stable과 플랫폼용 툴체인이 빌드 환경에 필요하다. Windows에서는 PowerShell 5 이상 또는 PowerShell 7 이상이 권장되며, 릴리스 설치 이미지는 대상 플랫폼에서 빌드하거나 GitHub Actions 릴리스 워크플로로 생성해야 한다.

이미지 분석