0 Fork 0

mirror of https://github.com/storytold/filmcraft.git synced 2026-10-14 19:26:59 -04:00

T

Brandon ThomasandClaude Opus 5.5 45f3c6c7d0 README: hero + gallery from public-domain films (Night of the Living Dead, Carnival of Souls, Charade) with CC0 Chopin; attribution sidecars and credits; Export defaults to H.264 MP4 with a ~/Movies path

Co-Authored-By: Claude Opus 5.5 <[email protected]>

2026-09-30 22:32:04 -04:00

.cargo

M0.12: xtask layers/wasm/ci gates (layer table, same-layer allow-list, UI crates barred below L5); cargo alias

2026-09-30 10:02:36 -04:00

apps

M6.2: own AAC-LC decoder replaces the symphonia bootstrap for AAC; AAC encoder for MP4 export

2026-09-30 07:38:47 -04:00

assets

AGENTS.md asset rules (no Adobe iconography/images; open licences only; per-asset .attribution sidecars + ATTRIBUTION.md), cargo xtask assets gate in ci; hevc test fixture temp names unique per thread

2026-09-30 11:18:48 -04:00

crates

README: hero + gallery from public-domain films (Night of the Living Dead, Carnival of Souls, Charade) with CC0 Chopin; attribution sidecars and credits; Export defaults to H.264 MP4 with a ~/Movies path

2026-09-30 22:32:04 -04:00

docs

2026-09-30 22:32:04 -04:00

xtask

2026-09-30 11:18:48 -04:00

.gitignore

M0.3–M0.8: geom, color, frame, media generators, project model, edit algebra, CPU renderer

2026-09-30 05:58:41 -04:00

.mcp.json

M14: MCP server (headless + bridge to live app), filmcraft-cli (probe/commands/render/run/mcp), .mcp.json, control protocol docs

2026-09-30 06:50:31 -04:00

AGENTS.md

2026-09-30 11:18:48 -04:00

ATTRIBUTION.md

2026-09-30 22:32:04 -04:00

Cargo.lock

M7.3: clip audio effects run on filmcraft-audio-dsp (Amplify, Dynamics, Hard Limiter, Delay, Parametric EQ, High/Low/Bandpass, DeNoise, DeHummer, Studio Reverb, Invert, Pitch Shifter) with keyframed params, latency compensation and a continuation cache with pre-roll for random access

2026-09-30 11:40:58 -04:00

Cargo.toml

Merge branch 'worktree-agent-a4193d1e7345108d5'

2026-09-30 11:12:22 -04:00

CLAUDE.md

2026-09-30 11:18:48 -04:00

README.md

2026-09-30 22:32:04 -04:00

ROADMAP.md

ROADMAP: MKV import, LUFS meters, audio effects

2026-09-30 11:41:11 -04:00

rustfmt.toml

M0.1/M0.2: workspace skeleton, time and bitstream crates

2026-09-30 05:33:20 -04:00

README.md

FilmCraft

Non-linear video editing, reimagined in pure Rust.
An open-source, clean-room take on the Adobe Premiere Pro workflow: native on macOS, Windows and Linux, and in the browser via WebAssembly.
By the artcraft team.

_{Colour. Grading Charade (1963) with Lumetri-style curves and scopes.}	_{Keyframes. An eased push-in on the title, with value and velocity graphs.}
_{Export. H.264 MP4 with our own encoder.}	_{Footage: Night of the Living Dead (1968), Carnival of Souls (1962) and Charade (1963), all in the US public domain; music: Chopin performed for Musopen (CC0). The media is not in this repository; full credits in ATTRIBUTION.md.}

Highlights

Own codecs, in Rust. H.264 decoder (bit-exact against ffmpeg, 500+ fps at 1080p) and encoder (High profile, CABAC, B-frames, 2-pass), HEVC Main/Main 10 decoder, ProRes decode and encode, AAC-LC decode and encode, MP4/MOV and Matroska/WebM containers. No FFmpeg inside.
Real editing. Insert, overwrite, ripple, roll, slip, slide, rate stretch, razor, lift/extract, nesting and markers, all built on an exact integer time base (254,016,000,000 ticks per second), so frame math never drifts.
GPU compositing. A wgpu compositor samples YUV directly with footprint supersampling and blends in linear light, with a matching CPU path. Playback runs in real time at 1080p, using the audio clock as master.
Colour. Lumetri-style grading: basic correction, creative looks, RGB and hue curves, colour wheels, HSL secondary and vignette, plus waveform and vectorscope.
Keyframes. Linear, Bezier, auto/continuous Bezier, hold and ease, with value and velocity graphs.
Audio. EBU R128 / BS.1770 loudness meters (momentary, short-term, integrated, true peak), and clip effects (EQ, filters, dynamics, limiter, delay, reverb, DeNoise, DeHum, pitch shift) on our own DSP library.
Export. H.264 MP4 with AAC, ProRes and MJPEG MOV, PNG sequences, GIF and WAV, run as background jobs.
Agent-drivable. Every action is a command. The UI, a CLI, a JSON control channel and an MCP server all drive the same engine, so Claude or any agent can edit, grade and export.

Status

Early but moving fast: roughly 30% of the way to Premiere Pro parity. See ROADMAP.md for milestone status and estimates.

Quick start

cargo run --release -p filmcraft                           # desktop app with the demo project
cargo run --release -p filmcraft -- --control 9876         # plus the JSON-lines control server
cargo run --release -p filmcraft-cli -- commands           # list every engine command
cargo run --release -p filmcraft-cli -- mcp                # MCP server (headless)

The control protocol is documented in docs/control-protocol.md.

Architecture

A layered Cargo workspace: codecs and containers at the bottom, then frames and media, project model and edit algebra, rendering and export, the engine (command registry, session, undo), and finally the swappable UI (ui-egui). Nothing below the UI layer depends on a UI toolkit or OS APIs, and everything up to the engine compiles to wasm32. cargo xtask ci checks formatting, lints, tests, the layering rules and the wasm build.

Crafting Apps

Open-source, clean-room, pure-Rust creative tools. Each runs natively on macOS, Windows and Linux, and on the web.

PhotoCraft	Image editing and compositing, Photoshop-class: layers, masks, adjustments and byte-exact PSD/PSB round trips.
DrawCraft	Vector illustration, Illustrator-class: paths, shapes, type and artboards.
FilmCraft	Non-linear video editing, Premiere Pro-class: timeline editing, own codecs, GPU compositing, colour and export. You are here.
LightCraft	Photo library and non-destructive raw developer, Lightroom-class: catalog, culling, develop and export.
PrintCraft	PDF viewing and editing, Acrobat-class: pages, annotations, forms and document tools.

Clean room

FilmCraft is an independent implementation. It contains no Adobe code, assets, presets or LUTs, and no GPL/LGPL code; codecs are implemented from the public ITU-T and ISO specifications. ffmpeg is used only as an external test oracle. Adobe and Premiere Pro are trademarks of Adobe Inc.; FilmCraft is not affiliated with Adobe.