jipraks/yt-short-clipper

Windows desktop app that turns long-form YouTube videos into 9:16 short-form clips — AI highlight detection, face-tracking portrait reframe, and word-by-word captions.

YT Short Clipper v2 – 무엇인가요

Windows 전용 데스크톱 앱으로 긴 YouTube 동영상을 9:16 세로형 짧은 클립으로 자동 변환합니다. 동영상을 다운로드하고 원본 자막을 가져와 LLM에 트랜스크립트를 분석하게 하여 하이라이트 세그먼트를 추출하고, 각 세그먼트를 자르고 세로(9:16)로 재프레임하며, 단어별 자막을 직접 삽입하고, 결과물을 Repliz에 업로드할 수 있습니다. React + TypeScript, Tauri(Rust), Python 사이드카( yt‑dlp, FFmpeg, MediaPipe)로 구축되었으며, OpenAI 호환 모델이나 앱 내 지갑 기반 AI 서비스를 지원합니다. MIT 라이선스, 베타 단계, Windows 전용입니다.

핵심 워크플로우

YouTube URL을 붙여넣기하고 로그인된 YouTube 세션에서 cookies.txt 파일을 제공합니다 (yt‑dlp가 동영상과 원본 자막을 가져오기 위해 필수).
yt‑dlp가 동영상과 자막 트랙을 다운로드합니다.
LLM (어떤 OpenAI 호환 엔드포인트든 또는 앱 내 지갑 기반 서비스)가 트랜스크립트를 분석하고 하이라이트 세그먼트를 제안합니다 (기본 길이: 58~120초).
각 세그먼트는 자르기, MediaPipe를 통한 얼굴 추적, 검은 줄 중심, 또는 흐림 채우기 모드 중 하나로 9:16 세로형으로 재프레임, 그리고 원본 자막에서 단어별 자막을 삽입합니다.
선택적으로 클립을 Repliz 소셜미디어 플랫폼에 업로드하고 스케줄링합니다.

주요 기능

AI 기반 하이라이트 탐지 – 어떤 OpenAI 호환 모델에도 대응 가능. LLM은 전체 트랜스크립트를 받고 시간 범위를 반환합니다.
프롬프트 수준의 지시 – 자유 텍스트로 "지시"를 입력해 특정 시간대를 강제하거나, 주제 우선순위를 지정하거나, 특정 콘텐츠를 제외할 수 있습니다.
자동 제목/후크 생성 – 동일한 LLM이 동영상 언어에 맞는 짧은 제목과 후크 텍스트도 제안할 수 있습니다.
세로 재프레임 모드 3가지 –
- 얼굴 추적 (MediaPipe) – 프레임 단위 감지로 최적의 프레임.
- 검은 줄 중심 – 빠르고 기존 줄을 활용.
- 흐림 채우기 중심 – 빠르고 빈 공간을 흐림으로 채움.
단어별 자막 – YouTube의 자막 파일에서 직접 가져옴. Whisper나 기타 음성 인식 모델이 필요 없음.
오버레이 옵션 – 후크 텍스트 오버레이, 로고/크레딧 워터마크.
직접 업로드 – Repliz로 1클릭 업로드.
AI 결제 모델 2가지 –
1. 앱 내 지갑 (QR 코드 충전, API 키 필요 없음).
2. 사용자 제공 API 키 (OpenAI, Gemini, Groq, ApiSmart, Ollama, vLLM 등).
투명한 텔레메트리 – README에 모든 외부 엔드포인트와 전송되는 데이터 목록이 표시되어 있습니다.

기술 스택

계층	기술
UI / 프론트엔드	React 19, TypeScript, Vite
데스크톱 쉘	Tauri v2 (Rust) – WebView2 기반 창 제공 및 포터블 zip로 앱 패키징
미디어 처리	Python 사이드카 (yt‑dlp, FFmpeg, MediaPipe)
AI 통합	어떤 OpenAI 호환 엔드포인트나 `ai.ytclip.org`에서 접근 가능한 고유의 "앱 내 AI" 서비스도 지원
빌드/패키징	Node /npm, Rust cargo, Python, PowerShell 스크립트 (FFmpeg/Deno 바이너리 다운로드용)

시작하기 (README에서)

# 1. Node, Rust, Python (3.13+) 설치 및 Windows 10/11에 PowerShell 설치 확인
npm install                     # Node 종속성
py -m pip install -r requirements.txt   # Python 종속성
powershell -ExecutionPolicy Bypass -File scripts/fetch-deps.ps1   # FFmpeg, Deno 등 다운로드
npm run build:sidecar          # Python 사이드카를 .exe로 고정

이후 개발 모드로 앱 실행 가능:

npm run dev          # Vite 개발 서버 (프론트엔드)
npm run tauri dev   # Tauri 창 실행

본격 빌드를 위해:

npm run release      # src‑tauri/target/release/bundle/에 두 개의 포터블 zip 번들 생성

제한 사항 / 주의사항

Windows 전용 – 빌드 스크립트, 바이너리 패키징, 폰트 처리는 모두 Windows 전용이며, macOS/Linux 지원은 아직 없음.
YouTube 쿠키 필요 – 로그인된 브라우저에서 cookies.txt를 내보내야 함. 이 파일은 비밀번호처럼 취급됨.
AI 비용 – 앱 내 지갑 또는 외부 API 사용 시 사용료 발생. 지갑은 복구 불가.
베타 상태 – README에 리リ스 간 불안정성과 파괴적 변경 사항에 대한 경고 있음.
텔레메트리 – Google Analytics에 랜덤 설치 UUID, 앱 버전, 클립 길이, 재프레임 모드 전송. 동영상 콘텐츠는 전송되지 않음.
Repliz 업로드 – 선택 사항이며, Repliz 계정/키 필요.

누구에게 유용할까?

긴 YouTube 동영상을 TikTok/YouTube Shorts 스타일의 세로 클립으로 리포지셔닝하고 싶은 콘텐츠 크리에이터.
소규모 팀이 소셜미디어용 캡션 포함 짧은 클립을 빠르게 AI로 생성하고 싶은 경우.
React + Tauri + Python 사이드카 + LLM 호출을 데스크톱 앱에서 구현한 실용적인 예제에 관심 있는 개발자.

라이선스 및 법적 주의사항

요약

무엇：YouTube 동영상을 자동으로 9:16, 캡션 포함 짧은 클립으로 생성하는 Windows 데스크톱 앱.
방법：yt‑dlp로 동영상과 자막 다운로드, LLM으로 트랜스크립트 분석하여 하이라이트 추출, FFmpeg/MediaPipe로 자르고 재프레임, 단어별 자막 추가, 필요 시 Repliz에 업로드.
기술：React + TypeScript 프론트엔드, Tauri(Rust) 쉘, Python 사이드카(yt‑dlp, FFmpeg, MediaPipe), 어떤 OpenAI 호환 LLM도 지원.
상태：베타, Windows 전용, MIT 라이선스.