Recording Basics
How to Start and Stop Screen Recording from the Command Line
FastCast's console controller lets a PowerShell script, scheduled workflow, macro pad, or automation tool start and stop a screen recording. The main FastCast window remains responsible for capture settings; fastcastc.exe sends a guarded command to that already-running instance and returns an exit code your script can inspect.
Published · By Calvin Sturm
What you need before using the controller
- Download and extract the current FastCast portable ZIP.
- Keep
fastcast.exeandfastcastc.exetogether. - Open
fastcast.exeand choose capture, audio, quality, and output settings. - Leave the FastCast window running; the controller does not launch it automatically.
- Open PowerShell in the extracted FastCast folder.
The controller uses the same validation and state guards as the Record button and the global Ctrl+Alt+F9 hotkey. It will not bypass a missing source or invalid configuration.
Start a recording from PowerShell
Run:
.\fastcastc.exe --start-recordFastCast starts with the source and settings currently selected in its window. Keeping configuration in the GUI makes the automation command short and prevents scripts from silently changing audio, quality, or output choices.
Choose which monitor to record
To select Display 2 as the command starts the recording:
.\fastcastc.exe --start-record --monitor 2The number maps to the display numbering FastCast receives from Windows. Verify the selected screen in the FastCast preview before relying on it for unattended capture. An unknown monitor number is rejected rather than silently recording a different screen.
Stop the recording and check the result
Run:
.\fastcastc.exe --stop-recordWait for FastCast to finalize the MP4. Its Last recording panel reports the file, validation result, size, and any warning, with Open and Show in folder actions. For the full manual workflow, see how to record your screen on Windows.
Check exit codes in a PowerShell script
& .\fastcastc.exe --start-record --monitor 2
if ($LASTEXITCODE -ne 0) {
throw "FastCast could not start recording."
}
# Run the task you need to capture here.
& .\fastcastc.exe --stop-record
if ($LASTEXITCODE -ne 0) {
throw "FastCast could not stop recording."
}Harmless no-ops return exit code 0—for example, asking an already-recording instance to start again. Invalid arguments, an unavailable monitor, or a real control failure return nonzero. Separate Start and Stop calls are safer for automation than a toggle because the desired end state is explicit.
Troubleshooting command-line recording
- FastCast is not running: launch
fastcast.exe, finish setup, and retry. The controller intentionally leaves nothing running in the background. - Command not found: run it as
.\fastcastc.exefrom the extracted folder or provide the complete quoted path. - Monitor rejected: confirm the display number in the FastCast Screen list and reconnect or enable any missing monitor.
- Recording will not start: inspect the FastCast window for its validation message. Source, output folder, encoder, or audio setup may need attention.
- Recording stutters: test hardware encoding and lower resolution or frame rate using the recording performance guide.
Automate your next screen recording
Download the FastCast portable ZIP, configure the main app once, and use fastcastc from PowerShell whenever a script needs deterministic Start and Stop actions.