thermalcanary 1.1.0__tar.gz

thermalcanary-1.1.0/.claude/settings.local.json

@@ -0,0 +1,5 @@
+{
+  "permissions": {
+    "allow": []
+  }
+}

thermalcanary-1.1.0/.githooks/pre-commit

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# ──────────────────────────────────────────────────────────────────────────────
+# Pre-commit hook — fast checks on staged files only.
+# Install: git config core.hooksPath .githooks
+# ──────────────────────────────────────────────────────────────────────────────
+
+set -e
+
+ROOT="$(git rev-parse --show-toplevel)"
+
+STAGED_PY=$(git diff --cached --name-only --diff-filter=AM | grep '\.py$' | tr '\n' ' ' || true)
+STAGED_ALL=$(git diff --cached --name-only --diff-filter=AM | tr '\n' ' ' || true)
+
+ERRORS=0
+
+# ── Python: syntax check on staged files ─────────────────────────────────────
+if [ -n "$STAGED_PY" ]; then
+    echo "── Python syntax check (staged files) ──"
+    for f in $STAGED_PY; do
+        if ! uv run --project "$ROOT" python -m py_compile "$f" 2>&1; then
+            echo "  Syntax error in: $f"
+            ERRORS=1
+        fi
+    done
+    [ $ERRORS -eq 0 ] && echo "  OK"
+fi
+
+# ── Bandit: security lint on staged Python files ──────────────────────────────
+# Test files are excluded: pytest legitimately requires `assert` (B101), and the
+# whole point of test fixtures is to use hardcoded paths (B108). Lint app code.
+if [ -n "$STAGED_PY" ]; then
+    echo "── Bandit security lint (staged files) ──"
+    BANDIT_TARGETS=""
+    for f in $STAGED_PY; do
+        case "$f" in
+            tests/*|*/tests/*) ;;
+            *) BANDIT_TARGETS="$BANDIT_TARGETS $f" ;;
+        esac
+    done
+    if [ -n "$BANDIT_TARGETS" ]; then
+        BANDIT_EXIT=0
+        uv run --project "$ROOT" bandit -q $BANDIT_TARGETS || BANDIT_EXIT=$?
+        if [ $BANDIT_EXIT -ne 0 ]; then
+            ERRORS=1
+        fi
+    else
+        echo "  (only test files staged — skipped)"
+    fi
+fi
+
+# ── Secrets scan: block commits containing secrets/keys ──────────────────────
+if [ -n "$STAGED_ALL" ]; then
+    echo "── Secrets scan (staged files) ──"
+    SECRET_PATTERNS='(PRIVATE KEY-----)'
+    SECRET_PATTERNS="$SECRET_PATTERNS|(sk_live_[a-zA-Z0-9]{20,})"
+    SECRET_PATTERNS="$SECRET_PATTERNS|(ls_live_[a-zA-Z0-9]{20,})"
+    SECRET_PATTERNS="$SECRET_PATTERNS|(password\s*[:=]\s*['\"][^'\"]{8,}['\"])"
+    SECRET_PATTERNS="$SECRET_PATTERNS|(_HMAC_SECRET\s*=\s*['\"][^'\"]{8,}['\"])"
+
+    if git diff --cached --diff-filter=AM -U0 -- ':!.githooks/pre-commit' | grep -iEq "$SECRET_PATTERNS"; then
+        echo "  Potential secret detected in staged changes!"
+        echo "  Review the diff and remove secrets before committing."
+        ERRORS=1
+    fi
+fi
+
+# ── Result ────────────────────────────────────────────────────────────────────
+if [ $ERRORS -ne 0 ]; then
+    echo ""
+    echo "Pre-commit checks failed. Fix the errors above, then try again."
+    echo "To bypass (emergency only): git commit --no-verify"
+    exit 1
+fi
+
+echo "Pre-commit checks passed."

thermalcanary-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,112 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Qt system dependencies
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y --no-install-recommends \
+            libxcb-cursor0 libxcb-xinerama0 libegl1 libgl1 \
+            libglib2.0-0 libdbus-1-3
+
+      - uses: astral-sh/setup-uv@v6
+
+      - name: Install Python dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests with coverage
+        run: uv run pytest tests/ --cov=thermalcanary --cov-report=term-missing --cov-report=json
+        env:
+          QT_QPA_PLATFORM: offscreen
+
+      - name: Run mutation tests (changed files only)
+        id: mutation
+        run: |
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            BASE="${{ github.event.pull_request.base.sha }}"
+          else
+            BASE="$(git rev-parse HEAD~1 2>/dev/null || echo '')"
+          fi
+          if [ -n "$BASE" ]; then
+            PATHS=$(git diff --name-only "$BASE" HEAD -- 'thermalcanary/*.py' | tr '\n' ' ')
+          else
+            PATHS=""
+          fi
+          if [ -z "$PATHS" ]; then
+            echo "No thermalcanary/ files changed — skipping mutation tests."
+            echo "score=-1" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          echo "Mutating: $PATHS"
+          # mutmut 3.x accepts module-name patterns as positional args, NOT
+          # --paths-to-mutate (which was a 2.x flag). Convert path → module.
+          MODS=""
+          for f in $PATHS; do
+            MODS="$MODS $(echo "$f" | sed 's|/|.|g; s|\.py$||').*"
+          done
+          # Fresh cache each CI run so `mutmut results` only lists what we ran.
+          rm -rf mutants/.mutmut-cache mutants/_*.json .mutmut-cache 2>/dev/null || true
+          uv run mutmut run $MODS || true
+          # mutmut 3.x results: one line per non-killed mutant ending in
+          # ": survived" / ": segfault" / ": timeout" / ": not checked".
+          # Killed mutants are hidden — derive from totals.
+          RESULTS=$(uv run mutmut results 2>&1)
+          TOTAL_LINES=$(echo "$RESULTS" | grep -cE "^\s+thermalcanary\." || true)
+          SURVIVED=$(echo "$RESULTS" | grep -cE ": survived$" || true)
+          SEGFAULT=$(echo "$RESULTS" | grep -cE ": segfault$" || true)
+          TIMEOUT=$(echo "$RESULTS" | grep -cE ": timeout$" || true)
+          NOTCHECK=$(echo "$RESULTS" | grep -cE ": not checked$" || true)
+          KILLED=$((TOTAL_LINES - SURVIVED - SEGFAULT - TIMEOUT - NOTCHECK))
+          [ "$KILLED" -lt 0 ] && KILLED=0
+          TOTAL=$((KILLED + SURVIVED))
+          SCORE=$(python3 -c "print(f'{$KILLED/$TOTAL*100:.0f}' if $TOTAL else '0')")
+          echo "Mutation score: ${SCORE}% (${KILLED}/${TOTAL} killed)"
+          echo "score=$SCORE" >> "$GITHUB_OUTPUT"
+          echo "killed=$KILLED" >> "$GITHUB_OUTPUT"
+          echo "total=$TOTAL" >> "$GITHUB_OUTPUT"
+          python3 -c "import sys; sys.exit(0 if $TOTAL == 0 or $KILLED/$TOTAL >= 0.50 else 1)" \
+            || { echo "FAIL: mutation kill rate below 50%"; exit 1; }
+        env:
+          QT_QPA_PLATFORM: offscreen
+
+      - name: Update badges
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main' && steps.mutation.outputs.score != '-1'
+        run: |
+          # coverage badge
+          COV=$(python3 -c "import json; d=json.load(open('coverage.json')); print(int(d['totals']['percent_covered_display']))")
+          if   [ "$COV" -ge 90 ]; then COV_COLOR=brightgreen
+          elif [ "$COV" -ge 80 ]; then COV_COLOR=green
+          elif [ "$COV" -ge 70 ]; then COV_COLOR=yellowgreen
+          elif [ "$COV" -ge 60 ]; then COV_COLOR=yellow
+          else                         COV_COLOR=orange
+          fi
+          printf '{"schemaVersion":1,"label":"coverage","message":"%s%%","color":"%s"}\n' "$COV" "$COV_COLOR" \
+            > coverage-badge.json
+          # mutation badge
+          S=${{ steps.mutation.outputs.score }}
+          if   [ "$S" -ge 80 ]; then COLOR=brightgreen
+          elif [ "$S" -ge 70 ]; then COLOR=green
+          elif [ "$S" -ge 60 ]; then COLOR=yellowgreen
+          elif [ "$S" -ge 50 ]; then COLOR=yellow
+          else                        COLOR=orange
+          fi
+          printf '{"schemaVersion":1,"label":"mutation","message":"%s%% (%s/%s)","color":"%s"}\n' \
+            "$S" "${{ steps.mutation.outputs.killed }}" "${{ steps.mutation.outputs.total }}" "$COLOR" \
+            > mutation-badge.json
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add coverage-badge.json mutation-badge.json
+          git diff --cached --quiet || git commit -m "chore: update badges [skip ci]"
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

thermalcanary-1.1.0/.gitignore

@@ -0,0 +1,18 @@
+venv/
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+.idea/
+*.swp
+CLAUDE.md
+scripts/
+.serena/
+.coverage
+htmlcov/
+dist/
+build/
+*.egg-info/
+mutants/
+pyproject.toml.mutmut_tmp
+.mutmut-cache

thermalcanary-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ibasaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

thermalcanary-1.1.0/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: thermalcanary
+Version: 1.1.0
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: nvidia-ml-py>=12.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pyqt6>=6.5.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14; extra == 'dev'
+Requires-Dist: pytest-qt>=4.4; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'

thermalcanary-1.1.0/README.md

@@ -0,0 +1,181 @@
+<p align="center">
+  <img src="assets/logo.png" alt="Thermal Canary" width="600">
+</p>
+
+<p align="center">
+  <a href="https://github.com/ibasaw/thermalcanary/actions/workflows/ci.yml"><img src="https://github.com/ibasaw/thermalcanary/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+  <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ibasaw/thermalcanary/main/coverage-badge.json&cacheSeconds=300" alt="Coverage">
+  <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ibasaw/thermalcanary/main/mutation-badge.json&cacheSeconds=300" alt="Mutation score">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
+  <img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+">
+  <img src="https://img.shields.io/badge/platform-Linux-lightgrey.svg" alt="Platform: Linux">
+</p>
+
+The Linux software for dedicated hardware monitoring screens — like AIDA64's sensor panel, but native to your desktop.
+
+6 circular arc gauges (CPU temp, usage, RAM · GPU temp, fan, VRAM) built with PyQt6 and pynvml.
+Smooth 60fps animation, rolling average stabilisation, dynamic heat colors. Auto-starts on login.
+
+**Built for dedicated monitoring screens** — works out of the box on stretched panels (1920×480), small IPS monitors, or any secondary display you use as a permanent hardware panel.
+
+> ⚠ **Important** — this is NOT an overlay. Thermal Canary is a fullscreen app intended for a **dedicated monitor**. Don't try to use it as an in-game overlay (use MangoHud for that).
+
+**Fully responsive** — gauges scale to any resolution and orientation: ultrawide, portrait, rotated, compact.
+
+**One-command install** — a single `bash install.sh` sets up everything automatically.
+
+### Dedicated monitoring screen setup
+
+Plug in a secondary screen (a stretched panel, a small IPS monitor, anything), select it in the Settings sidebar under **Monitor**, and click **Set as default**. Thermal Canary will always open on that screen at login — no configuration files to edit.  
+
+![Thermal Canary preview](screenshot.png)
+
+![Thermal Canary with settings sidebar open](screenshot-settings.png)
+
+## Gauges
+
+| Row | Gauge | Source |
+|-----|-------|--------|
+| CPU | CPU Temperature | `psutil.sensors_temperatures()` — coretemp/k10temp (configurable) |
+| CPU | CPU Usage % | psutil |
+| CPU | RAM Usage % | psutil |
+| GPU | GPU Temperature | NVIDIA: pynvml · AMD: sysfs hwmon · Intel: xe/i915 sysfs |
+| GPU | GPU Fan Speed % | NVIDIA: pynvml · AMD: sysfs hwmon (0% = fans stopped or AMD integrated GPU with no fan) |
+| GPU | GPU VRAM Usage % | NVIDIA: pynvml · AMD: sysfs hwmon · Intel: always 0 (not exposed by driver) |
+
+## Requirements
+
+> **Tested and supported on Ubuntu 24.04 LTS.** Other distros (Fedora, Arch, openSUSE) are supported by the installer but have not been formally tested yet. Ubuntu versions below 24.04 may work but are not guaranteed.
+
+The installer checks and installs everything automatically. Here is the full dependency list:
+
+**System packages** (installed automatically via your distro's package manager):
+
+| Dependency | Purpose |
+|------------|---------|
+| Python 3.10+ | Runtime |
+| `python3-venv` | Isolated Python environment |
+| `lm-sensors` | Populates `/sys/class/hwmon` for CPU temperature |
+| XCB cursor libs (`libxcb-cursor0` / `xcb-util-cursor`) | Required by PyQt6 on X11 |
+
+**NVIDIA driver** — checked separately. The installer prints distro-specific install instructions if the driver is missing. GPU gauges (temperature, fan, VRAM) require the driver for NVIDIA; AMD and Intel GPUs are read via sysfs without any driver installation.
+
+> **GPU backends**: NVIDIA (`pynvml`, direct NVML — no `nvidia-smi` subprocess), AMD (`amdgpu` sysfs hwmon — kernel driver, no extra install), Intel (`xe`/`i915` sysfs hwmon). The backend is auto-detected at startup or can be forced in the Settings sidebar. If no GPU is detected, all three GPU gauges show `—`.
+
+**Python libraries** (installed automatically into a venv):
+
+| Library | Purpose |
+|---------|---------|
+| `PyQt6` | GUI framework |
+| `psutil` | CPU temperature, CPU usage, RAM usage |
+| `nvidia-ml-py` (`pynvml`) | GPU metrics via direct NVML calls — no `nvidia-smi` subprocess |
+| `PyYAML` | Config file read/write |
+
+Supported package managers: **apt** (Debian/Ubuntu), **dnf** (Fedora/RHEL), **pacman** (Arch), **zypper** (openSUSE).
+
+## Install
+
+```bash
+git clone https://github.com/ibasaw/thermalcanary.git
+cd thermalcanary
+bash install.sh
+```
+
+**Thermal Canary runs entirely as your user — no root needed at runtime.**
+
+The installer separates system-package installation from everything else:
+
+- `bash install.sh` — checks system packages and prints any missing ones with the exact `sudo` command to install them, then proceeds with the rootless steps (venv, pip, desktop files, launch)
+- `bash install.sh --install-deps` — same, but also invokes `sudo` automatically to install missing packages
+
+The installer will:
+1. Check for NVIDIA driver — prints distro-specific install instructions if missing (GPU gauges need it; CPU/RAM gauges work without)
+2. Check system packages — prints missing ones or installs them if `--install-deps` was passed
+3. Copy the app package and icon to `~/.local/share/thermalcanary/`
+4. Create a Python venv and install all Python dependencies (PyQt6, psutil, nvidia-ml-py, PyYAML)
+5. Verify all dependencies are working
+6. Copy the default config to `~/.config/thermalcanary/config.yaml` (only on first install — never overwrites existing config)
+7. Register the app in `~/.local/share/applications/` for taskbar icon support
+8. Register an autostart entry so the app launches 8 seconds after login
+9. Kill any running instance and launch the app immediately
+
+The clone folder is only needed to run the installer. You can delete it afterwards.
+
+## Installed file layout
+
+| Path | What |
+|------|------|
+| `~/.local/share/thermalcanary/thermalcanary/` | App package |
+| `~/.local/share/thermalcanary/assets/` | App icon |
+| `~/.local/share/thermalcanary/venv/` | Python virtual environment |
+| `~/.local/share/icons/hicolor/*/apps/thermalcanary.png` | System icon (taskbar) |
+| `~/.local/share/applications/thermalcanary.desktop` | App entry (taskbar icon) |
+| `~/.config/thermalcanary/config.yaml` | User configuration (auto-saved by the app) |
+| `~/.config/autostart/thermalcanary.desktop` | Autostart on login |
+
+## Launch manually
+
+```bash
+cd ~/.local/share/thermalcanary && venv/bin/python3 -m thermalcanary
+```
+
+## Settings sidebar
+
+Two buttons sit in the top-right corner: **⚙** opens the settings sidebar, **✕** closes the app (with confirmation). Press **Ctrl+,** to toggle the sidebar from the keyboard. All changes apply live without restarting.
+
+| Section | Setting | Description |
+|---------|---------|-------------|
+| Display | Monitor | Which monitor to display on — works with any number of monitors and any orientation |
+| Display | Set as default | Save the current monitor as the startup monitor — the app always opens here on launch |
+| Sampling | Poll rate | Sensor poll interval (100ms – 10s) |
+| Sampling | Smoothing | Rolling average window size (1–60 samples) |
+| Colors | Background | Window background color |
+| Colors | Inner circle | Gauge center fill color |
+| Colors | Arc track | Unfilled arc track color |
+| Colors | Tick marks | Tick mark color |
+
+The **Reset to defaults** button restores all colors and sampling values to factory settings while keeping your saved default monitor.
+
+## Configuration file
+
+`~/.config/thermalcanary/config.yaml` is written automatically by the settings sidebar. You can also edit it by hand; changes take effect on next launch.
+
+```yaml
+poll_ms:  1000     # sensor poll interval in milliseconds
+smooth_n: 5        # rolling average window (number of samples)
+
+bg_color:    "#252040"   # window background
+inner_color: "#1e1a35"   # gauge inner circle
+track_color: "#332e55"   # arc track (unfilled)
+tick_color:  "#3d3860"   # tick marks
+
+# screen_index and default_screen_index are set via the Settings sidebar
+```
+
+## Autostart caveat
+
+The autostart entry inherits `$DISPLAY` from the login session, falling back to `:0`. If the app doesn't start on login, check your display number with `echo $DISPLAY` and edit `~/.config/autostart/thermalcanary.desktop` accordingly.
+
+## Uninstall
+
+```bash
+bash uninstall.sh
+```
+
+Removes the app, venv, icon, config, and all desktop entries after confirmation.
+
+## Architecture
+
+- **SensorWorker** runs in a `QThread` — all sensor reads are off the main thread
+- GPU metrics use **pynvml** (direct NVML calls, <1ms) — never `subprocess nvidia-smi` which causes observer-effect CPU temperature spikes of 10–15°C
+- CPU temp and usage are stabilised with a `deque`-based rolling average
+- **Config** is reactive: `Config(QObject)` emits a signal on every change, all settings apply live
+- Window runs **fullscreen** (`showFullScreen`) — no title bar, fills the entire monitor. This bypasses Mutter's `WM_NORMAL_HINTS` enforcement which otherwise clamps window geometry to `minimumSizeHint`, making maximize unreliable on short or rotated monitors
+- Monitor switching uses an event-driven state machine: `showNormal()` → wait for `WindowStateChange` (Mutter ack) → `windowHandle().setScreen()` + `setGeometry()` → 50ms → `showFullScreen()`. `wmctrl` is called once after first show to set `_NET_WM_STATE_SKIP_TASKBAR/SKIP_PAGER` (hides the window from GNOME Dash without using `Qt.WindowType.Tool`, which would break cross-monitor placement on Mutter)
+- Monitor indices are validated against actual connected screens at startup — safe on any number of monitors
+- Single-instance lock via `fcntl.flock` on `$XDG_RUNTIME_DIR/thermalcanary.lock`
+- Runs entirely as the logged-in user — no root required at runtime
+
+## License
+
+MIT — see [LICENSE](LICENSE)

thermalcanary-1.1.0/bin/build_logo.py

@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+"""Generate assets/logo.png — horizontal lockup: canary icon + "Thermal Canary" wordmark."""
+from pathlib import Path
+from PIL import Image, ImageDraw, ImageFont, ImageFilter
+
+ROOT = Path(__file__).resolve().parent.parent
+ICON = ROOT / "assets" / "icon.png"
+FONT_PATH = ROOT / "bin" / "fonts" / "Exo2-SemiBold.ttf"
+OUT = ROOT / "assets" / "logo.png"
+
+CANVAS = (1400, 400)
+BIRD_HEIGHT = 320
+BIRD_X = 80
+BIRD_Y = (CANVAS[1] - BIRD_HEIGHT) // 2   # 40px top/bottom margin
+GAP = 60
+FONT_SIZE = 140
+COLOR_THERMAL = (242, 242, 242, 255)       # warm off-white
+COLOR_CANARY  = (245, 197, 24, 255)        # matches bird yellow
+SHADOW        = (0, 0, 0, 80)
+OPTICAL_NUDGE = -20                        # raise text to align with bird body centroid
+
+canvas = Image.new("RGBA", CANVAS, (0, 0, 0, 0))
+
+# Bird
+bird = Image.open(ICON).convert("RGBA")
+bw = int(bird.width * BIRD_HEIGHT / bird.height)
+bird = bird.resize((bw, BIRD_HEIGHT), Image.LANCZOS)
+bird_layer = Image.new("RGBA", CANVAS, (0, 0, 0, 0))
+bird_layer.paste(bird, (BIRD_X, BIRD_Y), bird)
+canvas = Image.alpha_composite(canvas, bird_layer)
+
+# Font with fallback chain
+for font_path in [FONT_PATH, "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf"]:
+    try:
+        font = ImageFont.truetype(str(font_path), FONT_SIZE)
+        break
+    except (OSError, IOError):
+        continue
+else:
+    font = ImageFont.load_default()
+
+text_x = BIRD_X + bw + GAP
+text_y = (CANVAS[1] - FONT_SIZE) // 2 + OPTICAL_NUDGE
+w_thermal = font.getbbox("Thermal ")[2]
+
+# Shadow layer
+shadow_layer = Image.new("RGBA", CANVAS, (0, 0, 0, 0))
+sd = ImageDraw.Draw(shadow_layer)
+sd.text((text_x, text_y + 2), "Thermal ", font=font, fill=SHADOW)
+sd.text((text_x + w_thermal, text_y + 2), "Canary", font=font, fill=SHADOW)
+shadow_layer = shadow_layer.filter(ImageFilter.GaussianBlur(radius=2))
+canvas = Image.alpha_composite(canvas, shadow_layer)
+
+# Text layer
+text_layer = Image.new("RGBA", CANVAS, (0, 0, 0, 0))
+td = ImageDraw.Draw(text_layer)
+td.text((text_x, text_y), "Thermal ", font=font, fill=COLOR_THERMAL)
+td.text((text_x + w_thermal, text_y), "Canary", font=font, fill=COLOR_CANARY)
+canvas = Image.alpha_composite(canvas, text_layer)
+
+canvas.save(OUT, "PNG", optimize=True)
+print(f"Saved {OUT} ({OUT.stat().st_size // 1024} KB)")

thermalcanary-1.1.0/config.example.yaml

@@ -0,0 +1,23 @@
+# Thermal Canary — configuration
+# Installed to: ~/.config/thermalcanary/config.yaml
+# Edited live by the Settings sidebar — you can also edit this file by hand.
+
+# Monitor to display on (0 = primary, 1 = second, 2 = third...).
+# Defaults to your primary monitor. Set via the Settings sidebar.
+# screen_index: 0
+
+# Monitor to return to when "Reset to defaults" is pressed.
+# Set via the "Set as default" button in the Settings sidebar.
+# default_screen_index: 0
+
+# Sensor poll interval in milliseconds (lower = more responsive, higher = less CPU)
+poll_ms: 1000
+
+# Rolling average window: number of samples averaged to smooth noisy sensors
+smooth_n: 5
+
+# Colors — hex strings
+bg_color:    "#252040"   # window background
+inner_color: "#1e1a35"   # gauge inner circle
+track_color: "#332e55"   # arc track (unfilled portion)
+tick_color:  "#3d3860"   # tick marks

thermalcanary-1.1.0/coverage-badge.json

@@ -0,0 +1 @@
+{"schemaVersion":1,"label":"coverage","message":"72%","color":"yellowgreen"}