DotBot.Aether.Console

Aether Console conduit — Elgato Stream Deck integration for dotbot. Part of the dotbot-aether conduit plugin collection.

What It Does

Bridges the Stream Deck hardware to dotbot's event bus via an HTTP sidecar server. Button presses trigger dotbot actions; event bus events update button states, icons, and the touch strip. Includes a TypeScript Stream Deck plugin and a PowerShell sidecar.

Platform: Windows only.

Components

• PowerShell Sidecar (src/DotBot.Aether.Console/) — HTTP server on port 7331 that manages deck state and bridges to dotbot
• Stream Deck Plugin (src/DotBot.sdPlugin/) — TypeScript plugin using Elgato SDK that polls the sidecar

Quick Start

Import-Module ./src/DotBot.Aether.Console/DotBot.Aether.Console.psd1

# Discover and connect
Find-AetherConsole | Connect-AetherConsole

# Or start the sidecar directly
Start-DotBotServer
Get-DotBotServerStatus

Aether Contract Functions

Every Aether conduit exports these standard lifecycle functions:

• Initialize-AetherConsole — validate config and hardware reachability
• Find-AetherConsole — discover Stream Deck app and hardware
• Connect-AetherConsole — bond to discovered hardware
• Disconnect-AetherConsole — clean shutdown
• Test-AetherConsole — health check
• Invoke-AetherConsoleEvent — handle an event bus event (the sink entry point)

Native Functions (7)

Server

Start-DotBotServer, Stop-DotBotServer, Get-DotBotServerStatus

Stream Deck

Get-StreamDeckAppStatus, Install-StreamDeckDotBotPlugin, Import-StreamDeckDotBotProfile

Integration

Get-DotBotHueState

Documentation

• Architecture & Build Guide
• Aether Vision
• PowerShell Module Spec
• Profile Creation Guide

Testing

Invoke-Pester ./tests/Unit
Invoke-Pester ./tests/Integration  # requires Stream Deck

License

MIT — see LICENSE