Input Injection Configuration

Configure keyboard and mouse input handling, DataChannels, and thread priority

Overview

The host.input section controls how keyboard and mouse input from the remote client is injected into the target application, including injection policies, transport mechanisms, and thread priority settings.

Injection Policy

input.injectionPolicy · string · default: "REQUIRE_FOREGROUND"

Policy for when input injection is allowed.

Default: REQUIRE_FOREGROUND

Options:

• REQUIRE_FOREGROUND - Only inject when target window is foreground
• ALWAYS - Always inject regardless of focus
• DISABLED - Disable input injection

Using ALWAYS may cause input to be injected into unintended applications.

input.allowFocusSteal · boolean · default: "false"

Allow stealing focus from other windows.

Default: false

When enabled, automatically brings target window to foreground when input is received.

input.releaseAllOnDisconnect · boolean · default: "true"

Release all pressed keys/buttons when client disconnects.

Default: true

Prevents stuck keys when client disconnects unexpectedly.

Always keep this enabled to avoid stuck key issues.

Mouse Configuration

input.mousePolicy · string · default: "DPI_AWARE"

Mouse coordinate scaling policy.

Default: DPI_AWARE

Options:

• DPI_AWARE - Scale coordinates based on system DPI
• ABSOLUTE - Use absolute coordinates without scaling
• RELATIVE - Use relative mouse movements

DPI_AWARE is recommended for accurate cursor positioning across different display configurations.

input.clipCursorToTarget · boolean · default: "false"

Confine cursor to target window boundaries.

Default: false

When enabled, prevents cursor from leaving the target window.

input.coalesceMouseMoves · boolean · default: "true"

Combine multiple mouse move events into single injection.

Default: true

Reduces CPU usage by batching rapid mouse movements.

input.maxMouseMovesPerFrame · integer · default: "100"

Maximum mouse move events to process per frame.

Default: 100

Limits processing overhead from rapid mouse movement.

input.enableMouseSequencing · boolean · default: "false"

Enable strict ordering of mouse events.

Default: false

May add latency but ensures exact event ordering.

Keyboard Configuration

input.blockWinKeys · boolean · default: "true"

Block Windows key presses on the host.

Default: true

Prevents accidentally opening Start menu or triggering Windows shortcuts during streaming.

Keep enabled to avoid interruptions during gaming sessions.

input.blockSystemKeys · boolean · default: "false"

Block all system key combinations (Alt+Tab, Ctrl+Alt+Del, etc.).

Default: false

Only enable in controlled environments. Makes it difficult to exit the application.

input.repeatPolicy · string · default: "THROTTLED"

Key repeat handling policy.

Default: THROTTLED

Options:

• THROTTLED - Limit repeat rate to maxKeyRepeatHz
• PASSTHROUGH - Forward all repeats from client
• DISABLED - Ignore all key repeats

Throttled mode prevents network flooding from held keys.

input.maxKeyRepeatHz · integer · default: "30"

Maximum key repeat frequency in Hz when throttled.

Default: 30 Hz

Standard keyboard repeat rate is ~30 Hz.

input.keyRepeatDelayMs · integer · default: "250"

Initial delay before key repeat starts.

Default: 250 ms

Matches standard OS keyboard repeat delay.

Transport Configuration

input.usePionDataChannels · boolean · default: "true"

Use WebRTC DataChannels for input transport.

Default: true

DataChannels provide lower latency than WebSocket. Only disable for compatibility.

Always use DataChannels for best performance.

input.enableLegacyWebSocket · boolean · default: "false"

Enable fallback WebSocket transport.

Default: false

Only needed for clients that don’t support DataChannels.

input.maxPendingMessages · integer · default: "100"

Maximum queued input messages before dropping.

Default: 100

Prevents memory buildup when injection falls behind.

Injection Rate Limiting

input.maxInjectHz · integer · default: "10000"

Maximum input injection rate in Hz.

