PSAwtrixNG

0.2.0-preview0003

PowerShell module for managing and automating AWTRIX NG devices.

Minimum PowerShell version

5.1

This is a prerelease version of PSAwtrixNG.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name PSAwtrixNG -AllowPrerelease

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name PSAwtrixNG -Prerelease

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2026 Gael Colas. Licensed under the MIT License.

Package Details

Author(s)

  • Gael Colas

Tags

AWTRIX AWTRIXNG Ulanzi ESP32 MQTT IoT

Functions

Disable-AwtrixAppRotation Enable-AwtrixAppRotation Remove-AwtrixPushedApp Set-AwtrixPushedApp Get-AwtrixFile Get-AwtrixStorage Get-AwtrixIcon Remove-AwtrixIcon Save-AwtrixIcon Set-AwtrixIcon Get-AwtrixMqttBroker Publish-AwtrixMqttMessage Receive-AwtrixMqttMessage Start-AwtrixMqttBroker Stop-AwtrixMqttBroker Get-AwtrixScript Get-AwtrixScriptConfiguration Install-AwtrixStopwatch Remove-AwtrixScript Set-AwtrixScript Set-AwtrixScriptConfiguration Clear-AwtrixIndicator Disable-AwtrixDisplay Enable-AwtrixDisplay Get-AwtrixApp Get-AwtrixBrightness Get-AwtrixCapability Get-AwtrixDisplay Get-AwtrixScreen Get-AwtrixSettings Get-AwtrixStatus Invoke-AwtrixApi New-AwtrixDevice Remove-AwtrixNotification Select-AwtrixApp Send-AwtrixNotification Set-AwtrixBrightness Set-AwtrixIndicator Set-AwtrixSetting Show-AwtrixScreen Update-AwtrixFirmware Watch-AwtrixScreen

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

## [0.2.0-preview0003] - 2026-10-11

### Added

- AWTRIX NG `/api/v1` device, settings, display, screen, app, notification,
 indicator, and capability commands.
- NG-native pushed-app commands without AWTRIX 3 compatibility aliases.
- Dynamic terminal rendering for the dimensions reported by the device.
- Berry script upload, download, configuration, and removal commands.
- An on-device stopwatch with select-button start/pause, a three-press local
 reset sequence, hundredths-of-a-second display, and optional MQTT reset/state
 topics.
- MQTT stopwatch control commands for idempotent start and pause, plus toggle,
 reset, and restart.
- An end-to-end MQTT stopwatch walkthrough covering the PowerShell broker,
 AWTRIX NG system configuration, reboot, app selection, control commands, and
 captured state messages.
- GIF and JPEG icon upload, listing, ID resolution, download, and removal
 commands, including device storage preflight and upload verification.
- `Get-AwtrixStorage` for total, used, and free shared filesystem capacity.
- Commands to disable and enable automatic app-to-app rotation.
- `Set-AwtrixBrightness` with absolute 0–100 percentages and constrained
 relative increase or decrease adjustments.
- `Get-AwtrixBrightness` with normalized percentage, native firmware value,
 and automatic-brightness state.
- Typed `AwtrixApp`, `AwtrixNotification`, and `AwtrixScroll` payload classes
 with bare and module-qualified type accelerators and canonical JSON property
 casing.
- Bundled static and animated GIF assets copied into the packaged module for
 use in notifications and pushed-app cards, including white terminal and
 compact PowerShell icons.
- `Get-AwtrixFile` for Get-ChildItem-style listing of the ICONS, MELODIES,
 PALETTES, and MP3 asset directories.
- An in-process MQTTnet broker with PowerShell 5.1 and PowerShell 7 assets.
- `Update-AwtrixFirmware` for guarded multipart OTA installation with explicit
 opt-in, high-impact confirmation, and local image checks before the device
 performs its complete firmware validation.

### Changed

- Renamed the module and all associated types, assemblies, documentation, and
 build artifacts from `synedgy.PSAwtrixNG` to `PSAwtrixNG`.
- Changed the on-device stopwatch to cache paused display text and perform
 high-frequency elapsed-time formatting only while the timer is running.
- Moved the Stopwatch Berry implementation into a packaged
 `Berry/Stopwatch` application directory with explicit template tokens,
 allowing installation commands to load scripts and associated assets
 without embedded PowerShell here-strings.
- Added declarative length validation for icon file names and their
 firmware-facing IDs.
- Corrected the bundled Minecraft icon filenames and changed their canvases
 from 32×8 backgrounds to 8×8 side icons.
- Changed `terminal-white.gif` from a 32x8 background to an 8x8 side icon so
 pushed-app text uses the remaining display width.

FileList

  • PSAwtrixNG.nuspec
  • PSAwtrixNG.psd1
  • Assets\psconfeu.gif
  • Assets\lightbulb.gif
  • Assets\user.gif
  • Assets\terminal-white.gif
  • Assets\heartbeat-red-compact.gif
  • Assets\heartbeat-green-compact.gif
  • PSAwtrixNG.psm1
  • Assets\blinking-light-red.gif
  • Assets\github-copilot.gif
  • Assets\shield-green.gif
  • lib\MQTTnet.LICENSE
  • Assets\shield-red.gif
  • Assets\minecraft-creeper.gif
  • Assets\heartbeat-red.gif
  • en-US\about_PSAwtrixNG.help.txt
  • Assets\minecraft-alex.gif
  • Assets\german-flag.gif
  • Berry\Stopwatch\stopwatch.gif
  • en-US\PSAwtrixNG-help.xml
  • Assets\blinking-light-green.gif
  • Assets\github.gif
  • Berry\Stopwatch\Stopwatch.be
  • Assets\heartbeat-blue-compact.gif
  • Assets\hourglass.gif
  • Assets\minecraft-steve.gif
  • lib\net461\MQTTnet.dll
  • Assets\heartbeat-orange.gif
  • Assets\user-long-hair.gif
  • Assets\youtube.gif
  • lib\net461\PSAwtrixNG.Mqtt.dll
  • Assets\terminal.gif
  • Assets\powershell.gif
  • Assets\french-flag.gif
  • lib\net461\MQTTnet.xml
  • Assets\stopwatch.gif
  • Assets\blinking-light-blue.gif
  • Assets\swiss.gif
  • lib\netstandard2.0\MQTTnet.dll
  • Assets\heartbeat-orange-compact.gif
  • Assets\shield-blue.gif
  • Assets\heartbeat-blue.gif
  • lib\netstandard2.0\PSAwtrixNG.Mqtt.dll
  • Assets\blinking-light-orange.gif
  • Assets\robot.gif
  • Assets\union-jack.gif
  • lib\netstandard2.0\MQTTnet.xml
  • Assets\clock.gif
  • Assets\heartbeat-green.gif

Version History

Version Downloads Last updated
0.2.0-previe... (current version) 3 10/11/2026