Raspberry Pi Live Temperature Monitor

This script provides a live, real-time graph of your Raspberry Pi's CPU temperature and CPU load directly in the terminal. The graph scrolls dynamically as new data is collected and includes color-coded alerts for temperature thresholds.

I built this for use on my Hackberry Pi, but others may find it useful as well. Check out their project for a great hand-held cyberdeck!

Features

• Real-Time Temperature Monitoring: Continuously updates the CPU temperature in real-time.
• Dynamic Scrolling Graph: Displays a scrolling graph of the most recent temperature readings.
• CPU Load Display: Shows current CPU load percentage.
• Color-Coded Alerts:
  • Green: Safe temperature.
  • Yellow: Warning temperature (close to threshold).
  • Red: Temperature exceeds the specified threshold.
• Pause/Resume Functionality: Pause and resume the monitoring process.
• Logging (Optional): Logs temperature readings to a file with timestamps if the --log argument is provided.
• Elapsed Time: Displays the total runtime of the script.
• Command-Line Arguments: Customize threshold, log file path, and number of points displayed.

Requirements

• Python 3
• Dependencies:
  • asciichartpy: For plotting the graph.
  • psutil: For fetching CPU load data.

Installing Dependencies

You can install the required dependencies using the requirements.txt file.

1. Install via pip:

   pip install -r requirements.txt
   

2. Alternatively, Install Manually:

   pip install asciichartpy psutil
   

Usage

Running the Script

python PiTemp.py [OPTIONS]

Command-Line Options

Option	Description	Default Value
--threshold	Temperature threshold for alerts (°C).	70.0
--log	Path to the log file (optional).	None
--points	Number of points to display on the graph.	100

Example Command

python PiTemp.py --threshold 65.0 --log my_temp_log.txt --points 200

Controls

Key	Action
q	Quit the script.
p	Pause updates.
r	Resume updates.

Output Example

Current Temp: 55.2 °C
CPU Load: 32.1%
Threshold: 70.0 °C
Elapsed Time: 00:05:23
RUNNING

    60.0 ┤                            ╭─╮    
    57.5 ┤                       ╭────╯ ╰─╮  
    55.0 ┤                  ╭────╯       ╰╮ 
    52.5 ┤          ╭───────╯             ╰╮
    50.0 ┤      ╭───╯                      ╰
    47.5 ┤  ╭───╯                           

Commands: [q] Quit | [p] Pause | [r] Resume

Logging

Temperature readings will only be logged if the --log argument is provided. Example log entries:

2024-06-15 12:01:23 - 55.2 °C
2024-06-15 12:01:24 - 55.6 °C
2024-06-15 12:01:25 - 56.0 °C