Skip to content

andresharpe/dotbot-aether-ambient

Repository files navigation

DotBot.Aether.Ambient

Aether Ambient conduit — Philips Hue bridge integration for dotbot. Part of the dotbot-aether conduit plugin collection.

PowerShell 7.0+ License: MIT

What It Does

Translates dotbot event bus events into Philips Hue light effects — pulses, breathes, chases, waves, color cycles, strobes, and more. Supports bridge discovery (N-UPnP, SSDP, ARP, subnet scan), CLIP v1+v2 REST, and DTLS entertainment streaming.

Quick Start

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

# Discover and connect
Find-AetherAmbient | Connect-AetherAmbient

# Or use the native Hue functions directly
Find-HueBridge | New-HueSession
Get-HueLight | Format-Table
Set-HueLightState -LightId 1 -On $true -Brightness 254

Aether Contract Functions

Every Aether conduit exports these standard lifecycle functions:

  • Initialize-AetherAmbient — validate config and hardware reachability
  • Find-AetherAmbient — discover Hue bridges on the network
  • Connect-AetherAmbient — bond to a discovered bridge
  • Disconnect-AetherAmbient — clean shutdown
  • Test-AetherAmbient — health check
  • Invoke-AetherAmbientEvent — handle an event bus event (the sink entry point)

Native Functions (39)

Connection & Discovery

Find-HueBridge, New-HueSession, New-HueAppKey, Import-HueSession, Export-HueSession, Set-HueSessionOption, Test-HueBridgeConnection, Get-HueBridgeConfig

Light Control

Get-HueLight, Set-HueLightState, Set-HueAllLights, Set-HueTwoTone, Set-HueV2Light, Get-HueV2Resource

Groups & Scenes

Get-HueGroup, Set-HueGroupState, Get-HueScene, Invoke-HueScene, Invoke-HueV2Scene, Get-HueSensor

Effects & Patterns

Start-HueChase, Start-HueWave, Start-HueColorCycle, Start-HueStrobe, Start-HueRainbowChase, Start-HueColorBurst, Get-HueLightPattern, ConvertFrom-HueColorName, ConvertTo-HueRgb16

Entertainment Streaming

Start-HueEntertainment, Stop-HueEntertainment, Connect-HueStream, Disconnect-HueStream, Send-HueStreamFrame, Start-HueStreamLoop, Get-HueEntertainmentConfiguration

State Management

Save-HueState, Restore-HueState, Limit-HueRate

Documentation

Testing

Invoke-Pester ./tests/Unit
Invoke-Pester ./tests/Integration  # requires Hue bridge

License

MIT — see LICENSE

About

Aether Ambient conduit — Philips Hue bridge integration for dotbot

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors