HA DeskLink v5.0

What is HA DeskLink? A free, open-source desktop application (GPL-3.0) that connects a computer to a Home Assistant instance in both directions: smart-home sensor values (temperatures, energy, locks, motion) shown live in the taskbar/tray, and the computer's own status (CPU, RAM, disk, uptime) pushed into Home Assistant as sensor entities. Entity controls and toast notifications included, optional embedded WebView dashboard. Fully local, no browser, no cloud.

🌐 Project homepage & downloads

Windows Companion App für Home Assistant – nativ, schnell, zuverlässig.

🔍 Suchst du einen Home Assistant Desktop-Companion? HA DeskLink verbindet deinen PC direkt mit Home Assistant – Sensordaten, Systemstatus und Steuerelemente live auf dem Desktop. Kein Browser, kein Umweg.

🌍 Looking for a Home Assistant desktop companion for Windows? HA DeskLink connects your PC directly to Home Assistant – sensor data, system status and controls live on your desktop. No browser, no detour.

⬇️ Download HA DeskLink for Windows (.exe) — Installer für Windows 10/11

Alle Versionen: Releases

📖 Betriebsanleitung / Manual – Umfassende Anleitung: Installation, alle Sensoren, Befehle, Quick Actions, MQTT, Auto-Update, Einstellungen, Sicherheit & Fehlerbehebung (Deutsch)

📖 User Guide – Complete manual: Installation, all sensors, commands, Quick Actions, MQTT, Auto-Update, settings, security & troubleshooting (English)

📊 HASS.Agent vs. HA DeskLink – Features, Architektur & Migration im Vergleich (DE + EN)

📝 Changelog – Alle Versionen und Änderungen

👏 Credits – Mitwirkende und verwendete KI-Modelle

Geschrieben in C# / .NET 8 – treiberlose Sensor-Erfassung via WMI + PerformanceCounter (kein Kernel-Treiber nötig!).

• 🌡️ CPU & GPU Temperatur – treiberlos via WMI + PerformanceCounter (kein WinRing0, keine Defender-Warnung!)
• 📊 Alle Sensoren – CPU, GPU, RAM, alle Laufwerke (C:, D:, etc.), Battery, Uptime, VRAM, Audio, Mikrofon, Webcam, Idle-Zeit
• 🖥️ Eingebettetes Dashboard – WebView2 zeigt HA direkt in der App (einmaliges Login, Session bleibt erhalten)
• ⚡ PC-Befehle aus HA – Shutdown, Restart, Hibernate, Sleep, Lock, Lautstärke, Mediensteuerung und mehr per Benachrichtigung
• 📬 Benachrichtigungen – HA sendet Toast-Notifications an den PC
• 🔔 Actionable Notifications – Benachrichtigungen mit Aktions-Buttons
• ⚡ Quick Actions – Konfigurierbare Hotkeys für Entity-Toggles (Quick Actions: Ctrl+Shift+H, Dashboard: Ctrl+Shift+D, Einstellungen: Ctrl+Shift+S)
• 📸 Screenshot – Echtes Bildschirmfoto + Upload als HA-Event
• 📷 Webcam-Sensor – Zeigt ob Webcam aktiv ist (nur Linux/macOS, auf Windows entfernt)
• ⚙️ Einstellungen – Komplett neu gestaltet: GroupBoxes, Entity-Dropdown, JSON-Editor
• 🎨 Dark Mode – Automatisch (System), Hell oder Dunkel wählbar
• 🌐 6 Sprachen – Deutsch, Englisch, Spanisch, Französisch, Chinesisch, Japanisch (22 neue Keys in v4.2, 24 Erklärungs-Keys in v5.0)
• 🔌 mobile_app Protokoll – identisch zur Handy-App, keine Extra-Konfiguration in HA nötig
• 🔄 Auto-Update von GitHub Releases
• 📌 System Tray – läuft minimiert im Hintergrund
• 🛡️ Admin-Rechte – App startet automatisch als Administrator (für CPU/GPU-Temperatur), Autostart via Task Scheduler mit höchsten Privilegien

HA DeskLink v5.0 bringt optionale MQTT-Unterstützung für erweiterte Features:

• 🔊 Media Player Entity – Dein PC erscheint als Media Player in Home Assistant mit now-playing Info, Play/Pause und Lautstärke-Regelung
• 📡 PC Status Binary Sensor – Sofortige Online/Offline-Erkennung via Last Will Testament (LWT)
• ⚡ Befehle an schlafenden PC – MQTT-Befehle erreichen den PC auch im Energiesparmodus
• 🔍 Automatische Geräteerkennung – Media Player und PC Status erscheinen automatisch in HA
• 🔒 Zuverlässigere Verbindung – Auto-Reconnect mit exponentiellem Backoff
• 🪄 Zero-Config Setup – Beim ersten Start wird automatisch nach Mosquitto gesucht und die Verbindung eingerichtet
• 🧭 Smart Routing – MQTT für Sensoren + Befehle, WebSocket bleibt für Benachrichtigungen

MQTT ist optional – HA DeskLink funktioniert auch ohne MQTT wie gewohnt weiter.

• Windows 10/11 (x64)
• Kein .NET Runtime nötig – alles im Installer enthalten
• Keine Defender-Warnung mehr! – Ab v4.0: komplett treiberlos, kein WinRing0

