Files
nixos-setup/bin/TEMP_MONITOR_README.md
2026-07-11 19:48:23 -04:00

3.1 KiB

Temperature Monitor Script

A nushell script for monitoring your laptop's CPU/GPU temperatures, storing them with timestamps, and visualizing them as a graph.

Features

  • Real-time monitoring: Collects temperature readings at configurable intervals
  • Persistent storage: Saves all readings to a CSV file with timestamps
  • Multiple sources: Tries multiple methods to read temperature data (lm_sensors, acpi, sysfs)
  • ASCII graphs: Displays temperature data as an ASCII bar graph
  • Flexible configuration: Customize duration, interval, and output location

Requirements

The script automatically detects and uses available tools. It will try these in order:

  1. sensors (from lm_sensors) - Recommended - Most reliable
  2. acpi - Fallback option
  3. /sys/class/thermal/thermal_zone0/temp - Linux sysfs fallback

On NixOS, you can add these to your environment with:

environment.systemPackages = with pkgs; [
  lm_sensors
  acpi
];

Usage

Basic usage (60-second collection with 2-second intervals)

./bin/temp-monitor

Collect for 5 minutes with 5-second intervals

./bin/temp-monitor --duration 300 --interval 5

Collect and display graph

./bin/temp-monitor --duration 60 --graph

Custom output file location

./bin/temp-monitor --output ~/my-temps.csv --duration 120 --graph

View stored data

cat ~/.cache/temp-data.csv

Command-line Options

  • --duration <seconds> - How long to collect data (default: 60)
  • --interval <seconds> - Seconds between readings (default: 2)
  • --output <path> - CSV file location (default: ~/.cache/temp-data.csv)
  • --graph - Display ASCII graph after collection completes

Output Format

The script stores data in CSV format with columns:

timestamp,cpu_temp,gpu_temp,max_temp
2024-07-11 14:30:45,65.5,N/A,65.5
2024-07-11 14:30:47,66.2,N/A,66.2

Graph Example

2024-07-11 14:30:45: ████████████ 65.5°C
2024-07-11 14:30:47: ██████████████ 66.2°C
2024-07-11 14:30:49: ████████████████ 68.1°C

Min: 65.5°C | Max: 68.1°C | Range: 2.6°C

Tips

  • Run multiple instances with different --output files to track different time periods
  • Use cron to collect continuous background data: */5 * * * * ~/nixos-setup/bin/temp-monitor --duration 1 --interval 1
  • High temperatures may indicate a need for thermal paste replacement or fan cleaning
  • The graph is great for spotting thermal throttling or fan ramp-ups during workloads

Troubleshooting

No temperature readings (showing "N/A"):

  • Check if sensors is installed and working: sensors
  • Check thermal zone: cat /sys/class/thermal/thermal_zone0/temp
  • Run sudo sensors-detect to configure lm_sensors on first use

Permission denied reading temperatures:

  • Some systems require sudo for detailed sensor access
  • Try: sudo ./bin/temp-monitor

CSV file grows too large:

  • Archive old data: mv ~/.cache/temp-data.csv ~/.cache/temp-data-$(date +%s).csv
  • Or use --output with a date-stamped filename