Configuration Overview

Configuration Structure

CloudGaming uses a config.json file that must be present in the host application’s working directory. The configuration is divided into two main sections:

client - Browser client configuration for signaling and matchmaking
host - Host application configuration for capture, encoding, audio, input, and networking

config.json Location

The configuration file must be located in the same directory as the host executable:

DisplayCaptureProject.exe
config.json  ← must be here

Configuration Sections

Video Encoding

Frame rate, bitrate, NVENC presets, HDR tone mapping

Audio Capture

Process loopback, Opus encoding, WASAPI settings

Input Injection

Mouse/keyboard policies, DataChannels, thread priority

Screen Capture

WGC capture, copy pools, frame queuing, MMCSS

Network

Signaling servers, matchmaker, ICE/TURN setup

Basic Structure

{
  "client": {
    "serverUrlBase": "wss://signaling-server.example.com",
    "matchmakerUrl": "https://matchmaker.example.com"
  },
  "host": {
    "targetProcessName": "Game.exe",
    "signalingUrl": "wss://signaling-server.example.com",
    "matchmaker": { ... },
    "window": { ... },
    "video": { ... },
    "capture": { ... },
    "audio": { ... },
    "input": { ... },
    "debug": { ... }
  }
}

Client Configuration

The client section configures browser client connection endpoints.

string

required

WebSocket URL for the signaling server. Must use wss:// protocol for secure connections.Default: wss://signaling-server-production-acd4.up.railway.app

string

required

HTTP(S) URL for the matchmaker service that assigns clients to available hosts.Default: https://matchmaker-production-5b36.up.railway.app

Host Configuration

Target Process

string

required

Name of the executable to capture (e.g., SandFall-Win64-Shipping.exe).This process will be the target for screen capture and input injection.

string

required

WebSocket URL for host-to-signaling-server connection.Default: wss://signaling-server-production-acd4.up.railway.app

Window Configuration

boolean

default:"true"

Automatically resize the target window’s client area to match target dimensions.

integer

default:"1920"

Target window width in pixels.

integer

default:"1080"

Target window height in pixels.

Debug Options

boolean

default:"false"

Enable raw audio capture recording to WAV file for debugging.

This will create large files and impact performance. Use only for debugging.

string

default:"output.wav"

Output filename for WAV recording when enabled.

Best Practices

Start with the default configuration and adjust settings incrementally based on your specific requirements and network conditions.

Performance Tuning

Low Latency Priority: Set video.bf to 0, use video.rc as cbr, enable audio.latency.strictLatencyMode
High Quality Priority: Increase video.bitrateMax, use slower video.preset (p5-p7), increase audio.bitrate
Network Constrained: Lower video.bitrateStart, enable adaptive bitrate controllers

Production Deployment

Always use secure WebSocket connections (wss://) and HTTPS (https://) in production deployments.

Use production-grade signaling servers with Redis clustering
Configure TURN servers for NAT traversal
Set appropriate hostSecret for matchmaker authentication
Enable MMCSS for capture and input threads
Test with your target applications and network conditions

Configuration Validation

The host application will validate the configuration on startup and log errors for:

Missing required fields
Invalid value ranges
Incompatible setting combinations
Missing dependencies (e.g., NVENC on non-NVIDIA GPUs)

Check the console output for configuration warnings and errors before starting a streaming session.

Getting Started

Deployment

Components

Configuration

Operations

Configuration Overview

Configuration Structure

config.json Location

Configuration Sections

Video Encoding

Audio Capture

Input Injection

Screen Capture

Network

Basic Structure

Client Configuration

Host Configuration

Target Process

Window Configuration

Debug Options

Best Practices

Performance Tuning

Production Deployment

Configuration Validation

​Configuration Structure

​config.json Location

​Configuration Sections

Video Encoding

Audio Capture

Input Injection

Screen Capture

Network

​Basic Structure

​Client Configuration

​Host Configuration

​Target Process

​Window Configuration

​Debug Options

​Best Practices

​Performance Tuning

​Production Deployment

​Configuration Validation

Configuration Structure

config.json Location

Configuration Sections

Basic Structure

Client Configuration

Host Configuration

Target Process

Window Configuration

Debug Options

Best Practices

Performance Tuning

Production Deployment

Configuration Validation