Docs
vidovaSettings schema
Field specification for the vidovaSettings object used by Vidova MCP tools.
Export vidovaSettingsSchema from the desktop Zod sources.
| Field | Type | Required | Constraints | Default | Description |
|---|---|---|---|---|---|
layout | enum("screen-and-cam", "screen-only", "cam-only", "half-half") | no | — | — | — |
crop | object | no | — | — | Normalized crop edges for the screen recording: Left/Top/Right/Bottom in the 0..1 range. |
crop.Top | number | no | min 0; max 1 | — | — |
crop.Bottom | number | no | min 0; max 1 | — | — |
crop.Left | number | no | min 0; max 1 | — | — |
crop.Right | number | no | min 0; max 1 | — | — |
zoomLayerId | string | no | — | — | Use a zoom layer ID from timeline_get_state. Pass an empty string to clear. |
blurLayerId | string | no | — | — | Use an overlay/blur layer ID from timeline_get_state. Pass an empty string to clear. |
roundedness | number | no | min 0; max 50 | — | — |
padding | number | no | min 0; max 100 | — | — |
screenAudioVolume | number | no | min 0; max 1 | — | — |
cameraAudioVolume | number | no | min 0; max 1 | — | — |
muteScreenAudio | boolean | no | — | — | — |
muteCameraAudio | boolean | no | — | — | — |
zoomAnimationStyle | enum("soft-spring", "snappy-spring", "soft-landing", "fast-settle", "gentle-curve") | no | — | — | Zoom feel: soft-spring (default), snappy-spring, soft-landing, fast-settle, gentle-curve. |
panAnimationStyle | enum("heavy-camera", "quick-follow", "soft-lag") | no | — | — | Pan feel: heavy-camera (default), quick-follow, soft-lag. |
linkedZoomTransitionDuration | number | no | min 0; max 2 | — | — |
useAutoLinkedZoomTransitionDuration | boolean | no | — | — | Set true to clear the manual linked zoom handoff duration. |
trackingIntensity | integer | no | min 0; max 5 | — | — |
trackingStyle | enum("steadicam", "director", "anchor", "momentum") | no | — | — | Camera-path solver for cursor-following zooms: steadicam, director, anchor, or momentum. |
clickFollow | object | no | strict | — | Keep out-of-view clicks in frame and near centre. Clicks already in view stay put. enabled (default true), tight 0.05-0.45 (default 0.35), zoom 1-6 (steadicam click-punch cap, default 3.5), window 0.2-1.6s (default 0.8), lead 0-0.8s (default 0.38), margin 0.35-1 (steadicam hold slack, default 0.85). Partial objects merge with the clip current values. |
clickFollow.enabled | boolean | no | — | — | — |
clickFollow.tight | number | no | min 0.05; max 0.45 | — | — |
clickFollow.window | number | no | min 0.2; max 1.6 | — | — |
clickFollow.lead | number | no | min 0; max 0.8 | — | — |
clickFollow.zoom | number | no | min 1; max 6 | — | — |
clickFollow.margin | number | no | min 0.35; max 1 | — | — |
motionBlurStrength | number | no | min 0; max 2 | — | — |
cursorHidden | boolean | no | — | — | False shows the cursor. |
cursorStyle | enum("default", "cartoon", "modern", "original", "banana", "capitaine-dark", "capitaine-light", "touch", "tahoe", "whitesur", "bibata", "bibata-original") | no | — | — | — |
cursorSize | number | no | min 16; max 256 | — | — |
smoothCursorChanges | boolean | no | — | — | — |
hideCursorWhenStill | boolean | no | — | — | — |
enableCursorMotionBlur | boolean | no | — | — | — |
cursorMotionBlurStrength | number | no | min 0; max 2 | — | — |
enableCursorTilting | boolean | no | — | — | — |
cursorClickSfx | boolean | no | — | — | Play mouse click sounds (down and up). Default true. |
returnToOriginalPosition | boolean | no | — | — | — |
cursorSmoothingStyle | enum("original", "steady", "soft", "fluid", "glide") | no | — | — | Cursor path: original, steady (default), soft, fluid, glide. |
pinCursorToClicks | boolean | no | — | — | Pin the path through each click so the cursor lands on the button. |
cursorClickPinWindow | number | no | min 0.04; max 0.4 | — | How long the cursor holds on each click, in seconds. Default 0.12. |
cursorSmoothingTime | number | no | min 0.01; max 0.12 | — | Steady and Soft smoothness in seconds. Default 0.045. |
cursorSmoothingSpace | number | no | min 4; max 80 | — | Steady: how strongly fast flicks are kept, in pixels. Default 18. |
cursorSmoothingTension | number | no | min 40; max 400 | — | Fluid spring weight. Default 170. |
cursorSmoothingFriction | number | no | min 4; max 40 | — | Fluid spring damping. Default 20. |
cursorSmoothingSimplify | number | no | min 2; max 40 | — | Glide: how much jitter to drop before the curve. Default 8. |
clickEffectStyle | enum("none", "default", "effect-1", "effect-2", "effect-3", "effect-4", "effect-5", "effect-6") | no | — | — | — |
clickEffectSize | number | no | min 16; max 256 | — | — |
cursorSpotlight | object | no | strict | — | — |
cursorSpotlight.enabled | boolean | no | — | — | — |
cursorSpotlight.radius | number | no | — | — | — |
cursorSpotlight.softness | number | no | — | — | — |
cursorSpotlight.dimOpacity | number | no | — | — | — |
cursorSpotlight.onlyOnClick | boolean | no | — | — | — |
cursorSpotlight.clickWindow | number | no | min 0.05; max 4 | — | — |
camera | object | no | — | — | — |
camera.size | number | no | min 5; max 70 | — | — |
camera.sizeDuringZoom | number | no | min 5; max 100 | — | — |
camera.roundedness | number | no | min 0; max 100 | — | — |
camera.shape | enum("default", "squircle", "circle") | no | — | — | — |
camera.hideCamera | boolean | no | — | — | False shows the camera overlay. |
camera.mirrorCamera | boolean | no | — | — | — |
camera.removeBackground | boolean | no | — | — | True composites the baked person mask. The mask must already exist on the camera asset. |
camera.position | object | no | — | — | Camera anchor grid position. Use -1, 0, or 1 for x/y. |
camera.position.x | number | yes | min -1; max 1 | — | — |
camera.position.y | number | yes | min -1; max 1 | — | — |
camera.alignment | object | no | — | — | Crop alignment inside squircle/circle camera shapes. |
camera.alignment.x | number | yes | min -1; max 1 | — | — |
camera.alignment.y | number | yes | min -1; max 1 | — | — |
camera.differentSizeDuringZoom | boolean | no | — | — | — |
camera.verticalPadding | number | no | min 0; max 100 | — | — |
camera.globalPosition | boolean | no | — | — | True anchors the camera to the scene instead of the clip. |
mouseIndicator | object | no | — | — | — |
mouseIndicator.enabled | boolean | no | — | — | — |
mouseIndicator.position | object | no | — | — | Mouse indicator anchor grid position. Use -1, 0, or 1 for x/y. |
mouseIndicator.position.x | number | yes | min -1; max 1 | — | — |
mouseIndicator.position.y | number | yes | min -1; max 1 | — | — |
mouseIndicator.size | number | no | min 40; max 180 | — | Mouse indicator size in px. |
mouseIndicator.opacity | number | no | min 0; max 1 | — | — |
mouseIndicator.style | enum("minimal", "dark", "light", "colored") | no | — | — | — |
mouseIndicator.highlightColor | string | no | pattern ^#[0-9a-fA-F]\{6\}$ | — | — |
mouseIndicator.minActiveDuration | number | no | min 0.02; max 0.5 | — | Minimum button/wheel highlight duration in seconds. |
mouseIndicator.globalPosition | boolean | no | — | — | True anchors the mouse indicator to the scene instead of the clip. |
quality | number | no | min 0 | — | Motion-blur shader sample quality. 0 disables sampled motion blur. |
sharpenFactor | number | no | min 0; max 5 | — | — |
shadowStrength | number | no | min 0; max 100 | — | — |
inset | number | no | min 0; max 50 | — | — |
isVertical | boolean | no | — | — | — |
showShortcuts | boolean | no | — | — | — |
keyboardClickSfx | boolean | no | — | — | Play a click sound on recorded key presses. Default true. |
keyboardClickSfxMode | enum("shortcuts", "all") | no | — | — | Which key presses get a click sound: "shortcuts" for modifier combos only, "all" for every key press. Default "shortcuts". |
shortcutsSize | number | no | min 1; max 300 | — | — |
shortcutsDuration | number | no | min 0.5; max 5 | — | — |
captionSettings | object | no | strict | — | — |
captionSettings.enabled | boolean | no | — | — | — |
captionSettings.fontFamily | string | no | — | — | — |
captionSettings.fontWeight | 400 \ | 500 \ | 700 | no | — |
captionSettings.fontSize | number | no | — | — | — |
captionSettings.distanceFromBottom | number | no | — | — | — |
captionSettings.style | enum("pill", "karaoke-lime", "karaoke-magenta", "karaoke-cyan", "outlined", "bold-outline", "minimal", "word-highlight", "pink-pill", "dark-pill-lime", "cloud-blob", "amber-tape", "studio") | no | — | — | — |
captionSettings.textColor | string | no | — | — | — |
captionSettings.highlightColor | string | no | — | — | — |
captionSettings.backgroundColor | string | no | — | — | — |
captionSettings.shadowColor | string | no | — | — | — |
captionSettings.shadowBlur | number | no | — | — | — |
captionSettings.maxCharsPerLine | number | no | — | — | — |