Home Assistant Windows Companion

GitHub Release Build Status License: MIT Home Assistant

A native, high-performance Windows companion application for Home Assistant, built with .NET 10 and WinUI 3. This app brings your Windows PC into your smart home ecosystem as a first-class citizen, matching the feature set and professional standards of the official mobile apps.

This project is built from the ground up using Clean Architecture principles, ensuring long-term maintainability and modularity.

• Core: Domain models and abstractions, independent of platform APIs.
• Infrastructure: Platform-specific implementations (Windows APIs, Home Assistant REST/WS clients).
• App: Modern WinUI 3 interface following Fluent Design guidelines.
• Standards: 2026-compliant .NET 10 code, asynchronous patterns, and robust dependency injection.

Provides granular data back to Home Assistant via the mobile_app integration:

• CPU & Memory: Instantaneous usage tracking.
• Power Management: Battery level, charging status, and AC power detection.
• Productivity: Foreground application/window title tracking (opt-in).
• System Health: Idle time (user presence) and network latency to HA.
• Audio Environment: Active output device identification.

Control your Windows environment directly from Home Assistant dashboards and automations:

• Media & Audio: Master volume control, mute toggling, and media play/pause/skip.
• Security: Instant workstation lock.
• Power Operations: Shutdown, Restart, and Sleep commands.

• Interactive Setup: A guided onboarding wizard that detects your HA instance via mDNS.
• System Tray: Lightweight background execution with a low memory footprint.
• Autostart: Built-in toggle to launch on Windows login.

1. Download: Grab the latest HAWindowsCompanion.zip from Releases.
2. Extract: Unzip to a local folder (e.g., %LOCALAPPDATA%\Programs).
3. Launch: Open HAWindowsCompanion.exe.
4. Connect: Follow the "Setup Wizard" to authorize the app via OAuth2.
5. Done: Your PC will now appear as a new device in Home Assistant!

Detailed documentation is available in the /docs folder or via our Online Documentation Site.

• Installation Guide
• Feature Details
• Troubleshooting
• Development Guide

Contributions are welcome! Please see our Development Guide for instructions on setting up the environment.

This project is licensed under the MIT License. See the LICENSE file for the full text. Copyright © 2026 FaserF.