⚠️ Alpha software. Mainly tested on macOS by a single developer. Expect rough edges on Linux, and pin versions if you rely on it. Windows is not supported; binaries ship for macOS (arm64/x64) and Linux (x64/arm64) only.
Preview a cinematic film look in the browser, then batch-apply it from the CLI. GPU-accelerated colour, halation, bloom, grain, vignette, split-tone, aberration, and camera shake — one binary, no plugins, no subscriptions.
# Try it with no install (needs ffmpeg on your PATH: `brew install ffmpeg`)
npx @orva-studio/hance video.mp4 # or `bunx` if you use Bun
# Or install a persistent binary to ~/.hance/bin
curl -fsSL https://hance.video/install.sh | sh
# Preview presets on your footage and dial in a look
hance ui video.mp4
# Batch-apply a look from the CLI
hance video.mp4 --preset my-lookLooks saved from the UI live in ~/.hance/presets/ and are referenced by name. See the Installation and Quick Start guides for details.
The hance binary carries its own agent skill so any AI harness gets version-matched instructions at runtime:
hance skills # the router / entry doc (for AI harnesses)
hance skills list # available subcommand + reference docs
hance skills get refine # print one doc
hance skills path # extract the docs to a local dir- Introduction — what hance is and who it's for
- Commands & options — full CLI reference
- Effects — the effect pipeline and per-effect flags
- Output quality — codecs, CRF, ProRes
- Config file —
.hancerc.jsondefaults - Looks — built-in and custom
.hlookpresets - AI agent usage — drive hance from Claude Code in plain English
Only needed to hack on hance itself — the released CLI binary requires none of this.
git clone https://github.com/Orva-Studio/hancer.git
cd hancer
bun install
bun run build # wgpu sidecar + UI bundle + CLI binary → ./hance
bun test # unit testsRequires Bun, Rust, and FFmpeg. See ARCHITECTURE.md for the monorepo layout and rendering pipeline.
FSL-1.1-Apache-2.0 — free to use, modify, and redistribute. Cannot be used to build a competing product or service. Converts to Apache 2.0 on April 1, 2028.