Communitygithub.com

HyperFrames CLI 도구 모음

HyperFrames CLI 도구 — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. 프로젝트 스캐폴딩, 린트, 검증, 컴포지션 레이아웃 검사, 스튜디오 미리보기, 비디오 렌더링, 오디오 전사, TTS 생성, 또는 HyperFrames 환경 문제 해결에 사용합니다.

HyperFrames CLI 도구 모음란 무엇인가요?

이 스킬은 HyperFrames CLI 도구 모음으로, 비디오 편집 파이프라인을 위한 완전한 명령줄 워크플로우를 제공합니다. npx hyperframes 명령어를 통해 프로젝트 초기화, HTML 컴포지션 린트, 시각적 레이아웃 검사, 실시간 스튜디오 미리보기, 최종 비디오 렌더링, Whisper를 이용한 오디오 전사, 텍스트 음성 변환(TTS), 환경 진단 등을 수행할 수 있습니다. Node.js >= 22와 FFmpeg가 필요하며, lint 명령어는 누락된 data-composition-id, 겹치는 트랙, 등록되지 않은 타임라인을 잡아내고, inspect 명령어는 헤드리스 Chrome에서 렌더링된 컴포지션을 분석하여 텍스트 오버플로우나 캔버스 밖 요소를 보고합니다. Docker를 지원하여 재현 가능한 렌더링이 가능하며, GPU 가속 인코딩, 다양한 출력 형식(MP4, WebM), 품질 단계(draft/standard/high)를 제공합니다. Cursor, Claude Code, Codex 등 AI 코딩 에이전트와의 통합에 최적화되어 있어, JSON 출력과 축약된 중복 보고를 통해 LLM 컨텍스트 윈도우를 효율적으로 사용합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-skills/hyperframes-cli

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

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

문서

HyperFrames CLI

모든 작업은 npx hyperframes를 통해 실행됩니다. Node.js >= 22와 FFmpeg가 필요합니다.

워크플로우

  1. 스캐폴딩 — npx hyperframes init my-video
  2. 작성 — HTML 컴포지션 제작 (hyperframes 스킬 참조)
  3. 린트 — npx hyperframes lint
  4. 시각적 검사 — npx hyperframes inspect
  5. 미리보기 — npx hyperframes preview
  6. 렌더링 — npx hyperframes render

미리보기 전에 린트와 검사를 수행하세요. lint는 누락된 data-composition-id, 겹치는 트랙, 등록되지 않은 타임라인을 찾아냅니다. inspect는 헤드리스 Chrome에서 렌더링된 컴포지션을 열고, 타임라인을 탐색하며, 말풍선/컨테이너 밖으로 나가거나 캔버스를 벗어난 텍스트를 보고합니다.

스캐폴딩

npx hyperframes init my-video                        # 대화형 마법사
npx hyperframes init my-video --example warm-grain   # 예제 선택
npx hyperframes init my-video --video clip.mp4        # 비디오 파일 포함
npx hyperframes init my-video --audio track.mp3       # 오디오 파일 포함
npx hyperframes init my-video --non-interactive       # 프롬프트 생략 (CI/에이전트)

템플릿: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init은 올바른 파일 구조를 생성하고, 미디어를 복사하며, Whisper로 오디오를 전사하고, AI 코딩 스킬을 설치합니다. 수동으로 파일을 생성하는 대신 이 명령어를 사용하세요.

린팅

npx hyperframes lint                  # 현재 디렉토리
npx hyperframes lint ./my-project     # 특정 프로젝트
npx hyperframes lint --verbose        # 정보 수준 결과
npx hyperframes lint --json           # 기계 판독 가능

index.html 및 compositions/의 모든 파일을 린트합니다. 오류(반드시 수정), 경고(수정 권장), 정보(--verbose 사용 시)를 보고합니다.

시각적 검사

npx hyperframes inspect                 # 타임라인에 걸친 렌더링 레이아웃 검사
npx hyperframes inspect ./my-project    # 특정 프로젝트
npx hyperframes inspect --json          # 에이전트 판독 가능 결과
npx hyperframes inspect --samples 15    # 더 조밀한 타임라인 스윕
npx hyperframes inspect --at 1.5,4,7.25 # 명시적 히어로 프레임 타임스탬프