Default: 10000 Hz (10 kHz)

Absolute maximum rate for all input events combined.

input.inputQueueTimeoutMs · integer · default: "10"

Timeout for input queue processing.

Default: 10 ms

Error Handling and Recovery

input.enableStuckKeyRecovery · boolean · default: "true"

Automatically detect and release stuck keys.

Default: true

Monitors for keys that remain pressed longer than timeout.

input.stuckKeyTimeoutMs · integer · default: "2000"

Time in milliseconds before a key is considered stuck.

Default: 2000 ms (2 seconds)

input.enableSequenceRecovery · boolean · default: "true"

Recover from input sequence errors.

Default: true

Attempts to resynchronize input state after errors.

input.maxRecoveryAttempts · integer · default: "3"

Maximum recovery attempts before giving up.

Default: 3

input.strictErrorHandling · boolean · default: "false"

Stop processing on first injection error.

Default: false

When false, continues processing despite occasional errors.

input.logInjectionErrors · boolean · default: "true"

Log input injection errors.

Default: true

input.maxConsecutiveErrors · integer · default: "10"

Maximum consecutive errors before stopping injection.

Default: 10

Logging

input.enablePerEventLogging · boolean · default: "false"

Log every individual input event.

Default: false

Generates massive log output. Only enable for debugging specific issues.

input.enableAggregatedLogging · boolean · default: "true"

Log aggregated input statistics.

Default: true

Periodically logs summary statistics (events/sec, errors, etc.).

input.logIntervalMs · integer · default: "60000"

Interval for aggregated logging in milliseconds.

Default: 60000 ms (1 minute)

Thread Priority (MMCSS)

Multimedia Class Scheduler Service (MMCSS) settings for input thread priority.

input.threadPriority.enableMMCSS · boolean · default: "true"

Enable MMCSS thread priority boosting.

Default: true

MMCSS gives real-time priority to reduce input latency.

Keep enabled for lowest input latency in gaming scenarios.

input.threadPriority.mmcssClass · string · default: "Games"

MMCSS task class name.

Default: Games

Options: Games, Audio, Capture, Distribution, Playback, Pro Audio, Window Manager

Games class provides optimal priority for gaming input.

input.threadPriority.enableTimeCritical · boolean · default: "true"

Use time-critical priority level.

Default: true

Maximum priority short of real-time kernel threads.

input.threadPriority.threadPriority · integer · default: "15"

Win32 thread priority level.

Default: 15 (TIME_CRITICAL)

Range: -15 (IDLE) to 15 (TIME_CRITICAL)

input.threadPriority.taskName · string · default: "InputInjection"

MMCSS task name for tracking.

Default: InputInjection

input.threadPriority.fallbackToWin32Priority · boolean · default: "true"

Fall back to Win32 priority if MMCSS fails.

Default: true

Ensures elevated priority even if MMCSS is unavailable.

input.threadPriority.showDiagnosticsOnFailure · boolean · default: "true"

Show diagnostics if priority elevation fails.

Default: true

input.threadPriority.retryMMCSSOnFailure · boolean · default: "false"

Retry MMCSS registration on failure.

Default: false

input.threadPriority.mmcssRetryDelayMs · integer · default: "1000"

Delay between MMCSS retry attempts.

Default: 1000 ms

Adaptive Quality Control

Adaptive input dropping based on network conditions.

input.adaptiveQualityControl.enableAdaptiveDropping · boolean · default: "true"

Enable adaptive input event dropping during congestion.

Default: true

Drops low-priority input events when network quality degrades.

input.adaptiveQualityControl.rttExcellentThreshold · float · default: "10.0"

RTT threshold for excellent network quality (ms).

Default: 10.0 ms

input.adaptiveQualityControl.rttGoodThreshold · float · default: "50.0"

RTT threshold for good network quality (ms).

Default: 50.0 ms

