Repolode
kajisho5

kajisho5/ffmpeg-skill

Claude Code, Cursor, Codex 같은 코딩 에이전트에 로컬 FFmpeg 편집 도구 42개를 제공하는 Agent Skill 및 MCP 서버입니다.

대체할 수 있는 제품:DescriptCapCut

스타
2,000
포크
164
열린 이슈
4
마지막 커밋
그저께

어떤 프로젝트인가요?

ffmpeg-skill을 사용하면 코딩 에이전트가 ffmpeg와 ffprobe를 로컬에서 실행하는 구조화된 Python 스크립트를 호출해 동영상과 오디오 파일을 편집할 수 있습니다. 42개 도구로 클립 자르기와 이어 붙이기, 무음 제거, 영상 길이나 화면 비율 맞추기, 자막 삽입, 오버레이 추가, HDR을 SDR로 변환, 음량 정규화, 녹음 간 싱크 조정, TikTok, Reels, YouTube, X 같은 플랫폼에 맞춘 파일 내보내기를 할 수 있습니다.

각 도구는 필터 문자열을 직접 받는 대신 타입이 지정된 인자를 사용하고, --dry-run 및 --json 출력을 지원하며, 처리 결과를 probe합니다. 기계가 읽을 수 있는 계약 문서에 모든 도구의 입력과 출력이 정의되어 있으며, 같은 도구를 MCP로도 사용할 수 있습니다. 처리는 API 키 없이 오프라인으로 실행되며 Python 표준 라이브러리만 사용하지만, ffmpeg와 python3를 설치해야 합니다.

이 프로젝트는 로컬 영상 파일을 클라우드 서비스에 업로드하지 않고 에이전트가 반복적인 편집을 처리하게 하고, 완료를 보고하기 전에 에이전트가 결과를 직접 확인하도록 하려는 개발자를 대상으로 합니다.

핵심 기능

  • 01가능한 경우 무손실 스트림 복사를 사용해 클립을 자르고 이어 붙이며 무음을 제거합니다.
  • 029:16 자르기 및 블러 채우기를 포함해 영상 길이와 화면 비율을 지정한 값에 맞춥니다.
  • 03노래방 스타일의 타이밍과 플랫폼별 안전 영역에 맞춘 줄바꿈을 적용해 자막을 삽입합니다.
  • 04음량을 EBU R128 기준에 맞춰 정규화하고 HDR 영상을 SDR로 변환합니다.
  • 05argparse 정의에서 생성한 계약 문서를 바탕으로 모든 도구를 MCP로 제공합니다.

활용 사례

  • 에이전트가 긴 녹화 영상에서 Reels나 TikTok에 올릴 60초 세로 영상을 만들게 합니다.
  • 폴더 안의 파일을 일괄적으로 음량 정규화하고 팟캐스트나 소셜 미디어용 결과물을 내보냅니다.
  • 영상을 클라우드 편집기에 업로드하지 않고 자막과 오버레이를 삽입합니다.
  • 각 결과물을 다음 단계로 넘기기 전에 ffprobe로 확인하는 스크립트 기반 영상 파이프라인을 구축합니다.

빠른 시작

  1. 1

    Claude Code용 스킬 설치

    npx ffmpeg-skill
  2. 2

    ffmpeg, ffprobe 및 필요한 구성 요소가 있는지 확인

    npx ffmpeg-skill doctor
  3. 3

    기계가 읽을 수 있는 도구 계약 읽기

    npx ffmpeg-skill contract --json | head -40

사용 전 알아둘 점

  • PATH에 ffmpeg와 python3가 미리 설치되어 있어야 합니다.
  • 설치 프로그램이 복사한 파일은 자동으로 업데이트되지 않습니다. 업데이트하려면 설치 명령을 다시 실행하세요.
  • caption.py와 같은 일부 도구는 기본 Homebrew 빌드에 없을 수 있는 subtitles 필터 등의 FFmpeg 구성 요소가 필요합니다.

토픽

자주 묻는 질문

ffmpeg-skill은(는) 무엇인가요?
Claude Code, Cursor, Codex 같은 코딩 에이전트에 로컬 FFmpeg 편집 도구 42개를 제공하는 Agent Skill 및 MCP 서버입니다. ffmpeg-skill을 사용하면 코딩 에이전트가 ffmpeg와 ffprobe를 로컬에서 실행하는 구조화된 Python 스크립트를 호출해 동영상과 오디오 파일을 편집할 수 있습니다. 42개 도구로 클립 자르기와 이어 붙이기, 무음 제거, 영상 길이나 화면 비율 맞추기, 자막 삽입, 오버레이 추가, HDR을 SDR로 변환, 음량 정규화, 녹음 간 싱크 조정, TikTok, Reels, YouTube, X 같은 플랫폼에 맞춘 파일 내보내기를 할 수 있습니다.
ffmpeg-skill은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ffmpeg-skill은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ffmpeg-skill은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ffmpeg-skill의 마지막 커밋은 2026년 10월 17일입니다.
ffmpeg-skill은(는) 어디에 사용할 수 있나요?
에이전트가 긴 녹화 영상에서 Reels나 TikTok에 올릴 60초 세로 영상을 만들게 합니다. 폴더 안의 파일을 일괄적으로 음량 정규화하고 팟캐스트나 소셜 미디어용 결과물을 내보냅니다. 영상을 클라우드 편집기에 업로드하지 않고 자막과 오버레이를 삽입합니다. 각 결과물을 다음 단계로 넘기기 전에 ffprobe로 확인하는 스크립트 기반 영상 파이프라인을 구축합니다.
ffmpeg-skill는 어떻게 설치하나요?
Claude Code용 스킬 설치: npx ffmpeg-skill ffmpeg, ffprobe 및 필요한 구성 요소가 있는지 확인: npx ffmpeg-skill doctor 기계가 읽을 수 있는 도구 계약 읽기: npx ffmpeg-skill contract --json | head -40
ffmpeg-skill은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kajisho5/ffmpeg-skill

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트