Skip to content

Windows Manager

WikiZell edited this page Aug 11, 2026 · 1 revision

HA Proxy Panel Manager for Windows

Download HA Proxy Panel Manager for Windows 1.6.0

The Manager is a standalone Windows app. Python is not required and ESPHome 2026.7.4 is bundled.

What it can do

  • Sign in through Home Assistant OAuth, including MFA, or use a manual long-lived token.
  • Encrypt saved Home Assistant tokens and panel secrets for the current Windows user with DPAPI.
  • Import saved Windows Wi-Fi profiles without displaying stored passwords.
  • Detect USB serial adapters, flash a new panel, and verify the exact firmware commit downloaded from GitHub.
  • Discover all HA Proxy Panels through Home Assistant, mDNS, LAN search, or a direct IP address.
  • Show each panel's IP, node name, connection source, firmware, ESPHome version, API mode, update state, display settings, sensor sources, entities, and diagnostics.
  • Change display mode, rotation, brightness, and OLED Care live.
  • Run the OLED Care animation, restart a panel, change climate sources, and install verified OTA updates.
  • Add a panel securely to Home Assistant and create its protected ESPHome Device Builder project.
  • Preserve device and entity identity, sensor sources, display settings, API security mode, Wi-Fi settings, and OTA configuration during updates.
  • Keep useful logs while redacting passwords, tokens, and keys.

First connection

  1. Open Home Assistant in the Manager.
  2. Enter your Home Assistant URL and choose browser login.
  3. Complete login in Home Assistant's own page. Your username, password, and MFA code are not handled by the Manager.
  4. Return to the app and confirm the Home Assistant status is connected.

Use a long-lived access token only if browser login is unavailable.

Devices page

Choose a discovered panel to see a stable dashboard. Use the live controls for routine changes. Sensor source changes and firmware installation open a reviewed update workflow because those changes require a build and OTA installation.

If mDNS is blocked, use Add by IP with the address shown on the panel or in your router.

Windows SmartScreen

The community executable is not code-signed, so Windows may show SmartScreen. Download only from this repository and compare the file's SHA256 with the checksum on the v1.6.0 release.

See First-Time Setup or Updating an Existing Panel for the complete workflows.

Clone this wiki locally