Getting Started

Install

Install Cropbox from PyPI:

pip install cropbox

Install from a local checkout:

pip install .

Cropbox requires ffmpeg and ffprobe to inspect media and perform exports.

Typical install on Ubuntu or Debian:

sudo apt install ffmpeg

Launch The App

Start the desktop UI:

cropbox

Open a file immediately:

cropbox input.mp4

Open a file with an initial trim and crop:

cropbox input.mp4 --trim-in 12.5 --trim-out 00:00:20.000 --crop 100 50 1280 720

Start at a specific time or frame:

cropbox input.mp4 --current-time 00:00:12.500
cropbox input.mp4 --current-frame 300

Run A Headless Export

Export directly without opening the UI:

cropbox input.mp4 --out output.mp4

Overwrite an existing output file:

cropbox input.mp4 --out output.mp4 --force

Export a trimmed and cropped region:

cropbox input.mp4 --out output.mp4 --trim-in 12.5 --trim-out 20 --crop 100 50 1280 720