renezander030/capcut-cli

어떤 프로젝트인가요?

핵심 기능

• 01로컬 CapCut 및 JianYing 초안 JSON을 편집하며, 앱에서 트랙을 계속 편집할 수 있게 합니다.
• 02영상, 오디오, 텍스트를 추가하고 트리밍, 속도, 볼륨 및 전환 효과를 적용합니다.
• 03단어 단위 자막을 지원하며 SRT 및 VTT 자막을 가져오고 내보냅니다.
• 04무음 구간, 장면 및 반복 촬영 감지를 활용해 긴 녹화 영상을 짧은 영상으로 나눕니다.
• 05자동화를 위한 CLI, 타입이 지정된 라이브러리 및 JSONL 큐 러너를 제공합니다.

활용 사례

• 긴 녹화 영상을 자막이 포함된 짧은 영상으로 일괄 변환하기.
• SRT 파일을 사용해 기존 CapCut 프로젝트의 자막을 생성하거나 수정하기.
• LLM 에이전트가 결정론적인 명령 인터페이스를 통해 초안을 살펴보거나 만들도록 하기.
• 번역된 자막을 포함한 초안의 다국어 버전을 제작하기.

빠른 시작

1. 1

   npm에서 CLI를 전역 설치합니다

   npm install -g capcut-cli
2. 2

   doctor 명령어로 설정을 확인합니다

   capcut doctor
3. 3

   동영상과 자막이 포함된 첫 프로젝트를 만듭니다

   capcut quickstart my-first --video clip.mp4 --srt captions.srt
4. 4

   사람이 읽기 쉬운 형식으로 프로젝트를 살펴봅니다

   capcut info ./my-first/ -H

사용 전 알아둘 점

• !Node 18 이상이 필요합니다. 일부 명령어에는 Whisper, FFmpeg, Anthropic API 키와 같은 선택 도구도 필요합니다.
• !CapCut 또는 ByteDance와 제휴하지 않은 비공식 커뮤니티 프로젝트입니다.
• !출력물은 CapCut 또는 JianYing에서 열어 렌더링해야 합니다. 이 도구 자체는 최종 동영상을 게시하거나 렌더링하지 않습니다.

토픽

자주 묻는 질문

capcut-cli은(는) 무엇인가요?

API나 서버 없이 로컬 JSON으로 CapCut / JianYing 초안 프로젝트를 편집하는 CLI 도구이자 라이브러리입니다. capcut-cli는 로컬 초안 저장소에서 직접 작업해 실제 CapCut 및 JianYing (剪映) 프로젝트를 만들고 편집합니다. 모든 명령은 JSON을 읽고 다시 JSON으로 저장하므로, 결과물을 CapCut에서 열면 영상, 자막 및 기타 트랙을 평면화된 내보내기 파일이 아니라 편집 가능한 상태로 유지할 수 있습니다. 미디어와 텍스트 추가, 트리밍, 속도 및 볼륨 조정, 전환 효과, 템플릿 적용, SRT 또는 VTT 자막 가져오기와 내보내기 등의 작업을 지원합니다.

capcut-cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

capcut-cli은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

capcut-cli은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. capcut-cli의 마지막 커밋은 2026년 10월 19일입니다.

capcut-cli은(는) 어디에 사용할 수 있나요?

긴 녹화 영상을 자막이 포함된 짧은 영상으로 일괄 변환하기. SRT 파일을 사용해 기존 CapCut 프로젝트의 자막을 생성하거나 수정하기. LLM 에이전트가 결정론적인 명령 인터페이스를 통해 초안을 살펴보거나 만들도록 하기. 번역된 자막을 포함한 초안의 다국어 버전을 제작하기.

capcut-cli는 어떻게 설치하나요?

npm에서 CLI를 전역 설치합니다: npm install -g capcut-cli doctor 명령어로 설정을 확인합니다: capcut doctor 동영상과 자막이 포함된 첫 프로젝트를 만듭니다: capcut quickstart my-first --video clip.mp4 --srt captions.srt 사람이 읽기 쉬운 형식으로 프로젝트를 살펴봅니다: capcut info ./my-first/ -H

capcut-cli은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/renezander030/capcut-cli