HA DeskLink macOS v4.3

Home Assistant Companion App für macOS

🔍 Suchst du einen Home Assistant Desktop-Companion für macOS? HA DeskLink verbindet deinen Mac direkt mit Home Assistant – Sensordaten, Systemstatus und Steuerelemente live auf dem Desktop.

📖 Betriebsanleitung / Manual – Installation, Sensoren, Befehle, Quick Actions, Actionable Notifications, Screenshot, Webcam, Plattform-Vergleich & mehr (DE + EN)

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

⚠️ COMMUNITY TEST VERSION – NICHT VOM ENTWICKLER GETESTET! ⚠️

Diese Version wurde ohne Mac-Hardware erstellt und ist auf Community-Testing angewiesen. Bitte melde Bugs unter Issues.

---

⚠️ WICHTIGER HINWEIS

Diese macOS-Version wurde NICHT vom Entwickler (Fabian Kirchweger) getestet! Es gibt keine Mac-Hardware zum Testen. Die App wurde basierend auf der funktionierenden Windows-Version erstellt. Wenn du macOS nutzt, teste bitte diese Version und melde Bugs – die Community ist der Tester!

---

MQTT (v4.3)

HA DeskLink v4.3 bringt optionale MQTT-Unterstützung für erweiterte Features:

• 🔊 Media Player Entity – Dein Mac 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 Mac – MQTT-Befehle erreichen den Mac 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.

v4.2 New Features

• 🖥️ Dashboard – Öffnet HA-Dashboard im Standard-Browser (einmaliges Login, Session bleibt erhalten)
• 🎨 Modernes Dark Mode – Komplett neu gestaltete Benutzeroberfläche
• 📊 Neue Sensoren – GPU-Auslastung, CPU-Takt, Audio-Lautstärke, Mikrofon-Status, Idle-Zeit, Internet-Connectivity
• ⚡ Neue Befehle – Mediensteuerung (Play/Pause, Next, Previous), volume_up/down/mute
• 🌍 22 neue Lokalisierungs-Keys in allen 6 Sprachen
• 🔄 Sensor-Standardisierung – cpu_temp → cpu_temperature, cpu_usage → cpu_percent, memory → memory_percent

v3.0 Features

• 🔔 Actionable Notifications – Benachrichtigungen mit Aktions-Buttons via osascript
• ⚡ Quick Actions – Dashboard-Button mit HA-Entity-Toggle-Popup
• 📸 Screenshot Save+Upload – screenshot_save speichert via screencapture und lädt als HA-Event hoch
• 📷 Webcam-Sensor – Neuer Sensor webcam_active (on/off)

Sensoren

Sensor	ID	Einheit	Verfügbar	Hinweis
CPU-Temperatur	cpu_temperature	°C	⚠️	Siehe unten
CPU-Auslastung	cpu_percent	%	✅
CPU-Takt	cpu_clock	MHz	✅	Neu in v4.2
GPU-Auslastung	gpu_load	%	✅	Neu in v4.2
RAM Auslastung	memory_percent	%	✅
RAM Verfügbar	memory_available	GB	✅
Audio-Lautstärke	audio_volume	%	✅	Neu in v4.2
Audio Stumm	audio_mute	–	✅	Binary Sensor, Neu in v4.2
Mikrofon aktiv	mic_active	–	✅	Binary Sensor, Neu in v4.2
Idle-Zeit	idle_time	s	✅	Neu in v4.2
Internet	connectivity	–	✅	Binary Sensor, Neu in v4.2
Akku	battery	%	✅
Akku lädt	battery_charging	–	✅
Akku-Ladezyklen	battery_cycle_count	–	✅	🍎 macOS-exklusiv
Netzteil	power_adapter	–	✅	🍎 macOS-exklusiv
Festplatte	disk_usage	%	✅
Betriebszeit	uptime	min	✅
GPU-Modell	gpu_model	–	✅	🍎 macOS-exklusiv
Bildschirmauflösung	display_resolution	–	✅	🍎 macOS-exklusiv
Prozesse	process_count	–	✅
IP-Adresse	ip_address	–	✅
WiFi-Name	wifi_ssid	–	✅
Tastaturbeleuchtung	keyboard_backlight	%	⚠️	🍎 macOS-exklusiv, nicht auf allen Macs
Vollbild	fullscreen	–	✅
Monitor-Layout	monitor_layout	–	✅
Helligkeit	brightness	%	✅
Webcam aktiv	webcam_active	–	✅	on/off
App-Version	ha_desklink_version	–	✅	Aktuelle Version

CPU-Temperatur – Erklärung

Die CPU-Temperatur wird in folgender Reihenfolge versucht:

1. ioreg SMC (keine Installation nötig) – liest direkt aus dem Apple System Management Controller. Funktioniert ohne sudo auf den meisten Macs.
2. powermetrics – macOS-Bordmittel, benötigt aber sudo auf vielen Systemen.
3. osx-cpu-temp – externes Tool, muss installiert werden: brew install osx-cpu-temp

Wenn keine Methode funktioniert, bleibt der Sensor leer.

Nicht verfügbare Sensoren (im Vergleich zu Windows/Linux)

Sensor	Windows	Linux	macOS	Warum nicht auf macOS?
GPU-Temperatur	✅ LibreHardwareMonitor	✅	❌	Keine öffentliche API, LibreHardwareMonitor gibt es nicht für macOS
GPU-VRAM	✅	✅	❌	Keine öffentliche API für VRAM-Auslastung
Lüfter-Drehzahl	✅ LibreHardwareMonitor	✅	❌	Nur via sudo powermetrics auslesbar
Lüfter-Steuerung	✅	❌	❌	System-geregelt, kein User-Zugang
Netzwerk-Upload/Download	✅	✅	❌	netstat -ib liefert Byte-Counts aber keine Live-Rate ohne Polling-Logik
WLAN-Signal	✅	✅	❌	Keine User-Level API für Signalstärke auf macOS
Seitenfile	✅	❌	❌	macOS hat kein Äquivalent zum Windows Page File

Befehle

shutdown, restart, sleep, lock_screen, hibernate, volume_mute, volume_up, volume_down, media_play_pause, media_next, media_previous, monitor_off, monitor_on, screenshot, screenshot_save, brightness_up, brightness_down, brightness:50

Installation

# ZIP herunterladen und entpacken
# oder: Aus dem Quellcode bauen
dotnet build src/HaDeskLink -c Release -r osx-arm64

📐 Versionierung

Ab v2.2.1 gelten plattformunabhängige Versionsnummern:

Änderung	Beispiel	Erklärung
Bug Fix	2.2.1 → 2.2.2	Fehlerbehebung, nur betroffene Plattform
Neue Funktionen	2.2.x → 3.0.0	Neue Features, alle Plattformen gleichzeitig

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

Lizenz

GPL v3 – siehe LICENSE

KI-Unterstützung

Idee: Fabian Kirchweger | Entwicklung: J.A.R.V.I.S. (Hermes Agent) – siehe CREDITS.md

Verwendete KI-Modelle:

Modell	Rolle
GLM-5.1	Hauptmodell
DeepSeek V4 Pro	Sub-Agenten

English Version