Configuration

Configuration

src/settings.json

Auto-created on first run if missing. Not committed to git (machine-specific).

Colors & role tags

"colors": {
  "ok": "green",
  "warn": "yellow",
  "err": "darkred",
  "info": "cyan",
  "chat": "auto",
  "mod": "blue",
  "owner": "orange"
}

• "chat": "auto" (default) colors each chatter's name with a stable 24-bit hue - the same person always gets the same color, different people get different colors, drawn from the full 16.7-million-color palette.
• Set "chat": "gray" (or any other name) to use a single fixed color for all chat lines instead.
• mod / owner are the [Mod] / [Owner] tags shown in front of a message.

Voting thresholds

"voting": {
  "revertVMVoteThreshold": 2,
  "restartVMVoteThreshold": 2
}

See Voting.

Typing limits (optional)

"typing": {
  "maxLength": 80
}

• maxLength caps how many characters !type / !send will type (e.g. 80).
• 0 (default) = no limit.
• Commands that exceed the cap fail with !type text is too long (N chars, max M) - handy against chatter spam payloads.

Typing speed knobs

Hardcoded in src/cli.mjs:

• TYPE_BURST = 8 - consecutive shift-free chars are merged into bursts of 8 per RPC round-trip.
• TYPE_DELAY = 35 - ms gap between bursts inside the bridge (pacing, not RTT).

Measured on this guest: ~160 codes/s sustained drops keys; ~50/s is safe (~20-25 chars/s end to end). Don't raise TYPE_BURST aggressively without stress-testing.

Session logs

Every session's console output is saved to logs/session-<timestamp>.log when you exit (Ctrl+C / quit) or run !live stop.

OBS scene switching

The optional OBS WebSocket integration is also configured in settings.json - see OBS-Scene-Switching.