explaingit

umutcansintorgayli/thermalwatch

Analysis updated 2026-05-18

4PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A lightweight Windows system-tray app that monitors CPU and GPU temperatures, sends desktop and phone alerts when thresholds are crossed, and offers AI-powered hardware health diagnostics.

Mindmap

mindmap
  root((ThermalWatch))
    Monitoring
      CPU temperature
      GPU temperature
      Fan speeds RPM
      Load percentage
    Alerts
      Windows toast popup
      Phone via ntfy.sh
      Tray icon color
    UI
      System tray icon
      Floating widget
      Dark light mode
    Diagnostics
      10min health history
      AI advisor Gemini
      AMD Ryzen fix
    Setup
      Windows 10 11
      Admin required
      Prebuilt exe option
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

Get instant desktop and phone alerts when your gaming PC's GPU temperature spikes above a safe limit.

USE CASE 2

Monitor CPU fan speeds and temperatures in the background while video editing without any dashboard overhead.

USE CASE 3

Diagnose overheating patterns on an AMD Ryzen system by reviewing the 10-minute thermal history in the health advisor.

What is it built with?

PythonCustomTkinterpystraypythonnetLibreHardwareMonitorLibntfy.sh

How does it compare?

umutcansintorgayli/thermalwatchadeliox/klein-head-swapats4321/ragit
Stars444
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/52/5
Audiencegeneraldesignerdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Windows admin access, AMD Ryzen users must also install the PawnIO kernel driver for CPU sensor readings.

MIT license: use, copy, modify, and distribute freely including for commercial purposes.

In plain English

ThermalWatch is a Windows desktop application that keeps an eye on your computer's internal temperatures and notifies you the moment things get too hot. It runs quietly in the system tray, near the clock in the corner of your screen, so it never clutters your desktop or taskbar. In the background it reads sensor data from your CPU and GPU: current temperature, how hard each chip is working as a percentage, and fan speeds in RPM for both the CPU cooler and any liquid cooling pump you have installed. When a temperature crosses a threshold you define, the app sends you two notifications at once. One is a native Windows toast pop-up on your screen. The other is a push notification to your phone via a free open service called ntfy.sh, so you find out even if you stepped away from your desk. A built-in one-second delay prevents duplicate alerts from flooding you when the CPU and GPU both spike at the same instant. Beyond the tray icon, there is a small floating desktop widget that shows live readings in a dark or light style, and you can drag it anywhere on screen. The tray icon itself changes color: green when everything is fine, yellow when temperatures are approaching your limit, and red when a threshold is breached. A settings panel lets you configure alert limits and view a live telemetry feed including fan speeds. The app also includes a local health advisor that looks at a rolling ten-minute history of your sensor readings and tries to flag patterns that suggest a hardware problem, such as the CPU running hot even under light load, which can point to dried thermal paste or a loose cooler mount. Optionally, you can connect the Gemini or Ollama AI services to generate more detailed diagnostic reports. Installation requires Windows 10 or 11 and administrator access. A prebuilt executable is available if you do not want to deal with Python. AMD Ryzen users who see a zero-degree CPU reading need to install a separate driver called PawnIO, the app includes a button in settings that opens the download page directly. The project is open source under the MIT license.

Copy-paste prompts

Prompt 1
I installed ThermalWatch but my AMD Ryzen CPU shows 0°C. Walk me through installing the PawnIO driver and restarting the app.
Prompt 2
Help me configure ThermalWatch to alert my phone via ntfy.sh when my GPU exceeds 85°C, including setting up the ntfy topic.
Prompt 3
I want to add a new sensor type to ThermalWatch's monitoring. Show me where in the Python code the LibreHardwareMonitorLib sensors are read and how to extend it.
Prompt 4
Explain how ThermalWatch's 10-minute rolling health advisor works and what patterns it uses to detect thermal paste failure.
Prompt 5
Show me how to set up ThermalWatch to auto-start on Windows boot using the Task Scheduler integration built into the app.

Frequently asked questions

What is thermalwatch?

A lightweight Windows system-tray app that monitors CPU and GPU temperatures, sends desktop and phone alerts when thresholds are crossed, and offers AI-powered hardware health diagnostics.

What language is thermalwatch written in?

Mainly Python. The stack also includes Python, CustomTkinter, pystray.

What license does thermalwatch use?

MIT license: use, copy, modify, and distribute freely including for commercial purposes.

How hard is thermalwatch to set up?

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

Who is thermalwatch for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub umutcansintorgayli on gitmyhub

Verify against the repo before relying on details.