* refactor: restructure src/ into modules/, scripts/, and build/

- src/nag_screen/ and src/node_info/ -> src/modules/  (mods grouped explicitly)
- src/Scripts/ -> src/scripts/                        (lowercase, consistent)
- src/gen-rules.sh -> build/                          (build tool separated from source)

Update all references: debian/rules, .github/workflows/*, build/gen-rules.sh,
src/scripts/test/test-syntax.sh (SRC_DIR now points to src/modules/),
src/scripts/test/test-patches.sh, and files.list comments.

* refactor: move CI test scripts from src/scripts/test/ to build/test/

Test scripts are not installed — they are CI/dev tooling and belong
alongside build/gen-rules.sh. Update workflow references and fix the
SRC_DIR path depth in build/test/test-syntax.sh (../ -> ../..).

* d

---------

Co-authored-by: Meliox <na>

2026-08-08 23:46:46 +02:00

2.3 KiB

Raw Blame History

node_info

Extends the Proxmox VE node status view with live hardware sensor data. A background daemon collects data from the configured sources and exposes it through the PVE API.

Features

Temperature Sensors (lm-sensors)

Reads hardware sensor data via lm-sensors and enriches each chip/adapter entry with context. CPU, RAM, HDD/SSD, NVME are directly supported and other temperature sensors can be bundled and displayed together.

NVIDIA GPU

Polls nvidia-smi on a configurable interval. Supports multiple GPUs. Metrics can be stored in RRD for historical graphing.

Metric	Unit
GPU temperature	°C
GPU utilisation	%
Memory utilisation	%
Memory used / total	MiB
Power draw / limit	W
Fan speed	%

Intel GPU

Polls intel_gpu_top for each detected Intel GPU card. Metrics can be stored in RRD for historical graphing.

Metric	Unit
Requested / actual frequency	MHz
Interrupt rate	irq/s
RC6 residency	%
GPU power / package power	W
Engine busy/semaphore/wait (Render, Blitter, Video, VideoEnhance)	%

AMD GPU

Placeholder — device discovery and collection are not yet implemented.

UPS (Network UPS Tools)

Polls upsc for a configured NUT device and exposes all key-value pairs returned by the daemon. Supports any UPS accessible via NUT (local or remote).

Configuration: device_name=ups@localhost

System Information

Reads hardware identity from dmidecode (cached at configure time, no runtime root required).

`type`	Data source	Fields exposed
`1`	DMI System	Manufacturer, Product Name, Serial Number
`2`	DMI Baseboard	Manufacturer, Product Name, Serial Number

Requirements

Each feature requires the corresponding tool to be installed on the Proxmox host:

Feature	Required tool
Temperature sensors	`lm-sensors` (`sensors` binary)
NVIDIA GPU	`nvidia-smi`
Intel GPU	`intel-gpu-tools` (`intel_gpu_top` binary)
UPS	`nut-client` (`upsc` binary)
System information	`dmidecode` (run once via `pve-mod-configure`)

Debug Mode

Each collector supports a debug mode that reads from a local file instead of executing the real tool. Useful for development and testing without physical hardware.

2.3 KiB Raw Blame History