Skip to content

A lightweight Linux desktop application that provides visual system health checks through a clean GUI. Designed to be launched by double-clicking, not by typing commands.

Notifications You must be signed in to change notification settings

iSev7n/Linux-Healthcheck

Repository files navigation

Linux Healthcheck (Desktop GUI)

Dashboard Deep Mode Journal

A simple, clean desktop application for running Quick or Deep Linux system health checks with a visual GUI.

Designed to be launched by double-clicking, not by typing commands.


✨ Features

Quick Check (fast, no admin)

  • Uptime & load average
  • Memory availability
  • Disk usage
  • Failed systemd services
  • Journal errors (filtered to reduce noise)
  • Network connectivity (ping)
  • Pending updates

Deep Check (one-time admin prompt)

Includes everything in Quick plus:

  • SMART disk health
  • System temperatures (lm-sensors)
  • Top CPU / memory consuming processes

Deep mode relaunches the app once using pkexec so you don’t get repeated sudo password prompts.


🖥️ GUI Highlights

  • Green / Yellow / Red row indicators
  • Emoji status icons (easy to read at a glance)
  • Clickable history of last 10 runs
  • Detailed output + recommended actions panel
  • JSON reports automatically saved

📁 Report Location

Reports are saved automatically to:

~/.local/share/linux-healthcheck/

Each run produces a timestamped JSON file.


📦 Requirements (Ubuntu / Debian)

sudo apt update
sudo apt install -y python3 python3-tk lm-sensors smartmontools

After installing sensors (recommended once):

sudo sensors-detect

▶️ Running the App

chmod +x run.sh
./run.sh

Or double-click run.sh from your file manager.


🔐 About Permissions

  • Quick mode runs without admin rights
  • Deep mode prompts once via pkexec to access SMART data
  • No background services
  • No persistence
  • No telemetry

⚠️ Notes

  • Some drives may report SMART as UNKNOWN depending on controller or enclosure — this is normal
  • Journal messages are filtered to reduce harmless startup noise
  • A single SATA soft reset is treated as transient, not a failure

🧩 Project Structure

Linux-Daily-Healthcheck/
├── run.sh
├── install.sh
├── healthcheck_gui.py
├── healthcheck_core.py
├── config.json
└── README.md

📄 License

MIT License — free to use, modify, and distribute.


💡 Why This Exists

Most Linux health tools are CLI-only.

This project is meant to feel like a real desktop utility you can run daily without thinking about commands.

About

A lightweight Linux desktop application that provides visual system health checks through a clean GUI. Designed to be launched by double-clicking, not by typing commands.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published