AI 튜토리얼

heditor로 토킹헤드 영상을 세로 릴스로 전환하는 방법

클래스, 팟캐스트, 라이브 방송 및 기타 토킹헤드 녹화 영상을 동기화된 자막, 모션 그래픽, 효과음, 음악, 자동 품질 검사를 포함한 1080×1920 세로 영상으로 변환하는 오픈 Agent Skill heditor의 설치 및 사용 방법을 알아보세요.

2026년 10월 14일약 13분 소요

heditor란?

heditor는 말하는 사람의 모습이 담긴 영상을 세로형 Reels, Shorts, TikToks로 변환하는 개방형 SKILL.md 기반 에이전트 스킬입니다. Claude Code, Codex, OpenCode, Cursor, Hermes와 같은 에이전트에서 사용할 수 있습니다.

모든 편집을 수동으로 조합하는 대신, 에이전트에 영상과 편집 방향을 전달하면 됩니다. heditor는 녹화 영상을 분석하고, 화자를 식별하며, 단어 단위 타이밍으로 오디오를 전사하고, 약 30~70초 분량의 완결된 구간을 선택한 뒤 세로형 1080×1920 구성을 만듭니다.

이 워크플로는 로컬에서 실행되며 프레임 단위의 정확한 컷, 음성 처리, 동기화된 자막, 모션 그래픽, 음향 효과, 음악, 자동 검사를 결합합니다. 시각적 구성은 HTML과 GSAP으로 만들고 HyperFrames로 렌더링합니다.

주요 기능

Reels, Shorts, TikToks용 세로형 1080×1920 출력.
단어 단위로 동기화되는 자막과 음성 인식 기반 편집.
프레임 단위로 정확한 카메라 및 음성 컷과 짧아진 무음 구간.
음성의 의미를 중심으로 설계된 모션 그래픽과 장면 전환.
음성을 우선하는 오디오 믹싱. 음악과 효과음은 −14 LUFS를 목표로 배경에 배치.
린트, 테스트, 미리보기, 안전 여백, 음량, 트루 피크, 최종 오디오 전사, 40프레임 콘택트 시트에 대한 자동 품질 검사.
11가지 명명된 스타일: cinema, ruptura, impacto, game, thriller, ide, aeroporto, chat, documentario, podcast, missao.

편집 모드 선택

고정 스타일

고정 스타일은 특정 영상에 맞춰 장면을 다시 구성하면서 기존의 시각적 언어를 적용합니다. 예를 들어 에이전트에 aeroporto 스타일로 클립을 편집해 달라고 요청할 수 있습니다. 결과물은 관제탑 콘셉트, 레이더 요소, 출발 안내판 스타일의 타이포그래피, 무전기 같은 자막을 사용하지만 스타일을 경직된 템플릿처럼 다루지는 않습니다.

크리에이티브 모드

크리에이티브 모드에서 에이전트는 영상을 분석하고, 6~8개의 형식 콘셉트를 만들며, 참고 자료를 조사한 뒤 음성에 맞으면서 가장 놀라운 콘셉트를 선택해 맞춤형 시각 세계를 구축합니다. 이 워크플로는 약 1.5~2초마다 시각 요소를 자주 바꾸고, 음향 효과로 화면 속 동작을 뒷받침하는 것을 목표로 합니다.

레퍼런스를 활용한 크리에이티브 모드

게임, 애니메이션 오프닝, 뉴스 방송, 자연 다큐멘터리와 같은 레퍼런스를 제공할 수 있습니다. 예를 들어 GTA 6 스타일의 크리에이티브 모드를 요청할 수 있습니다. heditor는 레퍼런스의 색상 팔레트, 타이포그래피, 인터페이스 요소, 움직임, 사운드 언어를 조사한 뒤 보호되는 로고, 캐릭터, 브랜드, 음악을 사용하지 않고 라이선스에 안전한 오마주를 만듭니다.

레퍼런스는 보호되는 자산을 복제해 달라는 요청이 아니라 창작 방향으로 활용하세요.

설치 및 설정

권장 설치 프로그램

설치 프로그램은 지원되는 에이전트를 감지하고, 각 에이전트에 스킬을 연결하며, 로컬 환경을 준비하고, 진단 명령을 실행합니다.

curl -fsSL https://raw.githubusercontent.com/pycodebr/heditor/main/install.sh | bash

설정 중 heditor는 지원되는 패키지 관리자를 통해 FFmpeg, Node.js 18 이상, Python 3.10~3.13, Git, curl과 같은 누락된 도구를 설치할 수 있습니다. 또한 ~/.heditor/venv에 Python 환경을 만들고, HyperFrames와 Chrome을 준비하며, 필요한 모델과 에셋을 다운로드하고, ~/.heditor/env.sh를 만들며, heditor 명령을 설치합니다.

