# vitals

Logs system temperatures, power status and memory load once a minute, and plots
the history.

- `vitals-log` takes one sample and appends it to `vitals-YYYY-MM.csv`. A
  systemd user timer runs it every minute.
- `vitals` is the viewer: the latest reading plus time-series plots, built with
  egui and egui_plot.

## Install

    make install

This builds both binaries into `~/.local/bin`, installs and starts
`vitals-log.timer` (systemd user unit), and installs the `Vitals` desktop entry
so the viewer shows up in the launcher. `PREFIX=/somewhere make install` changes
where the binaries go; the unit and desktop entry are generated from the
templates in `dist/` to point at them. The pieces can be installed separately
with `make install-bin`, `install-units` and `install-desktop`.

`make uninstall` removes all of it and leaves the logs alone. For logging to
continue while logged out, enable lingering once: `loginctl enable-linger`.

## Logger

    vitals-log [--dir PATH] [--print]

Logs go to `$XDG_STATE_HOME/vitals` (`~/.local/state/vitals`), one file per
month, about 5 MB each. `--print` writes the header and a sample to stdout
without touching the log, which is the quick way to check what a machine
exposes.

The columns are fixed and defined in `src/sample.rs`: temperatures come from
hwmon chips looked up by name (the `hwmonN` numbering changes between boots),
power from `/sys/class/power_supply` and `powerprofilesctl`, memory from
`/proc/meminfo` and `/proc/pressure/memory`. The sensor table is specific to
this laptop (Framework, Intel); on other hardware, edit `TEMPERATURES`. A source
that can't be read leaves an empty cell. If the column set changes mid-month,
the old file is renamed `vitals-YYYY-MM.until-<timestamp>.csv` so layouts never
mix in one file.

## Viewer

    vitals [--dir PATH] [--interval SECONDS] [--range 1h|6h|24h|7d|all]

Every `vitals-YYYY-MM.csv` is loaded at startup; after that only bytes appended
since the last check are read (every 10 s by default). Columns are matched by
header name, so a changed log layout shows gaps rather than breaking.

Drag to pan and ctrl-scroll or pinch to zoom the time axis; all plots move
together. Picking a range preset returns to following the clock. Lines break
where the logger was not running, and on-battery periods are shaded in the
battery plot. Wide ranges are reduced to per-bucket min/max, so spikes stay
visible.

## Source

- `src/sample.rs` — reading sensors, appending to the log
- `src/data.rs` — parsed series, windowing, gap splitting, downsampling
- `src/tail.rs` — incremental file reader, month rollover, replaced-file reload
- `src/bin/vitals-log.rs` — the logger's command line
- `src/bin/vitals.rs` — the viewer; the `PANELS` table defines the plots
- `dist/` — systemd unit and desktop entry templates