본문으로 건너뛰기
오픈소스 전체 목록

html-video

  • 추천0
  • GitHub 별4.8K
  • 영상라이선스Apache-2.0

HTML·CSS·데이터를 내 노트북에서 MP4로 바꿔 주는 코딩 에이전트용 영상 도구. 템플릿 21개, AI 배경음악·내레이션, Apache-2.0

원본:nexu-io/html-video

요약

HTML·CSS·데이터를 내 노트북에서 MP4로 바꿔 주는 코딩 에이전트용 영상 도구. 템플릿 21개, AI 배경음악·내레이션, Apache-2.0

설명

html-video

html-video — HTML이 영상이 된다, 내 노트북에서

HTML이 영상이 됩니다. 내 노트북에서. 로컬 코딩 에이전트(Open Design · Windsurf CLI · Trae CLI · Claude Code · Cursor · Codex · Gemini · Grok · Qwen · OpenCode · Copilot · Aider · Hermes, 또는 Anthropic API)를 그대로 쓰세요. 만들고 싶은 영상을 설명하거나 기사 링크 · GitHub 저장소를 붙여 넣으면, 에이전트가 여러 장면으로 구성된 완전한 애니메이션 영상으로 바꾸고 내 컴퓨터에서 바로 진짜 MP4로 렌더링합니다. 하나의 에이전트 루프, 갈아 끼울 수 있는 렌더링 엔진, 엄선한 템플릿 갤러리, 선택형 AI 사운드트랙. Apache-2.0이고, 렌더링 건당 요금도 특정 업체에 묶이는 일도 없습니다.

라이선스 에이전트 14종 템플릿 21개 기사 · 저장소 · 프롬프트에서 시작 사운드트랙: AI 음악과 내레이션 빠른 시작: 명령 3개

Discord X에서 @nexudotio 팔로우 Open Design 팀 제작

Open Design 팀의 공식 프로젝트 · open-design.ai

English · 简体中文


쇼케이스

아래 템플릿은 모두 실제로 움직이는 단일 파일 HTML 영상입니다. 목업이 아니라 실제 렌더 결과예요. 하나를 골라 에이전트가 내 내용을 채우게 하고 MP4로 내보내면 됩니다.

NYT 스타일 데이터 차트

frame-data-chart-nyt · 데이터 시각화 — 헤드라인, 주석이 달린 데이터 포인트, 출처 줄이 들어간 NYT 스타일의 편집용 애니메이션 선 그래프. ‘수치가 올랐다’는 이야기에 어울립니다.

글리치 타이틀

frame-glitch-title · 타이틀 카드 — 색수차 글리치 효과와 스캔라인이 들어간 타이틀. 오프닝, 드롭, ‘시스템 온라인’ 같은 분위기에 어울립니다.

리퀴드 배경 히어로

frame-liquid-bg-hero · 히어로 — 가운데 헤드라인이 놓인 오로라 액체 그라데이션 히어로. 제품 공개와 강한 메시지에 어울립니다.

라이트 릭 시네마

frame-light-leak-cinema · 시네마틱 — 따뜻한 필름 그레인과 라이트 릭이 들어간 영화 같은 프레임. 분위기, 브랜드 필름, ‘조용한 한 해’ 같은 스토리텔링에 어울립니다.

타자기 커서 VFX

vfx-text-cursor · VFX — 터미널 커서가 깜박이는 타자기 텍스트. 코드 스타일 공개 장면과 CLI 데모에 어울립니다.

로고 아웃트로

frame-logo-outro · 아웃트로 — 깔끔하게 움직이는 로고 엔드 카드. 어떤 영상이든 마지막 인사와 브랜드 도장으로 쓰기 좋습니다.

…그 밖에 15개가 더 있습니다. 여러 장면으로 된 제품 프로모션, 키네틱 타이포, 스위스 그리드와 비녤리 스타일 데이터 카드, 의사결정 트리 설명 영상, 타카람풍 유기적 모션, 따뜻한 그레인의 에디토리얼 등이 있어요. 스튜디오 갤러리에서 21개 전체를 실시간으로 볼 수 있습니다.


왜 만들었나

HTML→영상은 이미 하나의 분야입니다. 하지만 엔진마다 고집이 있고, 저마다 자기만의 제작 방식을 배우라고 요구합니다.

