soumatheusgomes/editonny

editonny – Claude Code 및 Codex용 AI 기반 비디오 편집 스킬

개요

오픈 소스 스킬(플러그인)로, 컴퓨터에서 실행되며 원하는 내용을 자연어로 설명하기만 하면 비디오를 편집할 수 있습니다.
Claude Code 및 Codex 에이전트와 함께 작동하여 "일시 중지를 자르고, 캡션을 추가하고, 이 연설 부분을 모션 씬으로 바꿔줘"와 같은 요청을 입력하면 스킬이 무거운 작업을 처리합니다.
모든 전사, 렌더링 및 시각적 처리는 로컬에서 이루어집니다 – 외부 LLM API 키가 필요 없습니다(에이전트 구독이 LLM 호출을 포함).

주요 기능

기능	설명
일시 중지 및 실수 컷	침묵, 호흡, 말실수를 자동으로 감지하여 제거합니다.
캡션 생성	오디오에서 자막을 생성하고 여러 글꼴로 스타일을 지정할 수 있습니다.
오디오 수정 및 리프레이밍	볼륨을 정규화하고, 피사체를 중앙에 유지하면서 다양한 화면 비율로 영상을 리프레이밍할 수 있습니다.
모션 씬	구두 진술을 사전 구축된 애니메이션 "카탈로그" 씬으로 변환합니다(145개 템플릿, 79개 번들 클립).
로컬 전사 및 OCR	로컬 음성-텍스트 모델과 Apple Vision 또는 Tesseract OCR을 사용하여 캡션을 확인합니다.
전체 파이프라인 검증	최종 내보내기 전에 사용자 승인을 위해 8~15초 샘플을 표시합니다.
크로스 플랫폼 설치	원클릭 설치 요청이 Claude Code와 Codex 모두에서 작동합니다. 수동 터미널 설치도 지원합니다.

작동 방식

설치 – 제공된 설치 요청을 Claude Code 또는 Codex에 붙여넣습니다. 에이전트가 리포지토리를 클론하고, Python 환경(uv 통해)을 설정하고, FFmpeg, Node, OCR 도구를 설치하고 모든 것을 검증합니다.
편집 설명 – 짧은 명령을 보냅니다(예: $editonny /videos에서 45초 세로 비디오 편집, 일시 중지 자르기, 캡션 추가).
계획 – 스킬이 영상을 스캔하고 전체 편집 매개변수 세트를 제안하며 확인을 기다립니다.
처리 – 비디오를 자르고, 캡션을 추가하고, 리프레이밍을 적용하고, 선택적으로 음성 텍스트를 기반으로 모션 씬 클립을 삽입합니다.
검토 – 8~~15초 미리보기가 저장됩니다. 최종 MP4가 `~~/Downloads/editonny/<날짜-제목>/exports/`로 내보내기 전에 승인하거나 조정할 수 있습니다.

설치 옵션

에이전트 기반 – README에서 여러 줄 요청을 복사하여 Claude Code(/editonny) 또는 Codex($editonny)에 붙여넣습니다. 에이전트가 클론, 종속성 설치, 등록을 처리합니다.

터미널 –

git clone https://github.com/soumatheusgomes/editonny.git
cd editonny
python3 install.py --target both   # 또는 --target codex / --target claude

그런 다음 제공된 doctor 및 media status 스크립트를 실행하여 설정을 확인합니다.

가이드를 로컬에서 실행

npm ci               # Next.js 가이드 및 디자인 시스템 설치
python3 editonny.py guide   # http://localhost:4173에서 개발 서버 시작

가이드는 다국어(EN/PT-BR/ES) 웹 UI로, 편집 요청을 만들고 모션 씬 카탈로그를 탐색하는 데 도움을 줍니다.

일반적인 사용 사례

프로젝트 구조(높은 수준)

라이선스

도움 받는 곳

editonny를 사용하면 AI 에이전트와 대화하고 완전히 편집된 비디오를 받을 수 있으며, 클라우드 전용 서비스가 필요 없습니다.