Home

Offdis-VM Wiki

YouTube live chat → control a VirtualBox machine. Viewers post commands in your stream chat and they get executed as real keyboard input inside the VM.

Getting started

• Installation - no npm install, no node_modules (see the repo README)
• Commands - everything chat (and you) can type
• Macros - reusable command sequences with one trigger word
• Voting - vote-gated !restartvm / !revertvm safety
• Snapshots - the safety net, and keeping the snapshot tree flat
• Configuration - colors, role tags, vote thresholds
• Live-Chat-Fallback - the DOM fallback when YouTube 429s
• OBS-Scene-Switching - themed scenes around !restartvm / !revertvm

What it does

Topic	Where
Install & run	repo README
All commands (!key, !type, !send, !combo, !import, !wait)	Commands
Writing macros	Macros
Vote thresholds	Voting
Colors & settings.json	Configuration
Restart / revert semantics	Voting
Live chat DOM fallback (429)	Live-Chat-Fallback
OBS scene switching	OBS-Scene-Switching

Caution

Chat commands are fully open by design - anyone in chat can type. Snapshots are your safety net, so keep one before every stream.

Quick facts

• Windows only (driven through VirtualBox's COM API via a PowerShell bridge) - it only needs Node 18+ and VirtualBox. macOS / Linux are not supported.
• Chat commands run as one serialized unit per message - two chatters can never interleave keystrokes mid-command.
• Typing is burst-optimized (~20-25 chars/s sustained).
• Macros live in macros/ and each has its own readthis.txt guide.

Example: !import

Want chat to be able to launch something with one message? Create macros/minecraft.txt:

# comments start with #
!combo win+r
!type minecraft
!key enter
!wait 8000
!key enter

Then anyone in chat just posts !import minecraft and the whole sequence runs end-to-end, uninterrupted. See Macros for the full guide.