엔진방식트레이드오프html-video에서의 상태
HyperframesHTML + CSS + GSAP, 에이전트 스킬 기반렌더링 방식이 하나뿐✅ 출시됨 — 기본 엔진. 헤드리스 Chromium + ffmpeg로 실제 MP4 렌더링
RemotionReact 컴포넌트소스 공개(source-available), 개발자 4명 초과 시 유료🗺️ 계획 중
Motion Canvas · Revideo캔버스 위의 TypeScript 제너레이터설명 영상에 최적, 코드 우선🗺️ 계획 중
Manim 등수학 · 3D 중심틈새🗺️ 조사 중

용도마다 맞는 엔진을 고르고, 각각의 모델을 익히고, 하나의 워크플로로 엮는 데에는 실제 엔지니어링 시간이 듭니다. 대부분의 팀은 하나만 골라 그 한계를 안고 갑니다.

html-video는 이 모든 엔진 위에 놓이는 메타 레이어입니다. 에이전트와 대화하면 에이전트가 엔진을 고르고, 템플릿을 고르고, 내용을 채우고, 영상을 렌더링합니다. 엔진은 하나의 어댑터 인터페이스 뒤에 숨은 구현 세부 사항입니다. 어떤 백엔드든 맞출 수 있는 render(input, ctx) 계약 하나가 전부예요. 새 엔진을 추가하면 모든 템플릿, 모든 에이전트, 스튜디오 워크플로 전체가 공짜로 그 엔진을 얻습니다. 새로 배울 DSL도, 엔진을 바꿀 때의 재작성도 없습니다.

같은 발상이 디자인 분야의 Open Design을 움직입니다. 여러 도구 위의 에이전트 메타 레이어죠. html-video는 같은 팀이 만든 모션 쪽 짝입니다.

상태: 플러그인식 엔진 구조는 갖춰져 있고, Hyperframes 엔진은 완전히 연결되어 실제 MP4를 렌더링합니다. 헤드리스 Chromium이 애니메이션 HTML을 프레임 단위로 녹화하고 ffmpeg가 인코딩(libx264)합니다. Remotion, Motion Canvas / Revideo, Manim은 로드맵에 있습니다. 어댑터 인터페이스는 이들을 염두에 두고 설계됐지만 어댑터는 아직 만들어지지 않았습니다. 위 표의 「html-video에서의 상태」 칸이 지금 실제로 돌아가는 것에 대한 유일한 기준입니다.


한눈에 보기

코딩 에이전트 (14)Open Design (Vela) · Windsurf CLI · Trae CLI · Claude Code · Cursor Agent · Codex CLI · Gemini CLI · Grok Build · Qwen Code · OpenCode · GitHub Copilot CLI · Aider · Hermes · Anthropic Messages API — PATH에서 자동으로 감지하고 상단 바에서 바꿀 수 있습니다.
실제 MP4 렌더헤드리스 Chromium이 애니메이션 HTML을 녹화하고 ffmpeg가 인코딩(libx264)합니다. 전부 로컬에서 처리하고, 클라우드 렌더도 클립당 요금도 없습니다.
기사 / 저장소 → 영상URL이나 GitHub 저장소를 붙여 넣으면 스튜디오가 서버 쪽에서 가져와(WeChat 공중호 기사도 처리) 실제 내용으로 영상을 만듭니다.
템플릿 21개라이선스 문제가 없도록 엄선한 패턴: 데이터 시각화, 제품 프로모션, 소셜 쇼츠, 설명 영상, 키네틱 타이포, 전환 효과. 갤러리에서 바로 미리 볼 수 있습니다.
멀티 프레임 스토리보드콘텐츠 그래프가 여러 장면의 영상을 이끌어요. 프레임별 글을 바로 고치고, 순서를 바꾸고, 다시 렌더링할 수 있습니다.
AI 사운드트랙선택 사항. MiniMax로 배경음악과 내레이션을 만들어 내보낼 때 MP4에 섞습니다.
스튜디오 + CLI로컬 브라우저 스튜디오와 스크립트로 다룰 수 있는 html-video CLI.
라이선스Apache-2.0 — 렌더링당 요금도, 좌석 제한도, 기여자 계약도 없습니다.

동작 방식

