Hance

⚠️ Beta software. Stable on macOS; Linux is lightly tested, so pin versions to be safe. 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.

📖 Full documentation →

Quick start

# 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-look

Looks saved from the UI live in ~/.hance/presets/ and are referenced by name. See the Installation and Quick Start guides for details.

Agent skill

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

Documentation

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.json defaults
Looks — built-in and custom .hlook presets
AI agent usage — drive hance from Claude Code in plain English

Build from source

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 tests

Requires Bun, Rust, and FFmpeg. See ARCHITECTURE.md for the monorepo layout and rendering pipeline.

License

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.

🔗 More in this category