설치 프로그램은 에이전트 선택, 링크 대신 복사, 오디오 에셋 건너뛰기, 설정 건너뛰기와 같은 옵션을 지원합니다.

bash install.sh --agent claude
bash install.sh --agent all
bash install.sh --copy
bash install.sh --no-audio
bash install.sh --no-setup

Skills CLI로 설치

Vercel Skills CLI로 스킬을 설치한 다음 설정 스크립트를 실행할 수도 있습니다.

npx skills add pycodebr/heditor -g
bash ~/.agents/skills/heditor/scripts/setup.sh

수동 설치

git clone https://github.com/pycodebr/heditor.git
cd heditor
bash install.sh --agent claude

또는 skills/heditor 디렉터리를 에이전트가 사용하는 스킬 위치에 복사하세요.

브랜드 설정

heditor는 ~/.heditor/brand.json에서 브랜드 설정을 읽습니다. 이 파일에서 편집에 사용할 이름, 핸들, 로고, 언어, 행동 유도 문구, 시각적 색상을 정의할 수 있습니다.

{
  "name": "Your Brand",
  "handle": "@yourprofile",
  "logo": "/path/to/logo.png",
  "lang": "en",
  "follow": "Follow",
  "following": "Following",
  "comment": "Tell us in the comments",
  "colors": {
    "bg": "#050a14",
    "bg2": "#081626",
    "accent": "#edc580",
    "accent2": "#7dd3fc",
    "alert": "#ff3d57",
    "ok": "#7dffb0"
  }
}

콘텐츠의 대상 시청자에 맞게 언어와 행동 유도 문구 필드를 설정하세요. 로고 경로는 로컬 컴퓨터에서 사용할 수 있는 이미지 파일을 가리켜야 합니다.

에이전트에서 heditor 사용

설치 후 자연어로 원본 영상과 원하는 편집 방향을 설명하세요. 예를 들면 다음과 같습니다.

/videos/class-03.mp4를 documentario 스타일로 편집해 줘. 내가 커리어 전환에 대해 이야기하는 구간을 사용해.

크리에이티브 모드: 이 팟캐스트의 12분 부분을 Reel로 만들고 나를 놀라게 해 줘.

이번 주 뉴스에 관한 이 영상에 뉴스 방송 레퍼런스를 활용한 크리에이티브 모드를 사용해.

이 영상에서 서로 다른 형식으로 3개의 컷을 만들어 줘.

에이전트는 선택한 모드에 따라 분석, 전사, 편집 계획 수립, 구성, 렌더링, 오디오 믹싱 및 품질 검사를 처리합니다.

CLI 직접 사용

처리 단계를 명시적으로 실행할 수도 있습니다. 먼저 환경을 불러옵니다.

. ~/.heditor/env.sh

소스 분석 및 전사

probe를 사용해 화자를 찾기 위한 프레임을 생성하고, transcribe를 사용해 단어별 타이밍이 포함된 전사본을 만듭니다.

heditor probe lesson.mp4 5 60 300
heditor transcribe lesson.mp4 0 3600 qa/asr.json

컷 생성 및 준비

새 컷 디렉터리를 만든 다음 음성 및 카메라 편집을 준비합니다.

heditor new cuts/c01 lesson.mp4
heditor prepare cuts/c01

새 컷에는 prepare.py, build.py, DESIGN.md와 같은 작업 파일이 포함됩니다. 준비 단계에서는 불필요한 일시 정지를 제거하고 조합된 음성 및 카메라 자료를 만듭니다.

일시 정지 및 단어 검사

heditor gaps cuts/c01
heditor words cuts/c01

gaps 명령은 조합된 음성에 0.45초를 초과하는 일시 정지가 남아 있지 않은지 확인하는 데 도움이 됩니다. words 명령은 준비된 컷에 연결된 단어를 표시합니다.

제작, 검증 및 렌더링

구성과 믹스를 제작한 다음 최종 파일을 렌더링하기 전에 품질 검사를 실행합니다.

heditor produce cuts/c01 music:955 30
heditor lint cuts/c01
heditor preview cuts/c01 0.1,2,5,9,14,20
heditor test cuts/c01
heditor render cuts/c01
heditor finalize cuts/c01 c01-1080x1920.mp4
heditor asr-check cuts/c01

preview 명령은 지정한 타임스탬프를 샘플링해 시각적으로 검토합니다. 마지막 ASR 검사는 렌더링된 오디오를 전사하므로 최종 믹스가 의도한 음성과 여전히 일치하는지 확인할 수 있습니다.

