CLI Reference · Experimental

Local proxy commands

Create and manage derived local video variants while keeping originals authoritative.

Preserve every original

Proxy commands are an FFmpeg-backed experiment. A proxy is derived media, not a source master, backup, stable interchange format, or fidelity guarantee.

Command	Experimental behavior	Exact syntax
proxy-generate	Generate local derived variants with FFmpeg/FFprobe	dits proxy-generate [FILES]... [OPTIONS]
proxy-status	Summarize the local proxy store	dits proxy-status
proxy-list	List local generated variants	dits proxy-list [-v\|--verbose]
proxy-delete	Delete matching local derived variants	dits proxy-delete [FILES]... [--all]

Generate

dits proxy-generate [FILES]... [OPTIONS]

Options:
-r, --resolution <VALUE>   1080, 720, 540, half, or quarter
-c, --codec <VALUE>        h264, h265, prores, prores-lt, dnxhr, or dnxhr-sq
-p, --preset <VALUE>       fast, hq, or offline
    --all                  Use recognized video files tracked in HEAD

dits proxy-generate footage/scene.mp4 --preset fast
dits proxy-generate footage/scene.mov --resolution 720 --codec h264
dits proxy-generate --all --preset offline

Generation requires both ffmpeg and ffprobe on PATH. With --all, Dits selects its current extension-bounded set of tracked video paths from HEAD. Without files or --all, the command fails.

Inspect and delete local variants

dits proxy-status
dits proxy-list
dits proxy-list --verbose

dits proxy-delete footage/scene.mp4
dits proxy-delete --all

Delete operates only on the local derived proxy store and does not delete the original tracked file. It is still destructive for generated variants, so inspect the list first.

What this is not

There is no remote proxy upload, partial clone, on-demand hydration, background queue, cloud cache, automatic generation on commit, quality guarantee, or cross-device synchronization. Flags for jobs, force, custom bitrate, output directory, JSON, and watch mode do not exist.

See video experiments and use dits proxy-generate --help for parser-authoritative syntax.