Configuration

Most settings are handled by the setup wizard and the Settings item in the tray menu. For anything not exposed there, you can edit the config file directly.

Location

~/Library/Application Support/dev.crowd-cast.agent/config.toml

%LOCALAPPDATA%\crowd-cast\config.toml

~/.config/agent/config.toml

Example

[capture]
target_apps = ["com.google.Chrome", "com.apple.Terminal"]
capture_all = false
start_on_login = true
idle_timeout_secs = 120
pause_uploads_on_idle = true

[input]
capture_keyboard = true
capture_mouse_move = true
capture_mouse_click = true
capture_mouse_scroll = true

[recording]
autostart_on_launch = true
segment_duration_secs = 300
notify_on_start_stop = true

[upload]
delete_after_upload = true
max_concurrent_uploads = 2

`[capture]`

Option	Default	Description
`target_apps`	`[]`	The apps to record. macOS uses bundle IDs; Linux uses the window app id on Wayland (the `app_id`/`wm_class`, e.g. `org.gnome.Evince`). On sway, capture is full-screen, so this is ignored. Managed for you by the wizard / Settings.
`capture_all`	`false`	Record every app, ignoring `target_apps`.
`start_on_login`	`false`	Launch crowd-cast automatically at login. The wizard recommends turning this on.
`idle_timeout_secs`	`120`	Seconds of no keyboard/mouse activity before auto-pausing. `0` disables idle pausing.
`pause_uploads_on_idle`	`true`	Also pause uploads while idle.
`single_active_app_capture`	`true` on macOS	Keep only the foreground target app’s capture source active at a time.
`blank_video_on_untracked_app`	`true`	Show a black screen (instead of capturing) when a non-selected app is in front.

`[input]`

Option	Default	Description
`capture_keyboard`	`true`	Record key presses/releases.
`capture_mouse_move`	`true`	Record mouse movement.
`capture_mouse_click`	`true`	Record mouse clicks.
`capture_mouse_scroll`	`true`	Record scrolling.

`[recording]`

Option	Default	Description
`autostart_on_launch`	`true`	Start recording as soon as the app launches.
`segment_duration_secs`	`300`	Length of each recording segment, in seconds (5 minutes). `0` disables segmenting.
`notify_on_start_stop`	`true`	Show a notification when recording starts/stops.
`max_output_height`	`1080`	Downscale video to this height (preserving aspect ratio).
`fps`	`30`	Recording frame rate.
`enable_audio`	`false`	Record audio. Off by default; crowd-cast is video + input only.

`[upload]`

Option	Default	Description
`delete_after_upload`	`true`	Delete the local copy of a segment once it’s uploaded.
`max_concurrent_uploads`	`2`	How many segments to upload at once.