Communitygithub.com

자동 비디오 편집기 (Windows/macOS)

macOS 또는 Windows 사용자가 로컬 비디오를 가리키며 편집, 정리, 자막 생성 또는 라이브스트림 하이라이트 추출을 요청할 때 사용합니다.

macOS)란 무엇인가요?

이 에이전트 기술은 macOS와 Windows 환경에서 로컬 HotClip과 FFmpeg를 활용하여 비디오를 편집, 필러 단어 제거, 대본 기반 하이라이트 추출 및 자막 생성을 수행합니다. 사용자가 로컬 비디오 파일을 지목하면, 에이전트는 FFprobe로 파일을 분석하고, HotClip의 단어 타임스탬프 ASR(음성 인식)을 로컬에서 실행하여 대본을 생성합니다. 이후 LLM 엔드포인트 없이 에이전트가 직접 대본에서 중요한 순간을 선택하고 FFmpeg로 컷과 병합을 수행합니다. 기본적으로 필러 단어(예: '음', '어', 'um', 'uh')를 제거하고 모든 음성 클립에 대해 하드 서브타이틀 MP4와 SRT 파일을 생성합니다. macOS에서는 Homebrew, Windows에서는 winget을 통해 Git, Node.js LTS, FFmpeg를 설치하고 HotClip CLI를 사용합니다. 전체 과정은 로컬에서 이루어지며, 비디오나 대본을 외부로 업로드하지 않습니다. 최종 결과물은 QA 검증을 거친 후 절대 경로와 편집 보고서와 함께 제공됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cresjq-sketch/agent-skills/tree/HEAD/skills/auto-video-editor-windows

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

macOS 및 Windows용 자동 비디오 편집기

로컬 HotClip과 FFmpeg를 사용하여 macOS 또는 Windows에서 검토 가능한 비디오 편집을 수행합니다. 이 표준 에이전트 기술을 현재 에이전트에 해당 에이전트의 기본 기술 설치 프로그램으로 설치하세요. 요구 사항: macOS 또는 Windows 10+, 인터넷 액세스, 수 GB의 여유 디스크 공간. 편집 준비 시, 운영 체제 패키지 관리자로 Git, Node.js LTS, FFmpeg, HotClip 및 HotClip의 로컬 음성 모델을 설치한 후 HotClip CLI를 사용하세요. macOS에서는 Homebrew가 일반적인 패키지 관리자이고, Windows에서는 winget을 사용합니다. 대본 기반 선택을 위해 리포지토리 PowerShell 부트스트랩, Ollama 또는 LLM 엔드포인트가 필요하지 않습니다. 필요한 경우 기술 설치 후 에이전트를 다시 시작하세요.