lint와 validate 이후에 사용하며, 특히 말풍선, 카드, 캡션, 빡빡한 타이포그래피가 포함된 컴포지션에 적합합니다. 다음을 보고합니다:

  • 가장 가까운 시각적 컨테이너나 말풍선 밖으로 확장된 텍스트
  • 고정 너비/높이 박스에 의해 잘린 텍스트
  • 컴포지션 캔버스 밖으로 확장된 텍스트
  • 클리핑 컨테이너를 벗어난 자식 요소

오류는 렌더링 전에 수정해야 합니다. 경고는 에이전트 검토를 위해 표시되며, --strict를 추가하면 경고에서도 실패 처리합니다. 반복되는 정적 문제는 기본적으로 축소되어 LLM 컨텍스트 윈도우를 위해 JSON 출력을 간결하게 유지합니다. 오버플로우가 입장/퇴장 애니메이션을 위한 의도적이라면, 요소나 조상에 data-layout-allow-overflow를 표시하세요. 장식 요소가 감사 대상이 아니어야 한다면, data-layout-ignore로 표시하세요.

npx hyperframes layout도 동일한 시각적 검사 패스의 호환 별칭으로 사용 가능합니다.

미리보기

npx hyperframes preview                   # 현재 디렉토리 서빙
npx hyperframes preview --port 4567       # 사용자 지정 포트 (기본 3002)

파일 변경 시 핫 리로드됩니다. 브라우저에서 스튜디오를 자동으로 엽니다.

프로젝트를 사용자에게 전달할 때는 소스 index.html 경로 대신 스튜디오 프로젝트 URL을 사용하세요:

http://localhost:<port>/#project/<project-name>

미리보기 출력의 실제 포트와 프로젝트 디렉토리 이름을 사용하세요. 예를 들어, codex-openai-video 디렉토리에서 npx hyperframes preview --port 3017을 실행한 후, http://localhost:3017/#project/codex-openai-video를 보고하세요.

index.html은 소스 코드 컨텍스트로만 취급하세요. 구현 파일로 링크하는 것은 괜찮지만, 프로젝트 또는 미리보기 표면으로 레이블을 붙이지 마세요.

렌더링

npx hyperframes render                                # 표준 MP4
npx hyperframes render --output final.mp4             # 이름 지정 출력
npx hyperframes render --quality draft                # 빠른 반복
npx hyperframes render --fps 60 --quality high        # 최종 배포
npx hyperframes render --format webm                  # 투명 WebM
npx hyperframes render --docker                       # 바이트 동일
플래그옵션기본값참고 사항
--output경로renders/이름_타임스탬프.mp4출력 경로
--fps24, 30, 603060fps는 렌더링 시간 2배
--qualitydraft, standard, highstandarddraft는 반복용
--formatmp4, webmmp4WebM은 투명도 지원
--workers1-8 또는 autoauto각각 Chrome 실행
--docker플래그off재현 가능 출력
--gpu플래그offGPU 가속 인코딩
--strict플래그off린트 오류 시 실패
--strict-all플래그off오류 및 경고 모두 실패

품질 가이드: 반복 시 draft, 검토 시 standard, 최종 배포 시 high를 사용하세요.

전사

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # 기존 파일 가져오기
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

텍스트 음성 변환

npx hyperframes tts "텍스트 입력" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # 모든 음성 목록

문제 해결

npx hyperframes doctor       # 환경 확인 (Chrome, FFmpeg, Node, 메모리)
npx hyperframes browser      # 번들된 Chrome 관리
npx hyperframes info         # 버전 및 환경 세부 정보
npx hyperframes upgrade      # 업데이트 확인

렌더링이 실패하면 먼저 doctor를 실행하세요. 일반적인 문제: FFmpeg 누락, Chrome 누락, 메모리 부족.

기타

npx hyperframes compositions   # 프로젝트의 컴포지션 목록
npx hyperframes docs           # 문서 열기
npx hyperframes benchmark .    # 렌더링 성능 벤치마크

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

govindgoel2001/video-editing-toolkit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

govindgoel2001/video-editing-toolkit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

관련 스킬