한 문장(또는 링크 하나)을 넣으면 진짜 MP4가 나옵니다. 프롬프트, 기사, 저장소 중 무엇에서 시작하든 파이프라인은 같습니다.

  프롬프트 / 링크 / 저장소
        │
        ▼
  ① 소스 가져오기      스튜디오가 URL이나 저장소를 서버 쪽에서 가져와 마크다운으로 펼칩니다
        │
        ▼
  ② 에이전트 루프      에이전트가 자료와 고른 템플릿의 스타일을 읽고
        │               콘텐츠 그래프(스토리보드)와 프레임별 HTML 블록 하나씩을 내놓습니다
        ▼
  ③ 콘텐츠 그래프      멀티 프레임 IR — 노드(개체 / 데이터 / 글) + 엣지(순서 /
        │               의존 / 대비). 위상 정렬해서 프레임 순서와 타이밍을 정합니다
        ▼
  ④ 프레임별 HTML      각 노드가 디스크에 놓인 독립된 애니메이션 HTML 프레임이 됩니다
        │
        ▼
  ⑤ Hyperframes 렌더   헤드리스 Chromium이 프레임마다 불러와 녹화합니다(프레임 자체 애니메이션을
        │               덮도록 자동으로 길이를 늘림) → 프레임별 webm
        ▼
  ⑥ ffmpeg             각 webm → mp4(libx264)로 바꾼 뒤 하나의 영상으로 이어 붙입니다.
        │               선택 사항으로 MiniMax 음악 + 내레이션을 섞습니다
        ▼
      your.mp4

②~④단계가 「메타 레이어」가 있는 곳입니다. 에이전트가 스토리보드를 정하고 엔진이 그것을 어떻게 그릴지 정하며, 서로 상대의 영역으로 새어 나가지 않습니다. ⑤단계는 엔진에 따라 달라집니다. 나중에 Remotion이나 Motion Canvas로 바꿔도 이 상자만 바뀌고 스토리보드와 에이전트 루프는 그대로입니다. 모든 것이 내 컴퓨터에서 돌아가며, 네트워크를 쓰는 것은 선택 사항인 소스 가져오기와 선택 사항인 사운드트랙뿐입니다.

한 장면짜리 영상은 콘텐츠 그래프를 건너뛰는 빠른 경로를 탑니다. 템플릿 하나, HTML 하나로 곧장 렌더링합니다.


링크를 영상으로

대부분의 사람이 가장 먼저 쓰는 기능입니다. 에이전트에게 링크를 주면 영상이 돌아옵니다. 에이전트는 자체 네트워크 접근이 없는 로컬 CLI로 돌아가기 때문에, 스튜디오가 소스를 서버 쪽에서 가져와 실제 내용을 생성 프롬프트에 넣어 줍니다. 기사 본문을 복사해 붙여 넣을 필요가 없고, 로그인 없이 서버에서 렌더링되는 페이지(WeChat 공중호 등)도 그대로 됩니다.

You:   做一个解读视频  https://mp.weixin.qq.com/s/…
Agent: 好,我读完了《用嘴剪视频的时代来了?…》这篇文章 — 这就基于它生成。下一步选风格。
→      기사의 실제 요점으로 만든 멀티 프레임 설명 영상
  • 웹 기사 → 가져와서 마크다운으로 펼칩니다. WeChat 공중호 기사 같은 서버 렌더링 페이지는 바로 됩니다.
  • GitHub 저장소 → 설명, 최상위 구조, README를 공개 API로 가져옵니다. ‘이 오픈소스 프로젝트를 설명하는’ 영상에 잘 맞아요.
  • 프롬프트만 → 주제를 설명하면 에이전트가 내용을 처음부터 씁니다.

어떤 소스든 영상이 실제로 만들어지는 재료가 됩니다. 정해진 템플릿을 꾸미는 장식이 아니에요. 에이전트는 가져온 내용을 읽고 장면이 몇 개 필요한지 정한 뒤 콘텐츠 그래프 스토리보드를 씁니다. 핵심 요점이 프레임이 되고, 요점 사이의 관계(이것은 저것에 이어진다, 이것은 저것과 대비된다)가 엣지가 되며, 고른 템플릿의 시각 스타일이 프레임마다 적용됩니다. 그래서 1,500단어짜리 기사는 속도감 있는 여러 장면의 설명 영상이 되고 그 모든 문장은 소스의 무언가로 거슬러 올라갈 수 있으며, 저장소는 프로젝트가 실제로 무엇인지 보여 주는 구조적인 안내 영상이 됩니다.