input.adaptiveQualityControl.rttFairThreshold · float · default: "100.0"

RTT threshold for fair network quality (ms).

Default: 100.0 ms

input.adaptiveQualityControl.rttPoorThreshold · float · default: "200.0"

RTT threshold for poor network quality (ms).

Default: 200.0 ms

input.adaptiveQualityControl.lossExcellentThreshold · float · default: "0.01"

Packet loss threshold for excellent quality.

Default: 0.01 (1%)

input.adaptiveQualityControl.lossGoodThreshold · float · default: "0.05"

Packet loss threshold for good quality.

Default: 0.05 (5%)

input.adaptiveQualityControl.lossFairThreshold · float · default: "0.10"

Packet loss threshold for fair quality.

Default: 0.10 (10%)

input.adaptiveQualityControl.lossPoorThreshold · float · default: "0.20"

Packet loss threshold for poor quality.

Default: 0.20 (20%)

input.adaptiveQualityControl.queueExcellentThreshold · integer · default: "1"

Input queue depth for excellent quality.

Default: 1

input.adaptiveQualityControl.queueGoodThreshold · integer · default: "3"

Input queue depth for good quality.

Default: 3

input.adaptiveQualityControl.queueFairThreshold · integer · default: "6"

Input queue depth for fair quality.

Default: 6

input.adaptiveQualityControl.queuePoorThreshold · integer · default: "12"

Input queue depth for poor quality.

Default: 12

input.adaptiveQualityControl.excellentDropRatio · float · default: "0.0"

Input drop ratio for excellent quality (0.0-1.0).

Default: 0.0 (no dropping)

input.adaptiveQualityControl.goodDropRatio · float · default: "0.0"

Input drop ratio for good quality (0.0-1.0).

Default: 0.0 (no dropping)

input.adaptiveQualityControl.fairDropRatio · float · default: "0.0"

Input drop ratio for fair quality (0.0-1.0).

Default: 0.0 (no dropping)

input.adaptiveQualityControl.poorDropRatio · float · default: "0.0"

Input drop ratio for poor quality (0.0-1.0).

Default: 0.0 (no dropping)

input.adaptiveQualityControl.criticalDropRatio · float · default: "0.0"

Input drop ratio for critical quality (0.0-1.0).

Default: 0.0 (no dropping)

input.adaptiveQualityControl.minFrameIntervalMs · integer · default: "0"

Minimum interval between input frames (ms).

Default: 0 (no throttling)

input.adaptiveQualityControl.statsUpdateIntervalMs · integer · default: "100"

Network statistics update interval (ms).

Default: 100 ms

Example Configurations

Competitive Gaming (Ultra-Low Latency)

{
  "input": {
    "blockWinKeys": true,
    "injectionPolicy": "REQUIRE_FOREGROUND",
    "mousePolicy": "DPI_AWARE",
    "coalesceMouseMoves": false,
    "usePionDataChannels": true,
    "threadPriority": {
      "enableMMCSS": true,
      "mmcssClass": "Games",
      "enableTimeCritical": true
    },
    "adaptiveQualityControl": {
      "enableAdaptiveDropping": false
    }
  }
}

Casual Gaming (Balanced)

{
  "input": {
    "blockWinKeys": true,
    "injectionPolicy": "REQUIRE_FOREGROUND",
    "mousePolicy": "DPI_AWARE",
    "coalesceMouseMoves": true,
    "repeatPolicy": "THROTTLED",
    "maxKeyRepeatHz": 30,
    "usePionDataChannels": true
  }
}

High Latency Network

{
  "input": {
    "coalesceMouseMoves": true,
    "maxMouseMovesPerFrame": 50,
    "repeatPolicy": "THROTTLED",
    "maxKeyRepeatHz": 20,
    "adaptiveQualityControl": {
      "enableAdaptiveDropping": true,
      "fairDropRatio": 0.2,
      "poorDropRatio": 0.5
    }
  }
}