<p align="center">
<a href="https://www.supoclip.com">
<img src="https://raw.githubusercontent.com/FujiwaraChoki/supoclip/HEAD/assets/banner.jpg" alt="SupoClip dashboard with video input, caption controls, and recent clips" width="100%" />
</a>
</p>
<h3 align="center">OpusClip 따위는 집어치워라.</h3>
<p align="center">
... 좋은 비디오 클립은 보기 흉한 워터마크나 플랫폼 종속성을 가져서는 안 되기 때문이다.
</p>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" alt="라이선스: AGPL-3.0" /></a>
<a href="https://www.supoclip.com"><img src="https://img.shields.io/badge/hosted-supoclip.com-black.svg" alt="supoclip.com에 호스팅됨" /></a>
<a href="docs/README.md"><img src="https://img.shields.io/badge/docs-docs%2F-green.svg" alt="문서화" /></a>
</p>
<p align="center">
<a href="https://apps.apple.com/us/app/supoclip/id6784760040">
<img src="https://raw.githubusercontent.com/FujiwaraChoki/supoclip/HEAD/frontend/public/app-store-badge.svg" alt="App Store에서 SupoClip 다운로드" height="40" />
</a>
<a href="https://www.producthunt.com/products/supoclip?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-supoclip" target="_blank" rel="noopener noreferrer">
<img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1276786&theme=dark" alt="Product Hunt의 SupoClip" height="40" />
</a>
</p>
SupoClip은 오픈 소스 기반의 AI 구동 비디오 클리핑 도구입니다. 팟캐스트, 강연, 스트림 VOD 등 긴 비디오를 제공하면, 가장 바이럴성이 높은 순간들을 찾아내고 점수를 매긴 다음, 얼굴 중심 크롭(face-centered cropping), 단어 동기화 자막(word-synced subtitles), 후크 제목(hook titles), 선택적 B-롤(optional B-roll)이 포함된 세로형 9:16 클립으로 렌더링합니다. 직접 실행하고, 사용자 정의하며, 검사할 수도 있고— 또는 호스팅된 버전을 사용하여 설정 단계를 건너뛸 수도 있습니다.
가장 먼저 확인하세요: watch real clips SupoClip generated에서 생성된 장편 인터뷰 실제 클립을 시청하거나, [self-hosting tutorial]을 따라 자신만의 기기에서 실행할 수 있습니다.
SupoClip 사용 방법
SupoClip이 존재하는 이유
OpusClip은 AI 클립 선택, 정확한 자막, 바이럴리티 스코어링 면에서 정말 뛰어납니다. 하지만 사용량은 플랜별로 측정되며, 일부 내보내기 파일에는 플랫폼 브랜딩이 포함되고, 사용자 콘텐츠와 워크플로우는 해당 서비스의 약관에 따라 그들의 서버에 존재합니다.
SupoClip은 이러한 제약 없이 동일한 핵심 파이프라인을 제공합니다:
- 자가 호스팅 가능 (Self-hostable) — 자체 하드웨어에서 실행하고, 처리할 수 있는 만큼 많은 양을 처리합니다.
- 워터마크 없음 (No watermarks) — 콘텐츠는 사용자 소유로 유지됩니다.
- 오픈 소스 (Open source) — AGPL-3.0, 완전한 투명성, 원하는 대로 포크(fork)하고 확장할 수 있습니다.
- 호스팅 옵션 (Hosted option) — 서버 관리를 원치 않을 때 클라우드 버전을 사용할 수 있습니다.
기능
-
YouTube, Twitch, Kick 및 업로드 파일 — YouTube 비디오, Twitch VOD 또는 클립, 또는 Kick VOD 또는 클립을 붙여넣거나 자체 파일을 업로드하세요 (실시간 스트리밍은 지원하지 않습니다). Twitch와 Kick 다운로드 제공업체 및 선택적 Apify 폴백(fallback) 설정은 [docs/configuration.md]에서 확인할 수 있습니다.
-
AI 클립 선택(AI clip selection) — LLM(Gemini, GPT, Claude 또는 로컬 Ollama 모델)이 스크립트에서 가장 클립으로 적합한 3~7개 세그먼트를 자동으로 선택합니다.
-
바이럴리티 점수 측정(Virality scoring) — 모든 클립에 후크(hook), 참여도(engagement), 가치(value), 공유 가능성(shareability) 점수가 부여됩니다.
-
스마트 수직 크롭(Smart vertical cropping) — 얼굴 감지 기능이 화자를 9:16 프레임 중앙에 유지합니다.
-
단어 동기화 자막(Word-synced subtitles) — AssemblyAI의 단어별 타임스탬프, 사용자 지정 글꼴, 애니메이션 스타일을 갖춘 캡션 템플릿을 제공합니다.
-
후크 제목(Hook titles) — AI가 작성한 헤드라인이 각 클립 시작 몇 초 동안 상단에 표시됩니다.
-
B-roll 및 전환 효과(B-roll & transitions) — 선택적 Pexels 스톡 영상 오버레이와 다양한 전환 효과를 적용할 수 있습니다.
-
내장 편집기(Built-in editor) — 클립 자르기, 분할, 병합이 가능하며, 플랫폼 프리셋(TikTok, Reels, Shorts)으로 내보낼 수 있습니다.
-
직접 게시(Direct publishing) — 사용자의 YouTube, TikTok 및 Instagram 계정을 연결하고 작업 페이지에서 클립을 게시하거나 예약합니다.
-
성과 루프(Performance loop) — 조회수, 좋아요, 댓글, 공유가 각 플랫폼에서 시스템으로 다시 유입되어 미래의 클립 선택 방향을 청중에게 효과적인 것으로 안내합니다.
-
실시간 진행 상황(Real-time progress) — 비디오 처리가 진행되는 동안 브라우저로 실시간 파이프라인 업데이트를 스트리밍합니다.
빠른 시작 (Quick Start)
Docker, 스크립트 변환을 위한 AssemblyAI API 키, 그리고 LLM 제공업체 키 하나(Google, OpenAI, Anthropic 또는 로컬 Ollama)가 필요합니다.
git clone https://github.com/FujiwaraChoki/supoclip.git
cd supoclip
루트 디렉터리에 .env 파일을 만들고 키를 입력하세요:
ASSEMBLY_AI_API_KEY=your_assemblyai_api_key
LLM=google-gla:gemini-3-flash-preview
GOOGLE_API_KEY=your_google_api_key
그런 다음 모든 것을 시작합니다:
첫 실행에는 몇 분이 걸립니다. docker-compose logs -f로 진행 상황을 확인하세요. 정상 작동하면 http://localhost:3107에 접속하여 계정을 만들고 클리핑을 시작합니다. 백엔드 API는 http://localhost:8000에 위치하며, /docs에서 대화형 문서를 확인할 수 있습니다.
이 템플릿은 FRONTEND_PORT=3107로 설정합니다. 이 설정이 없는 기존 배포는 포트 3001을 유지하므로, 프로덕션 리버스 프록시가 해당 포트를 사용하는 경우 그 포트를 보존하십시오. 사용자 지정 포트 및 공개 URL은 설정 가이드를 참조하십시오.
Whisper 및 Ollama와 함께 완전히 로컬로 실행하려면 (Ollama가 필요로 하는 Docker 네트워킹 포함), 셀프 호스팅 튜토리얼을 참조하십시오. 다른 LLM 제공업체를 사용하거나 선택적 구성 요소(B-roll, 분석, 이메일, YouTube 메타데이터)를 구성하려면 구성 가이드를 참조하십시오. 문제가 발생하면, 문제 해결 가이드에서 일반적인 실패 모드를 다룹니다.
문서화 (Documentation)
이 페이지를 넘어서는 모든 내용은 docs/에 있습니다:
| 가이드 | 내용 |
|---|
| Setup | Docker-first 설치, 로컬 개발, 첫 실행 체크리스트 |
| ... | |