워크플로

  1. ffprobe로 소스를 프로브합니다: 지속 시간, 프레임 크기, 오디오/비디오 스트림. 소스를 보존하고 새 형제 출력 폴더 成品_自动精剪_YYYY-MM-DD를 생성합니다. 이미 존재하는 경우 숫자 접미사를 사용합니다.
  2. 5분 이상 비디오의 경우 대본에서 하이라이트 개수를 선택합니다: 일반적으로 15분 미만이면 1–2개, 15–60분이면 2–4개, 60분 초과면 3–5개. 이는 상한선이지 할당량이 아닙니다. 뚜렷하고 완전하며 유용한 순간이 충분하지 않으면 더 적게 반환합니다. 반복되는 주제는 피하세요. 짧은 완성 클립의 경우 전체 클립을 보수적으로 정리합니다. 사용자가 전체 녹화본을 유지하도록 요청하면 하이라이트를 추출하지 마십시오.
  3. HotClip의 단어 타임스탬프 ASR로 로컬에서 대본을 생성합니다. 컷이나 캡션에 사용하기 전에 오디오와 대조하여 대본을 검토하세요. HotClip의 자동 highlights 및 clip 명령은 LLM 엔드포인트가 구성되어 있어야 합니다. 이 LLM 없는 워크플로에서는 활성 어시스턴트가 대본에서 순간을 선택하고 FFmpeg로 렌더링합니다. 영상이나 대본을 업로드하지 마십시오.
  4. 기본적으로 명백한 필러 단어를 제거합니다. 嗯, 呃, 额, 唔, 诶, um, uh와 같은 고립된 망설임 소리와 명백한 즉각적인 말 더듬 반복을 검토합니다. 각 후보를 오디오에서 자르기 전에 확인하세요. 啊, 这/这个, 那个, 就是, 그리고 然后는 문맥에 따라 처리합니다. 의미 없는 망설임 또는 반복되는 말뚝일 때만 제거하고 문장이 자연스럽게 유지되는 경우에만 제거합니다. 의미 있는 강조, 참조, 전환 및 불확실한 단어는 유지하세요. 대본 전체에 걸쳐 블라인드 텍스트 교체를 절대 사용하지 마십시오. 작은 자연스러운 오디오 경계가 있는 완전한 단어 범위만 자르세요. 호흡과 방음은 명확히 원치 않는 경우가 아니라면 보존하세요.
  5. 모든 음성 클립에 대해 기본적으로 자막을 생성합니다. 검토된 대본에서 정확한 중국어 캡션을 만들고, 실제로 잘린 단어를 제거하고, 모든 큐를 편집된 출력 타임라인에 맞게 다시 시간 조정합니다. 가독성 좋은 짧은 줄(보통 한두 줄), 자연스러운 구두점 및 안전한 여백을 유지하세요. 하드 서브타이틀 MP4와 일치하는 SRT 사이드카를 모두 제공합니다. 사용자가 자막을 원하지 않으면 해당 요청을 따른 후에만 둘 다 생략하세요. 번인되지 않은 캡션 계획을 자막 내보내기로 제시하지 마십시오.
  6. 완전한 단어와 문장에 대해 하이라이트 및 필러 컷 경계를 설정합니다. 모든 시작과 끝 주변의 대본과 오디오를 확인하세요. 절대 midWordCuts: 0에만 의존하지 마십시오. 보존된 구간을 하나의 편집으로 조합하고 편집 결정 목록을 유지합니다. 보존된 구간 [source_start, source_end] 내부의 소스 시간 t에 대해 출력 시간을 t - source_start + cumulative_duration_of_prior_retained_intervals로 계산합니다. 필러 컷으로 제거된 단어는 생략합니다. 이 출력 타임라인에 SRT를 구축하고, 오디오/비디오 연결에 동일한 구간 맵을 사용한 다음, FFmpeg의 자막 필터로 SRT를 렌더링된 MP4에 번인합니다.
  7. 소스의 주요 그림과 그래픽을 보존합니다. 반복되는 파란색 라이브스트림 배너의 경우, 오래된 에피소드 제목만 대본의 간결하고 충실한 제목으로 교체합니다. 영구 마스트헤드와 장식 아트워크는 유지합니다. 1080×1920에서 번인된 캡션을 하단 근처에 약 40px 여유를 두고 배치합니다. 렌더링된 프레임을 검사하여 읽을 수 있고 잘리지 않은 텍스트인지 확인합니다.
  8. 확인된 필러 단어, 원치 않는 침묵 또는 사용자 요청 편집을 제외하고 기본적으로 연속 오디오를 보존합니다. VAD 침묵을 후보로 처리합니다. 제안된 컷이 ASR 단어와 겹치면 오디오를 검사하고 음성을 보존합니다. 시각적 오버레이의 경우 가능한 경우 렌더링된 오디오를 스트림 복사하고 오디오 패킷 해시를 오버레이 전 렌더와 비교합니다.
  9. ffprobe, 전체 FFmpeg 디코드, 오디오/비디오 스트림 검사, 검은 프레임 스캔, 침묵 스캔, 지속 시간, 자막 존재/동기화, 시작/종료 단어 검사를 통해 각 내보내기를 확인합니다. 렌더링된 시작, 중간, 끝을 들어보세요. 긴 침묵을 소스에 매핑하고 그것이 녹화에 있었는지 또는 편집으로 인해 도입되었는지 보고합니다. 해결되지 않은 QA 경고를 표면화하고 실제로 수행된 검사만 보고합니다.
  10. 게시하거나 업로드하지 마십시오. 각 MP4 및 SRT의 절대 경로, 지속 시간, 출력 폴더 및 QA 링크가 포함된 마크다운 편집 보고서를 제공합니다.

명령어

플랫폼 설정 및 명령어

두 플랫폼에서 리포지토리 CLI를 사용하세요. 먼저 Git, Node.js LTS, FFmpeg 및 pnpm을 설치합니다. 안정적인 사용자 디렉토리에 https://github.com/xixihhhh/hotclip에서 HotClip을 클론하고 해당 디렉토리에서 pnpm install을 실행합니다. HotClip의 첫 번째 로컬 전사는 음성 모델을 다운로드합니다. 이 대본 기반 워크플로에서는 LLM 환경 변수를 설정하지 마십시오.

macOS (zsh), 필요한 경우 Homebrew를 설치한 후:

brew install git node ffmpeg
corepack enable
corepack prepare pnpm@latest --activate
mkdir -p "$HOME/Library/Application Support/HotClip"
git clone --depth 1 https://github.com/xixihhhh/hotclip.git "$HOME/Library/Application Support/HotClip/source"
cd "$HOME/Library/Application Support/HotClip/source"
pnpm install
pnpm cli transcribe "$HOME/Movies/recording.mp4" --json > "$HOME/Movies/transcript.json"

Windows PowerShell, HotClip 소스 디렉토리에서 Git, Node.js LTS 및 FFmpeg를 winget으로 설치한 후:

corepack enable
corepack prepare pnpm@latest --activate
git clone --depth 1 https://github.com/xixihhhh/hotclip.git "$env:LOCALAPPDATA\HotClip\app"
Set-Location "$env:LOCALAPPDATA\HotClip\app"
pnpm install
pnpm cli transcribe 'C:\Videos\recording.mp4' --json > 'C:\Videos\transcript.json'

공식 HotClip macOS DMG는 현재 Apple Silicon용입니다. 앱은 Apple 공증을 받지 않았습니다. Gatekeeper가 차단하면 공식 설치 가이드를 사용하세요. 위의 CLI 소스 워크플로는 GUI 다운로드와 별개입니다. Intel Mac에 설치하기 전에 현재 HotClip 릴리스 및 설치 가이드의 호환성을 확인하세요.

전사는 로컬에서 실행됩니다. 대본의 뚜렷하고 독립적인 순간에 따라 지속 시간 기반 상한선 내에서 개수를 선택하세요. 존재한다고 해서 최대치를 채우지 마십시오. 사용자가 생략을 요청하지 않는 한 항상 음성 캡션과 일치하는 SRT를 렌더링하세요. 개별적으로 확인된 필러 단어 범위만 제거한 다음 자막 큐를 출력 타임라인에 다시 시간 조정하세요. 대본 경계와 오디오 안전성을 확인한 후에만 렌더링하세요.

관련 스킬