1. Neueste HA_DeskLink_Setup_x.x.x.exe von Releases herunterladen
2. Die HA_DeskLink_Setup_x.x.x.exe herunterladen, dann im Download-Ordner Rechtsklick → „Als Administrator ausführen“ wählen. ⚠️ Ein normaler Doppelklick oder das Warten auf die UAC-Anfrage führt zu einer Fehlermeldung – bitte direkt per Rechtsklick als Administrator starten.
3. HA URL + Long-Lived Token eingeben
4. Fertig! 🎉

HA DeskLink empfängt Befehle über Benachrichtigungen – genau wie die Handy-App. Keine Extra-Konfiguration in HA nötig!

⚠️ volume_mute, volume_up, volume_down, monitor_on, monitor_off und screenshot sind ab v2.1.0 verfügbar!

⚠️ Helligkeits-Befehle (brightness_up, brightness_down, brightness:XX) funktionieren in der Regel nur auf Laptops mit integriertem Display. An Desktop-PCs mit externen Monitoren werden die Befehle ignoriert – die meisten externen Monitore unterstützen keine Software-Helligkeitssteuerung.

service: notify.mobile_app_ha_desklink
data:
  title: "PC herunterfahren?"
  message: "Der PC wird in 30 Sekunden heruntergefahren"
  data:
    actions:
      - action: SHUTDOWN
        title: "Ausschalten"
        command: shutdown
      - action: CANCEL
        title: "Abbrechen"
    command_on_action: shutdown

service: notify.mobile_app_ha_desklink
data:
  title: "PC herunterfahren"
  message: "Der PC wird in 30 Sekunden heruntergefahren"
  data:
    command: "shutdown"

service: notify.mobile_app_ha_desklink
data:
  title: "PC neustarten"
  message: "Der PC wird neu gestartet"
  data:
    command: "restart"

service: notify.mobile_app_ha_desklink
data:
  title: "Ruhezustand"
  message: "PC geht in den Ruhezustand"
  data:
    command: "hibernate"

service: notify.mobile_app_ha_desklink
data:
  title: "PC sperren"
  message: "Der PC wird gesperrt"
  data:
    command: "lock_screen"

service: notify.mobile_app_ha_desklink
data:
  title: "Erinnerung"
  message: "Müll rausbringen nicht vergessen!"

automation:
  - alias: "PC um 22 Uhr herunterfahren"
    trigger:
      - platform: time
        at: "22:00:00"
    condition:
      - condition: state
        entity_id: binary_sensor.ha_desklink_connectivity
        state: "on"
    action:
      - service: notify.mobile_app_ha_desklink
        data:
          title: "Gute Nacht!"
          message: "Der PC wird jetzt heruntergefahren."
          data:
            command: "shutdown"

type: button
name: "PC herunterfahren"
tap_action:
  action: call-service
  service: notify.mobile_app_ha_desklink
  service_data:
    title: "PC herunterfahren"
    message: "Wird heruntergefahren..."
    data:
      command: "shutdown"

HA DeskLink erstellt automatisch Sensoren in HA:

💡 Weitere Laufwerke (D:, E: etc.) werden automatisch erkannt. GPU-Sensoren erscheinen nur wenn eine GPU vorhanden ist. webcam_active und mic_active sind binary_sensor Typen.

Das integrierte Dashboard öffnet HA direkt in der App (WebView2). Der erste Besuch zeigt das normale HA-Login-Formular — einmalig mit Benutzername & Passwort anmelden, danach bleibt die Session erhalten (wie im Browser). Falls WebView2 nicht installiert ist, wird automatisch angeboten es herunterzuladen. Alternativ öffnet sich HA im Standard-Browser.

dotnet publish src/HaDeskLink -c Release -r win-x64 --self-contained -o publish
iscc installer.iss

Die Python-Version ist abgeschlossen und archiviert: ha-desklink

Ab v2.2.1 gelten plattformunabhängige Versionsnummern:

Jede Plattform (Windows, Linux, macOS) hat eigene Versionsnummern. Ein Bug-Fix unter Linux ändert nicht die Windows-Version – und umgekehrt. Große Funktionsupdates (Major) bekommen alle Plattformen gleichzeitig.

GPL v3 – Copyright © 2026 Fabian Kirchweger

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License v3.

Important: If you modify or distribute this software, you MUST release your changes under the same GPL v3 license. Closed-source or proprietary use is NOT permitted.

Es gibt jetzt eine macOS-Version von HA DeskLink! 🎉 Siehe ha-desklink-mac – ⚠️ Community Test Version, nicht vom Entwickler getestet.

💬 Discord – Fragen, Feedback, Hilfe

• Idee: Fabian Kirchweger
• Entwicklung: J.A.R.V.I.S. (Hermes Agent)

Dieses Projekt wurde unter Verwendung von KI-Unterstützung erstellt. Der gesamte Code wurde von GLM-5.2 (J.A.R.V.I.S. – Hermes Agent) geschrieben und entwickelt – von der Architektur über die Implementierung bis zum Debugging. Für Tests und Audits wurden Sub-Agenten auf Basis von DeepSeek V4 Pro eingesetzt. Die englische Dokumentation wurde ebenfalls von der KI aus dem Deutschen ins Englische übersetzt. Die deutsche Dokumentation ist die Originalversion.