OpenFilm
- 추천0
- GitHub 별7.9K
- 영상라이선스MIT
코딩 에이전트가 HTML 한 파일로 영상을 만들고, 브라우저 편집기 Studio에서 직접 고칠 수 있는 오픈소스 AI 영상 에이전트. MIT
요약
코딩 에이전트가 HTML 한 파일로 영상을 만들고, 브라우저 편집기 Studio에서 직접 고칠 수 있는 오픈소스 AI 영상 에이전트. MIT
설명
오픈소스 AI 영상 에이전트
HTML 파일 하나, 함수 하나, 진짜 편집기 하나.
소개
OpenFilm은 코딩 에이전트가 영상을 만들게 하고, 사람이 그 영상을 직접 고칠 수 있게 해 줍니다.
Codex, Claude Code 같은 코딩 에이전트에게 영상을 만들어 달라고 하세요. 에이전트는 영상을 웹 페이지로 쓰고, 브라우저에서 돌아가는 로컬 편집기 Studio가 영상이 만들어지는 모습을 보여 줍니다. 그런 다음 직접 손으로 또는 말로 부탁해서 원하는 것을 무엇이든 바꿀 수 있습니다.
- HTML 파일 하나.
film.html이 움직이는 웹 페이지, 영상 소스, 사진, 소리를 트랙 위에 이어 붙이고 CSS로 꾸밉니다. 새로 배울 것이 없습니다. 에이전트는 이미 웹을 알고 있으니까요. - 함수 하나. 각 장면은
frame(t)로 어느 순간이든 그려 내는 웹 페이지입니다. three.js, WebGL, canvas, SVG, CSS, GSAP, 영상 등 브라우저가 그릴 수 있는 것은 무엇이든 쓸 수 있습니다. (Remotion이나 HyperFrames 같은) 프레임워크는 필요 없고, 함수 하나면 충분합니다. - 진짜 편집기 하나. 페이지 안의 모든 요소를 옮기고, 키우고, 돌리고, 글자 · 색 · 스타일을 바꿀 수 있습니다. 모든 클립을 놓고, 자르고, 다시 꾸미고, 타임라인에서 다듬고 나눌 수 있습니다.

