gitwtfhub

wtf is deskmate?

jakubwawrzola/deskmate — explained in plain English

Analysis updated 2026-05-18

10JavaScriptAudience · ops devopsComplexity · 3/5Setup · moderate

TL;DR

A Windows tray app that turns your PC into a Home Assistant device with sensors, remote commands, and notifications.

Mindmap

mindmap
  root((Deskmate))
    What it does
      PC as Home Assistant device
      System sensors
      Remote commands
    Tech stack
      Tauri app
      MQTT
      Deskmate Link
    Use cases
      Monitor PC in HA
      Remote lock and shutdown
      Hotkeys control home
    Audience
      Home Assistant users
      Windows power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Show your Windows PC's CPU, memory, battery, and network status as sensors inside Home Assistant.

REASON 2

Lock, sleep, or shut down your PC remotely from a Home Assistant automation or dashboard.

REASON 3

Trigger Home Assistant automations or toggle lights using global keyboard shortcuts on your PC.

REASON 4

Send Home Assistant notifications to your PC as native Windows toast messages with action buttons.

What's in the stack?

JavaScriptTauriMQTTRust

How it stacks up

jakubwawrzola/deskmateagi-ruby/ai-gpt_image2-seedance_2.0-video-skillsarman-luthra/aftr
Stars101010
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasy
Complexity3/51/5
Audienceops devopsvibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs an MQTT broker or the Deskmate Link Home Assistant integration, plus a long-lived access token for HA-facing features.

No license information was included in the README excerpt.

Wtf does this do

Deskmate is a Windows desktop app that connects your PC to Home Assistant, the popular open source home automation platform. It calls itself a spiritual successor to an older project called HASS.Agent. Once installed, your computer shows up inside Home Assistant as a device with sensors, buttons, switches and notifications, and in the other direction your keyboard can act as a remote control for things around your home. The app runs quietly in the Windows system tray. It supports two ways of talking to Home Assistant: the classic MQTT protocol, which most home automation setups already use, or Deskmate's own encrypted connection called Deskmate Link, which does not need a separate message broker installed. It works natively on both x64 and ARM64 Windows 11 machines, including Snapdragon laptops, without needing emulation. Once connected, Deskmate reports system information such as CPU, memory, disk and network usage, battery status, and whether the screen is locked, and these appear automatically as entities in Home Assistant. There are optional privacy sensitive sensors, turned off by default, covering things like the active window title, WiFi network name, clipboard content, and whether the camera or microphone is in use. You can also trigger remote commands on your PC from Home Assistant, such as locking the screen, sleeping, shutting down, or controlling media playback, and you can expose your own PowerShell scripts as buttons or switches. A keep awake switch stops the PC from sleeping during long downloads or backups. Going the other direction, Deskmate lets your PC control your home too. It supports global keyboard shortcuts that can toggle lights, run Home Assistant automations, or fire custom commands, plus a small always on top widget panel showing the entities you choose. There is also a standalone Elgato Stream Deck plugin for triggering the same actions from physical buttons. Deskmate is aimed at people who already use Home Assistant and want their Windows PC folded into that ecosystem, especially anyone who needs ARM64 support or extra sensors that older alternatives do not offer. Setup requires an MQTT broker or the Deskmate Link integration, and secrets such as passwords and tokens are stored in Windows Credential Manager rather than in plain text.

Yoink these prompts

Prompt 1
Walk me through installing Deskmate and connecting it to my Home Assistant MQTT broker over TLS.
Prompt 2
Explain the difference between Deskmate's MQTT transport and the Deskmate Link WebSocket transport.
Prompt 3
Help me set up a custom PowerShell command as a Home Assistant button entity using Deskmate.
Prompt 4
Show me how to configure a global hotkey in Deskmate that publishes an MQTT device trigger.
Prompt 5
What privacy sensitive sensors does Deskmate offer and how do I keep them turned off by default?

Frequently asked questions

wtf is deskmate?

A Windows tray app that turns your PC into a Home Assistant device with sensors, remote commands, and notifications.

What language is deskmate written in?

Mainly JavaScript. The stack also includes JavaScript, Tauri, MQTT.

What license does deskmate use?

No license information was included in the README excerpt.

How hard is deskmate to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is deskmate for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.