Resources
The resources node caps the compute a session may consume and tunes how the screen is streamed: scheduling priority and host placement, memory and CPU ceilings, desktop resolution, frame rate, streamer pipeline mode, disk quota and fine capture offsets.
resourcesScheduling and placement
| Property | Type | Default | Values / range | Notes |
|---|---|---|---|---|
priority * | enum | — | low, normal, high | Scheduling priority used to resolve resource contention between sessions. |
hostPlacement * | string | — | auto or a host ID | auto load-balances across backends; a host ID pins the session. |
Compute limits
| Property | Type | Default | Min / max | Units |
|---|---|---|---|---|
maxMemoryMB * | integer | — | 512 – 65536 | MB (512 MB – 64 GB) |
maxCpuPercent * | integer | — | 1 – 100 | percent |
diskQuotaMB | integer | — | min 100 | MB; empty = unlimited (editor caps the field at 1,048,576) |
Display resolution
| Property | Type | Default | Min / max | Units |
|---|---|---|---|---|
maxDesktopWidth | integer | 3840 | 800 – 7680 | pixels |
maxDesktopHeight | integer | 2160 | 600 – 4320 | pixels |
The editor offers 720p / 1080p / 1440p / 4K presets that set both values together.
Frame rate and streaming
| Property | Type | Default | Values / range | Notes |
|---|---|---|---|---|
frameRateTarget | integer | 12 | 1 – 60 fps | Frame rate while the session is active. |
frameRateIdle | integer | 6 | 1 – 30 fps | Reduced frame rate during idle periods. |
enableAdaptiveFrameRate | boolean | true | — | Automatically drops to the idle rate during inactivity. |
activityThresholdKB | integer | 16 | 1 – 1024 KB | Frame-size threshold used to detect meaningful activity. Disabled when adaptive frame rate is off. |
streamerMode | enum | balanced | performance, balanced, lean | performance: fps priority, screen compressor for large regions. balanced: deflate-fastest for all regions. lean: deflate-optimal for large regions (lowest bandwidth). |
Streamer offsets
Fine adjustments under resources.streamerOffsets for window capture cropping and mouse coordinate alignment. The schema defaults are non-zero, but the built-in templates ship them at 0; only change them to correct a specific capture or pointer misalignment.
| Property | Type | Default | Units | Notes |
|---|---|---|---|---|
appVerticalOffset | integer | 8 | pixels | Pixels skipped at the top of the captured window (excludes frame/border). |
appHorizontalOffset | integer | 0 | pixels | Pixels skipped at the left of the captured window. |
mouseXOffset | integer | 8 | pixels | Horizontal mouse coordinate adjustment. |
mouseYOffset | integer | 0 | pixels | Vertical mouse coordinate adjustment. |
Sample
"resources": {
"priority": "normal",
"hostPlacement": "auto",
"maxMemoryMB": 8192,
"maxCpuPercent": 100,
"maxDesktopWidth": 3840,
"maxDesktopHeight": 2160,
"frameRateTarget": 30,
"frameRateIdle": 10,
"streamerMode": "balanced",
"enableAdaptiveFrameRate": true,
"activityThresholdKB": 20,
"diskQuotaMB": 10240,
"streamerOffsets": {
"appVerticalOffset": 0,
"appHorizontalOffset": 0,
"mouseXOffset": 0,
"mouseYOffset": 0
}
}
The streaming knobs have global defaults that policy overrides when present: frameRateTarget, frameRateIdle, activityThresholdKB and enableAdaptiveFrameRate come from <activityDetection>; streamerMode, maxDesktopWidth/Height and the offsets come from <webstreamSettings>. maxMemoryMB, maxCpuPercent, priority, hostPlacement and diskQuotaMB are policy-only with no app.config equivalent.
Properties marked * (priority, hostPlacement, maxMemoryMB, maxCpuPercent) are required by the schema.