Record the Windows desktop, or a precise pixel region of it, to an MP4 via ffmpeg's gdigrab capture - bounded duration, no background threads to forget to stop.
Record the whole desktop (or, if 'region' is set, one rectangle of it) for a fixed number of seconds and save it as an MP4.
Inputs
Name
Type
Required / default
Values and notes
duration_seconds
float
required
out
path
optional, default ""
fps
int
optional, default 30
region
string
optional, default ""
show_cursor
bool
optional, default true
Outputs
Name
Type
Notes
file
path
duration_seconds
float
fps
int
Record a region
record_region
Record a rectangular pixel region of the desktop (x, y, width, height, in absolute desktop coordinates) for a fixed number of seconds and save it as an MP4.
Inputs
Name
Type
Required / default
Values and notes
x
int
required
y
int
required
width
int
required
height
int
required
duration_seconds
float
required
out
path
optional, default ""
fps
int
optional, default 30
show_cursor
bool
optional, default true
Outputs
Name
Type
Notes
file
path
duration_seconds
float
fps
int
Use it
Record the desktop
Command line
shell
python app.py --action record --params '{"duration_seconds": 1.0}'
Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
