Tech HUD

A highly customizable, themeable system telemetry display and desktop HUD built in Vala and GTK3.

Overview

tech_hud provides a modular heads-up display for Linux environments featuring rich theming options. It tracks and visualizes real-time system metrics—such as CPU, memory, and environment data—while integrating with modular companions like mu-wetter for live weather forecasts via ~/.mu-wetter/forecast.txt.

Features

* Advanced Theming Engine: Easily switchable visual profiles and customizable layouts tailored for modern Linux desktops.
* Design Categories & Glass Variants: Choose between Spaceship-Neon, multi-variant Glass (Clear, Frosted, Blurry, Ultra-Clear, Diamond Crystal Shimmer), and luxury Marble textures (with procedural fallback and marble-tile.jpg support).
* Text 3D Styles: Advanced text rendering supporting Normal, Debossed / Carved into Stone, and Embossed / Raised 3D text.
* Localization: Multi-language translation support for German, French, Russian, Chinese, Japanese, Spanish, Swahili, Italian, Portuguese, Dutch, Korean, Arabic, and Hebrew.
* Live System Metrics: Real-time rendering of hardware and system performance data.
* Weather Integration: Seamlessly pulls current conditions and forecasts from ~/.mu-wetter/forecast.txt.

Changelog

### 1.1.0 - 2026-10-24
* Added design option enhancements: Marble textures, multi-variant Glass rendering, and adjustable background/panel opacities.
* Added Text 3D styles (Debossed / Carved and Embossed / Raised 3D).
* Added comprehensive multi-language support (13 languages) using GNU gettext.
* Added `make pet64` target to Makefile for building Puppy Linux PET packages.
* Converted README.md to README.txt.

### 1.0.1 - 2026-10-04
* Run mu-wetter --silent at startup and hourly; parse German forecast rows.
* Add persistent Sticky option and apply window type/layer changes immediately.
* Extend HUD and sphere scaling options to 1000%.

### 1.0.2
* Fixed freeze on double-click in IceWM.

Requirements

* Vala compiler (valac)
* GTK+ 3 development libraries (libgtk-3-dev)
* GLib and GIO libraries (libglib2.0-dev)
* Cairo and PangoCairo development files
* GNU gettext tools (msgfmt)

Building and Installation

Compile the project binaries using the included Makefile:
  make

Install the utility to your local environment:
  sudo make install

Build Puppy Linux PET package:
  make pet64