기본 제공 스타일 이해

cinema는 음성의 각 구간에 시각적 은유를 적용하고, 영화풍 자막과 주장 전환에 따른 세계 변화를 사용합니다.
ruptura는 가장 강렬한 문구로 시작하고, 카메라를 은유로 전환한 뒤, 타이포그래피로 마무리합니다.
impacto는 핵심 문구를 중심으로 타이포그래피, 사운드, 줌을 조율합니다.
game은 HUD, 대화 상자 자막, 인벤토리 및 계속하기 화면을 갖춘 레트로 RPG 형식으로 영상을 보여 줍니다.
thriller는 REC 표시, 심장 박동 요소, 왜곡, 블랙아웃 및 재부팅 효과를 사용하는 보안 카메라 문법을 적용합니다.
ide는 웹캠 버블, 입력되는 주석 자막, 터미널 행동 유도 문구가 포함된 코드 편집기 화면 녹화를 보여 줍니다.
aeroporto는 레이더, 출발 안내판, 무선 송신 자막을 사용하는 관제탑 콘셉트를 적용합니다.
chat은 음성을 라이트 테마의 메시지 애플리케이션 속 메시지로 바꾸고, 카메라에는 화상 통화 프레이밍을 사용합니다.
documentario는 필름 그레인, 영화풍 레터박스, 세리프 장 제목 및 엔드 크레딧을 사용합니다.
podcast는 ON AIR 표지판, 반응형 파형, 대형 노래방 스타일 자막이 있는 채도 높은 토크쇼 환경을 만듭니다.
missao는 네온 석양, 미션 카드, GPS 경로, 능력치 화면, 완료 화면 및 모바일 행동 유도 문구를 갖춘 오픈월드 게임 오마주를 사용합니다.

자세한 스타일 정의는 스타일 참조 디렉터리에서 확인할 수 있습니다.

고급 팁

음성이 디자인을 이끌도록 하기

heditor는 새 녹음의 의미를 중심으로 장면을 재구성하도록 설계되었습니다. 고정 스타일을 사용할 때는 강조하려는 주제나 구간을 지정하세요. 그러면 에이전트가 임의의 발췌문이 아니라 일관된 사고 흐름을 담은 부분을 선택할 수 있습니다.

성공적인 크리에이티브 콘셉트 저장

크리에이티브 모드의 결과가 특히 잘 나왔다면 스킬에 이름을 지정한 스타일로 저장하도록 요청하세요. 이 과정은 adding-styles.md에 문서화되어 있습니다.

품질 게이트 검토

제작 영상에서는 lint, preview, test, loudness, safe-margin 및 최종 전사 단계를 건너뛰지 마세요. 이 워크플로는 시각적 레이아웃 문제, 오디오 문제, 자막 불일치, 세로 프레임 상단 주변의 안전하지 않은 배치 문제를 발견하도록 설계되었습니다.

로컬 리소스 계획

Linux와 macOS를 지원하며, Windows에서는 WSL2를 사용할 수 있습니다. 권장 컴퓨터 사양은 CPU 4코어와 RAM 8 GB입니다. 설치에는 약 1.5 GB의 디스크 공간이 필요하며, 일반적인 CPU에서 60초 영상의 렌더링에는 5~15분이 걸릴 수 있습니다.

에셋 라이선스 확인

코드와 문서는 MIT 라이선스로 배포됩니다. 이 프로젝트는 각 라이선스에 따라 HyperFrames, GSAP, faster-whisper, MediaPipe, Google Fonts, Lucide 및 Mixkit 에셋을 사용합니다. 음악과 음향 효과는 설치 중 Mixkit에서 다운로드되며 저장소에 재배포되지 않습니다. 상업적 작업을 게시하기 전에 프로젝트의 라이선스 참조를 검토하세요.

결론

heditor는 AI 코딩 에이전트가 평범한 말하는 사람 중심의 녹화 영상을 완성도 높은 세로 영상으로 전환할 수 있도록 체계적인 워크플로를 제공합니다. 스킬을 설치하고 브랜드를 구성한 다음 이름이 지정된 스타일이나 크리에이티브 모드를 선택하고 소스 영상을 설명하세요. 렌더링하기 전에 CLI 검사를 사용해 결과를 검토할 수 있습니다. 파이프라인이 로컬에서 실행되고 각 음성 구간에 맞춰 시각적 세계를 조정하므로, 모든 영상을 동일한 템플릿에 맞추지 않고도 반복 가능한 제작에 적합합니다.