▶ 1분 42초짜리 출시 영상 보기 — 처음부터 끝까지 OpenFilm으로 만들었습니다.
설치
macOS, Windows, Linux에서 Node 22.2 이상과 ffmpeg가 필요합니다(Studio의 저장 버전 기능에는 git도 필요). 처음 실행하면 헤드리스 Chromium(약 100MB)을 내려받습니다.
npx skills add openfilm/openfilm
그런 다음 에이전트에게 영상을 부탁하세요.
내 CLI를 소개하는 20초짜리 출시 영상을 음악과 함께 만들어 줘.
에이전트가 영상을 Studio에서 열어 주고, 영상이 만들어지는 모습을 볼 수 있습니다. 에이전트가 스킬을 쓸 수 없다면 이렇게 말하세요. "npx -y openfilm@latest를 실행하고 출력되는 내용을 따라 해 줘."
또는 openfilm.dev나 Releases에서 macOS · Windows용 데스크톱 앱을 내려받으세요. Studio 옆에 사용 중인 에이전트와 대화하는 채팅 창이 붙어 있습니다. ffmpeg와 헤드리스 브라우저가 함께 들어 있어서 따로 설치할 것이 없습니다.
영상을 만들고, 고치고, 렌더링하는 데는 계정이 필요 없고, OpenFilm의 음악 · 효과음 · 음성 · 스티커 · 전환 · 효과 · 템플릿 라이브러리도 무료로 쓸 수 있습니다. 생성형 음성 · 음악 · 이미지 · 영상은 쓰는 서비스(ElevenLabs, OpenAI, Google, OpenRouter, fal 등)를 Studio의 설정 → 서비스(Settings → Services)에서 내 키로 연결하거나, 거기서 OpenFilm에 로그인하면 내 키 없이도 만들 수 있습니다.
완성된 영상에서 시작하려면 예제 중 하나를 여세요.
npx -y openfilm@latest open https://github.com/openfilm/examples/tree/main/one-prompt
명령
에이전트가 실행하는 명령이며, 직접 실행해도 됩니다. npx -y openfilm@latest <command> 또는 npm i -g openfilm으로 쓰세요.
openfilm # 영상이란 무엇인지, OpenFilm 자체 스킬은 무엇인지: 에이전트가 시작하는 곳
openfilm open [folder | url] # Studio에서 영상 열기: 새 영상, 기존 영상, GitHub의 영상, 아니면 이 영상이나 마지막 영상
openfilm look [what] [t | a-b] # 영상, 페이지, 미디어 파일 확인: 컨택트 시트, 한 프레임, 또는 구간
openfilm render [a-b] # MP4 만들기; --4k, --blur (모션 블러), --alpha (.webm / .mov), --loudness=-14
openfilm get [what] # 미디어: OpenFilm 라이브러리에서 무료로 먼저, 없으면 연결한 서비스로 생성
openfilm canvas [apply <steps>] # 편집 옆의 캔버스: 읽기, 또는 메모 · 파일 · 만들 것을 배치
openfilm skills # 영상을 만들 때 쓸 수 있는 스킬; `openfilm skill <name>`은 하나를 출력
openfilm doctor # 이 컴퓨터에 OpenFilm용으로 있는 것, 이슈에 붙여 넣는 용도
openfilm <command> --help는 명령의 옵션을 보여 주고, openfilm get만 실행하면 만들 수 있는 것, 라이브러리에 있는 것, Studio에서 서비스를 연결하는 방법을 보여 줍니다.
Studio
Studio는 내 컴퓨터의 브라우저에서 돌아갑니다. 영상을 그리고 내보내는 엔진인 Chromium 기반 브라우저(Chrome, Edge)를 쓰세요. 그래야 미리 보기가 곧 내보내는 결과가 됩니다. 영상 속 모든 것을 바꿀 수 있습니다. 화면의 글자와 레이어, 타임라인의 클립, 클립의 위치 · 모양 · 음량 · 속도, 자막까지요. 고친 내용은 영상 파일에 저장되어 에이전트가 보고 그대로 이어 가고, 이름을 붙인 버전을 저장해 되돌아갈 수도 있습니다. 영상, GIF, 소리(또는 스템), 자막, 스틸 이미지, 슬라이드, 투명 영상, 그리고 Final Cut Pro · Premiere Pro · DaVinci Resolve용 타임라인 자체를 내보낼 수 있습니다.
편집 화면 옆에는 캔버스가 있습니다(⌘E로 둘 사이를 전환). 사람과 에이전트가 메모, 사진, 클립, 내레이션, 음악, 효과음을 늘어놓고, 서로 이어 붙이고, 연결한 서비스로 각각을 만들고, 만든 것을 순서대로 타임라인에 보내는 보드입니다. 프로젝트마다 캔버스를 여러 개 둘 수 있고, 각 캔버스는 스토리보드로도 볼 수 있습니다. 에셋 서랍의 라이브러리에는 영상 소스, 음성, 효과음, 음악, 글자, 스티커, 필터, 효과, 전환, 템플릿, 그리고 스킬이 들어 있습니다.
데스크톱 앱(apps/desktop)은 Studio 옆에 Claude Code, Codex 등의 에이전트와 대화하는 채팅 창이 붙은 형태이고, 내 키로 쓰는 자체 에이전트도 있습니다.
스킬
영상을 만드는 방법은 도구가 아니라 스킬에 들어 있습니다. openfilm은 한 페이지를 출력합니다. 영상이란 무엇인지, 그리고 나머지를 담고 있는 OpenFilm 자체 스킬이 무엇인지 알려 줍니다. 자체 스킬은 edit(프로젝트, film.html과 페이지, 그리고 이를 점검하는 일), media(라이브러리와 서비스), canvas입니다. 에이전트는 작업에 필요한 스킬을 openfilm skill <name>으로 읽습니다.
그 밖의 스킬은 모두 어떤 종류의 영상을 만드는 방법이며, owner/name이라는 전체 이름으로 부릅니다. Studio 라이브러리의 Discover(찾아보기)에는 openfilm/skills에서 가져온 OpenFilm과 커뮤니티의 스킬이 나열되고, 스킬을 직접 쓰는 방법도 그 저장소에 있습니다. 거기서 스킬을 설치하거나, 설치하지 않고 대화에서 써 보거나, 링크나 폴더로 내 스킬을 추가할 수 있습니다(openfilm skill add <link>). 설치한 스킬은 모든 에이전트가 쓸 수 있습니다.
동작 방식
영상은 film.html이 든 폴더이고, 클립을 이어 붙인 트랙들로 이뤄집니다.
<meta name="viewport" content="width=1920, height=1080">
<style>
.card { object-fit: cover; border-radius: 24px; }
</style>
<section>
<iframe src="title.html#t=0,4"></iframe>
</section>
<section>
<video src="assets/footage.mp4#t=12,18" at="4" speed="0.5" class="card" style="left: 160px; top: 90px; width: 1600px; height: 700px"></video>
</section>
<section>
<audio src="assets/music.mp3" volume="0.6"></audio>
</section>
각 <section>은 트랙이고, 타임라인에 보이는 순서대로 놓입니다. 맨 앞이 가장 위입니다. 클립은 하나의 요소입니다. 페이지, 영상, 정지 사진, 소리가 클립이 될 수 있습니다. 파일의 어느 구간을 재생할지는 미디어 프래그먼트(#t=12,18), 언제 시작할지는 at, 어디에 놓일지는 스타일의 left · top · width · height, 어떻게 보일지는 CSS가 정합니다. 모든 소리는 자기만의 클립입니다. overrides에는 페이지 요소에 한 사람의 수정이 담기고, 에이전트가 영상을 고칠 때도 그대로 유지합니다.
페이지는 자기 자신의 어느 순간이든 그려 내는 웹 페이지이며, 약속은 이것뿐입니다.
<script type="module">
window.film = {
frame(t) { /* t초 시점의 완성된 화면을 무엇으로든 그린다 */ },
duration: 4, // 선택: 페이지 자체의 길이(초)
ready: loadFonts(), // 선택: 글꼴 · 이미지 · 모델 · 데이터를 기다리는 Promise
width: 480, height: 320, // 선택: 화면의 일부만 차지하는 페이지
};
</script>
단 하나의 규칙: 앞에서 무엇을 그렸든 같은 t는 언제나 같은 그림을 그려야 합니다. 프레임은 순서와 상관없이, 병렬로, 프레임 사이(모션 블러용)에서도 요청되므로, 이 규칙을 지키는 페이지는 어떤 크기, 어떤 컴퓨터에서도 똑같이 렌더링됩니다. 그림을 만드는 그 밖의 것(Python, Blender, 영상 모델)은 영상이나 이미지로 가져옵니다.
OpenFilm은 모델이 자주 틀리는 곳, 즉 영상을 점검하는 데 힘을 씁니다. look은 컨택트 시트의 모든 프레임을 순서를 두 번 섞어 두 번씩 그리고, 달라진 프레임을 짚어 냅니다. 페이지 오류, 불러오지 못한 글꼴, 없는 소리 파일, 화면에서 잘린 글자도 함께 알려 줍니다.
MANUAL.md는 openfilm이 출력하는 페이지이고, packages/openfilm/manual에는 OpenFilm 자체 스킬이 들어 있습니다. SPEC.md는 플레이어 · 렌더러 · 편집기를 만들려는 사람을 위한 문서입니다.
소스에서 실행
Node 22.18 이상, pnpm 9(corepack enable을 실행하면 이 저장소가 정한 버전이 설치됩니다), PATH에 있는 ffmpeg, git이 필요합니다.
git clone https://github.com/openfilm/openfilm && cd openfilm
pnpm install
pnpm dev # 이 체크아웃의 Studio를 샘플 영상과 함께 실행, 설치된 OpenFilm 옆에서
pnpm test
코딩 에이전트에게 packages/openfilm/.dev/bin/openfilm을 실행하라고 하면, 에이전트가 내 체크아웃으로 그 Studio에서 영상을 만듭니다. 설치한 OpenFilm이든 소스로 실행한 OpenFilm이든 프로젝트는 같은 라이브러리에 보관됩니다.
pnpm dev:desktop은 데스크톱 앱을 소스로 실행하고, pnpm typecheck · pnpm build · pnpm audit:public은 이름 그대로 동작합니다. 각 패키지의 자세한 내용은 CONTRIBUTING.md에 있습니다.
커뮤니티
질문, 아이디어, 직접 만든 영상은 Discussions로 보내세요. Q&A에서 질문하고, Show and tell에서 내 영상을 공유할 수 있습니다. 버그는 Issues로 보내며, Studio의 설정 → 개발자 → 리포트 복사(Settings → Developer → Copy report) 또는 npx openfilm doctor로 만든 리포트를 함께 붙여 주세요.
기여하기
CONTRIBUTING.md를 보세요. 보안 문제를 알리려면 SECURITY.md를 보세요.
라이선스
포맷, CLI, Studio, 데스크톱 앱은 MIT입니다. OpenFilm 이름과 로고는 상표입니다. TRADEMARK.md를 보세요.
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0