빠른 시작

준비물

요구 사항최소확인
Node.js20+node --version
pnpm9+pnpm --version
ffmpeg최근 버전 아무거나ffmpeg -version
Chromium (또는 Playwright 브라우저)—npx playwright install chromium

기본 렌더링 엔진은 헤드리스 Chromium 브라우저에서 애니메이션 HTML을 녹화한 뒤 ffmpeg(libx264)로 MP4를 인코딩합니다. 시스템에 Chromium이 없다면 Playwright의 Chromium을 설치하세요.

npx playwright install chromium

설치하고 실행하기

pnpm install
pnpm -r build
node packages/cli/dist/bin.js studio    # http://127.0.0.1:3071 에서 스튜디오를 엽니다

스튜디오에서는 템플릿을 고르거나(또는 영상을 설명하거나 링크를 붙여 넣고), 에이전트와 대화하고, 프레임별 글을 고치고, 사운드트랙을 더하고, MP4로 내보냅니다.

CLI 도구:

node packages/cli/dist/bin.js doctor                 # 설치된 에이전트와 엔진을 감지합니다
node packages/cli/dist/bin.js search-templates --intent "github stars race" --top 3

지원하는 에이전트

PATH에서 자동으로 감지하며, 스튜디오 상단 바에서 사용 중인 에이전트를 바꿉니다. 스튜디오는 **Open Design (Vela)**를 맨 앞에 둡니다. 로그인 한 번으로 여러 모델을 쓰고 비용도 낮기 때문입니다. 그다음에는 쓸 수 있는 첫 에이전트로 돌아가므로, 새 프로젝트에도 항상 동작하는 백엔드가 있습니다.

에이전트감지호출 방식
Open Design (Vela)vela / Open Design 앱에 번들됨stdio 위의 ACP — Open Design에서 로그인 한 번, 모델은 자유롭게 선택
Windsurf CLIwindsurfwindsurf --yolo, stdio 위의 ACP
Trae CLItraeclitraecli acp serve --yolo, stdio 위의 ACP
Claude Codeclaudeclaude --print, 프롬프트는 stdin
Cursor Agentcursor-agentcursor-agent --print
Codex CLIcodexcodex exec, 프롬프트는 stdin
HermeshermesHermes ACP CLI
Gemini CLIgemini프롬프트는 stdin
Grok Buildgrokgrok -p <prompt>
Qwen Codeqwen프롬프트는 stdin
OpenCodeopencodeopencode run, 프롬프트는 stdin
GitHub Copilot CLIcopilotcopilot --allow-all-tools, 프롬프트는 stdin
Aideraideraider --message <prompt>
Anthropic APIBYOK(내 키 사용)Messages API 직접 호출 — CLI가 설치되어 있지 않아도 동작

아무것도 설치돼 있지 않나요? Anthropic 키를 설정하면 스튜디오가 Messages API와 직접 통신합니다.


사운드트랙

완성된 영상에 목소리를 입혀 보세요. Settings → Audio에서 MiniMax API 키를 추가한 뒤, 프로젝트별 Soundtrack 패널에서 다음을 쓸 수 있습니다.

  • 배경음악 — 분위기를 설명하면(calm cinematic ambient, slow build) MiniMax가 연주곡을 만들어 줍니다.
  • 내레이션 — 대본을 입력하면 MiniMax가 읽어 줍니다(TTS).

둘 다 ffmpeg를 통해 내보내는 MP4에 섞입니다(음악은 목소리 아래로 낮아지고, 페이드 인/아웃은 선택). 키를 설정하지 않아도 스튜디오의 나머지 기능은 그대로 동작합니다.


템플릿 갤러리

