Module proxy

Proxy media: background all-intra low-res transcodes of imported video, played instead of the originals in the preview. Every proxy frame is a keyframe (-g 1), so seeks, reverse scrubs and clip-boundary cold opens decode without reference chains — the reason big NLEs feel instant. Proxies live in the cache dir, named by a hash of (source path, mtime, height): a re-exported source gets a fresh proxy automatically and stale files are just never referenced again. Export and full-quality one-shot renders never see proxies (their DecoderPools carry no map).

Functions

dir

generate

Transcode src into its proxy file on a background thread (temp + rename; the destination never exists half-written). Video only — audio always plays from the original.

proxy_path

Where the proxy for src at height lives (whether or not it has been built yet).

run 🔒