# aldermon

btop-style TUI monitor for Alder Lake (i5-12600KF), built around real vCore
voltage for overclock-safety work.

## Usage

```sh
cargo run --release -- --tui    # TUI (default workhorse)
cargo run -- --vid              # VID spike tool (debug)
cargo run                       # one-shot sensor dump
```

The TUI needs a real terminal (pty); it will not run on redirected output.

Features: vCore hero panel (limit marker, 5-min peak, auto-scale), board
rails, package power/temp, per-core frequency bars + temps, E/P-core
sections, footer max frequency.

## Config

`aldermon.conf` is read from the working directory, then
`~/.config/aldermon/aldermon.conf`. Simple `KEY = VALUE` lines; `#`
comments; unknown keys are ignored. All values optional — built-in defaults
target an ASRock Z690M ITX/ax (nct6798).

```ini
vcore_limit   = 1.403   # safety limit shown as marker on the vCore bar
temp_warn     = 80.0
temp_crit     = 95.0

# Per-graph y scales (also editable in the settings pane, F2)
vcore_min     = 0.0
vcore_bar_max = 1.50
clock_min     = 0          # kHz
clock_bar_max = 4500000
power_min     = 0.0
power_bar_max = 200.0
temp_min      = 0
temp_max      = 100

rail.in0.label = CPU Vcore   # hwmon input label
rail.in4.label = VCCIO?
rail.in5.hide  = true        # hide unwired/floating inputs
```

Rail labels for this board were confirmed against the BIOS and differential
stress-ng probing (2026-08-29); see comments in `aldermon.conf`. The only
remaining guess is in4 = VCCIO.

## Package power (RAPL) — one-time setup

`energy_uj` is root-only on this kernel. To read watts as a normal user,
install the udev rule once as root:

```sh
doas ./powercap-pl-rules.sh
doas usermod -aG adm $USER   # then re-login
```

## Status

Working: TUI, config, RAPL power, rail map for Z690M ITX/ax. Remaining
notes in `to-do.md`.