StreamdeckVSCS

Control the vatSys VSCS panel from an Elgato Stream Deck.

Two parts work together:

• vatSys plugin (VscsStreamdeckBridge.dll) — runs inside vatSys and exposes VSCS state/actions over a local HTTP bridge (127.0.0.1:18084).
• Stream Deck plugin (com.leviticus.streamdeck-vscs) — polls the bridge and renders/controls VSCS lines on your Stream Deck keys.

Installing

1. Copy the StreamdeckVSCS folder (from the release zip) into your vatSys plugins folder: C:\Program Files (x86)\vatSys\bin\Plugins
2. Double-click com.leviticus.streamdeck-vscs.streamDeckPlugin inside that folder — Stream Deck will prompt to install it. Accept, and you're done.

Using

• In Stream Deck, add the VSCS Line action to a key.
• Each line button can be set to Auto-detect or Manual pick:
  • Auto-detect + ID: Assign a unique numeric ID (1–60) to each button. As VSCS lines appear, the plugin maps one line per ID (hotlines first, then coldlines). Each ID is only used once, so you won't get duplicate lines on different buttons, and the mapping stays stable even if VSCS reorders or reconnects lines.
  • Manual: Pick a specific line from the detected list. The button is locked to that line only.
• Buttons reflect VSCS status without opening the VSCS window:
  • Hotlines: idle yellow; active green.
  • Coldlines: idle blue; pending flashes purple/blue; active solid purple.
• The VSCS Mute action toggles your mic mute and shows COORD LIVE/MUTE status.
• The VSCS Speaker All action toggles "All to Speaker" (lights up yellow when engaged), same as the SPKR ALL button on the VSCS setup page.
• The VSCS Devices action opens (or focuses) the vatSys Audio Settings window, same as the DEVICES button in VSCS.

Building a release

Run from the repo root (PowerShell):

.\build-release.ps1

This builds the vatSys bridge (Release), builds and packages the Stream Deck plugin, and assembles dist\StreamdeckVSCS\ (plus dist\StreamdeckVSCS.zip) containing the DLL, the .streamDeckPlugin file, and install instructions — ready to distribute.

Requirements:

• Visual Studio (MSBuild + .NET Framework 4.7.2 targeting pack)
• Node.js 20+
• vatSys installed (or pass -VatSysDir <path> if it's somewhere non-standard)

Development

vatSys bridge (StreamdeckVSCSvatSysPlugin/VscsStreamdeckBridge): open VscsStreamdeckBridge.sln in Visual Studio and build. The project references vatSys.exe from the vatSys install directory (override with the VatSysDir MSBuild property).

Stream Deck plugin (StreamdeckVSCSPlugin/streamdeck-vscs):

npm install
npm run build     # compile to the .sdPlugin/bin folder
npm run watch     # rebuild on change and restart the plugin in Stream Deck
npm run package   # produce the .streamDeckPlugin installer file