Command-line export
Render .screencut projects to MP4 from the terminal using the
same engine as the GUI. Useful for batch jobs, CI pipelines, and remote
automation.
The tool
Screen Cut Pro ships with a screencut-export binary alongside the
GUI app. Find it inside the app bundle:
/Applications/Screen Cut Pro.app/Contents/MacOS/screencut-export
Add a symlink to make it shell-accessible:
sudo ln -s "/Applications/Screen Cut Pro.app/Contents/MacOS/screencut-export" /usr/local/bin/screencut-export
Usage
screencut-export <project.screencut> <output.mp4> [options]
Options
| Flag | What it does |
|---|---|
--width <N> | Output width in pixels (default 1920). |
--height <N> | Output height in pixels (default 1080). |
--fps <N> | Frame rate (default 60). |
--720p | Shorthand for 1280×720. |
--1080p | Shorthand for 1920×1080. |
--1440p | Shorthand for 2560×1440. |
--4k | Shorthand for 3840×2160. |
--no-webcam | Exclude the webcam overlay. |
--no-cursor | Exclude the cursor and click effects. |
--no-mic | Exclude microphone audio. |
Examples
1080p at 30 fps without the webcam:
screencut-export demo.screencut demo.mp4 --1080p --fps 30 --no-webcam
4K at 60 fps:
screencut-export demo.screencut demo-4k.mp4 --4k --fps 60
Custom resolution for a vertical video:
screencut-export demo.screencut shorts.mp4 --width 1080 --height 1920 --fps 30
Use cases
- CI pipelines — regenerate a tutorial video whenever its
.screencutsource changes. - Batch re-encoding — loop over a directory of
.screencutfiles to bulk-export to a new resolution. - Headless servers — run on a Mac mini in a closet without ever opening the GUI.