21개 템플릿은 아무렇게나 모아 놓은 묶음이 아닙니다. 각각 스튜디오가 시작할 때 훑어 읽는 template.html-video.yaml 매니페스트로 설명되는, 에이전트가 읽을 수 있는 독립 단위입니다. 매니페스트에는 에이전트가 HTML을 열어 보지 않고도 템플릿을 고르고 다루는 데 필요한 모든 것이 들어 있습니다.

  • 무엇에 쓰는지 — category, tags, 그리고 search-templates가 내 의도와 맞춰 보는 best_for 목록(예: 「기업 슬라이드」, 「미니멀 리포트 카드」).
  • 무엇을 출력하는지 — 지원하는 해상도, 화면 비율, fps, 길이 범위, 알파 채널이나 오디오가 있는지.
  • 무엇을 넣는지 — inputs JSON 스키마. 에이전트가 어떤 글 · 데이터 칸을 채워야 하는지 정확히 압니다.
  • 라이선스 출처 — SPDX id와 명시적인 attribution_required / redistribution_allowed / commercial_use 플래그, 원본 소스 URL을 가리키는 assets_attribution 블록.

마지막 항목은 의도한 것입니다. 모든 템플릿은 구조적으로 라이선스 문제가 없습니다. 포크는 원래 라이선스를 그대로 지니고, 저장소 루트의 NOTICE.md가 각 출처와 SPDX를 기록하며, 명확한 허용 라이선스가 없는 것은 들어오지 않습니다. 따라서 별도 점검 없이 상업 작업에 써도 됩니다. 템플릿은 데이터 시각화(NYT 스타일 차트, 스위스/비녤리 그리드), 타이틀과 VFX(글리치, 키네틱 타이포, 타자기 커서), 히어로와 시네마틱(리퀴드 그라데이션, 라이트 릭, 따뜻한 그레인), 제품 프로모션(15초 / 30초 멀티 신), 설명 영상 뼈대(의사결정 트리)에 걸쳐 있고, 형식이 열려 있어서 커뮤니티 템플릿도 같은 방식으로 넣을 수 있습니다.


아키텍처

packages/
├── core/                  Project / Asset / ContentGraph 타입, 레지스트리, 오케스트레이터,
│                          MiniMax 제공자 + ffmpeg 오디오 믹스
├── content-graph/         멀티 프레임 스토리보드 IR (노드 + 엣지, 위상 정렬)
│ runtime/               에이전트 런타임 — 감지 / 실행 / 스트리밍
│                          (Open Design/Vela · Windsurf CLI · Trae CLI · Claude · Cursor · Codex · Gemini · Grok · Qwen · OpenCode · Copilot · Aider · Hermes · Anthropic API)
├── adapter-hyperframes/   Hyperframes 엔진 어댑터 — Chromium + ffmpeg로 실제 렌더
├── cli/                   `html-video` 명령 + 스튜디오 HTTP 서버 + 소스 가져오기
└── project-studio/        브라우저 스튜디오 UI (채팅, 템플릿 갤러리, 프레임, 사운드트랙, 내보내기)
templates/                 라이선스 문제 없이 엄선한 영상 템플릿 21개
research/                  RFC (엔진 어댑터 / 템플릿 메타데이터 / 에이전트 스킬 / 콘텐츠 그래프)

로드맵

  • 엔진 어댑터 규격 — 인터페이스 하나, 백엔드 N개
  • 템플릿 메타데이터 형식 — 라이선스 우선, 에이전트가 읽을 수 있음
  • 멀티 프레임 스토리보드 워크플로(콘텐츠 그래프)
  • 스튜디오: 실시간 템플릿 갤러리, 에이전트 전환기, 프레임별 글 편집
  • 소스 자료: 기사 / GitHub 저장소 → 영상
  • AI 사운드트랙(MiniMax 음악 + 내레이션), 내보낼 때 믹스
  • 실제 MP4 렌더 — 헤드리스 Chromium + ffmpeg 기반 Hyperframes 엔진
  • 에이전트 모델 선택 — Open Design (Vela) 백엔드, 실시간 모델 목록
  • Remotion / Motion Canvas / Revideo 어댑터
  • 에이전트 스킬 패키지 + 템플릿 마켓플레이스

참고와 계보

프로젝트여기서의 역할
Open Design자매 프로젝트 — 디자인 에이전트 메타 레이어. 같은 팀, 같은 철학
HTML Anything자매 프로젝트 — 정적 결과물을 위한 HTML. html-video는 모션 쪽
Hyperframes출시된 엔진 어댑터. HTML+CSS+GSAP 렌더링 방식과, Apache-2.0 템플릿 여러 개의 출처

라이선스

Apache-2.0

만든 곳

nexu-io — Open Design을 만든 팀. Discord에 참여하고 @nexudotio를 팔로우하세요.


저장소: https://github.com/nexu-io/html-video

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0