$ show IT-BAER/proxmorph
ProxMorph is a comprehensive theming system for the Proxmox VE, PBS, and Proxmox Datacenter Manager web interfaces. It provides 23+ dark and light themes derived from popular color palettes (Catppuccin, Dracula, Nord, Gruvbox, Solarized, Tokyo Night, UniFi, GitHub Dark, Blue Slate). The project's primary artifact is a bash installer (`install.sh`) that detects the Proxmox product, deploys CSS files into Proxmox's widget-toolkit directory, patches `proxmoxlib.js` to register themes in the native Color Theme selector, and optionally installs APT hooks for re-patching after system updates. It also includes hardware sensor monitoring (CPU/NVMe/HDD temps, fan speeds, UPS) via a Perl patch to `Nodes.pm` and a client-side JavaScript widget. Architecture is a hybrid of shell scripting (installer, theme generation), static CSS (themes), and JavaScript patches (theme selector, chart colors, sensor display). Each theme is a standalone CSS file (~2000-3000 lines) that overrides ExtJS component classes with heavy use of `!important`. The installer supports cluster-wide deployment via SSH, checksum verification for supply-chain security, and rollback via backup files. The project also includes a component inventory document and a generator for OLED variants using awk-based palette substitution. While the theming itself is tightly coupled to Proxmox's ExtJS DOM structure, the installer and generation scripts exhibit non-trivial shell scripting patterns. The project is actively maintained (v2.8.4), with detailed changelogs and versioned releases. It is not a data research project; all content is UI theming and deployment tooling.
The LLM identified 2 files worth highlighting for reuse:
A standalone awk script that performs palette-based color substitution in CSS files. It reads a TSV palette with three columns (color name, hex value, RGB value) and replaces occurrences of a '{{color}}' pattern with the corresponding product-specific substitution (e.g., converting `{{accent}}` to `#XXXXXX` for PVE or PDM). This is used by `gen-oled.sh` to generate OLED theme variants from a base UniFi theme. The script is self-contained, input-driven, and could be reused for any CSS palette generation task with minimal adaptation.
A modular JavaScript patch that adds a real-time hardware sensor dashboard to the Proxmox node Summary page. It fetches sensor data (CPU, NVMe, HDD temperatures, fan speeds, UPS status) via Proxmox's API endpoints (`/api2/json/nodes/{node}/sensors`, `/api2/json/cluster/status`, etc.) and renders a compact, color-coded sensor row with filtering by string. It uses ExtJS component queries and MutationObserver to inject into the UI. While tied to Proxmox's API structure, the pattern of a self-contained, API-driven UI widget with fallback handling is clean and could be adapted for other monitoring dashboards.