hardwaremon 0.0.0__tar.gz

hardwaremon-0.0.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Build & Publish HardwareMon
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.11
+
+      - run: |
+          python -m pip install --upgrade pip
+          pip install build twine setuptools_scm
+
+      - run: python -m build
+
+      - run: python -m twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}

hardwaremon-0.0.0/.github/workflows/python-app.yml

@@ -0,0 +1,40 @@
+name: Lint
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: ["**"]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          pip install flake8 pylint
+
+      - name: Run flake8
+        run: |
+          flake8 hardwaremon/hardwaremon.py hardwaremon/hardwaremon_gui.py \
+            --max-line-length=120 \
+            --extend-ignore=E501,W503,F401,F841,F811,E302,E303,E305,E266,W291,W292,W293,E402,E741,E701,E722,E131,E228,E231 \
+            --count \
+            --statistics
+
+      - name: Run pylint
+        run: |
+          pylint hardwaremon/hardwaremon_gui.py hardwaremon/hardwaremon.py \
+            --disable=C0114,C0115,C0116 \
+            --max-line-length=120 \
+            --fail-under=6.0
+        continue-on-error: true

hardwaremon-0.0.0/.gitignore

@@ -0,0 +1,20 @@
+venv/
+pycache/
+*.pyc
+.env
+.vscode/
+.DS_Store
+Thumbs.db
+build/
+dist/
+*.egg-info/
+*.egg
+__pycache__/
+*.py[cod]
+*$py.class
+Windows/build/
+Windows/dist/
+Windows/*.spec
+Windows/build.bat
+Windows/*.svg
+Windows/*make_icon.py

hardwaremon-0.0.0/HardwareMon.sh

@@ -0,0 +1,231 @@
+#!/bin/bash
+
+VERSION="2.0.0"
+
+MODE="summary"
+
+# Colors
+RED="\e[31m"
+GREEN="\e[32m"
+CYAN="\e[36m"
+YELLOW="\e[33m"
+RESET="\e[0m"
+
+MAX_POINTS=50
+
+cpu_history=()
+mem_history=()
+disk_history=()
+
+clear_screen() {
+clear
+}
+
+cpu_percent() {
+
+awk -v RS="" '
+{usage=($2+$4)*100/($2+$4+$5)}
+END {printf "%d", usage}
+' /proc/stat
+
+}
+
+mem_percent() {
+free | awk '/Mem:/ {printf "%d", $3/$2 *100}'
+}
+
+
+disk_percent() {
+df / | awk 'NR==2 {print $5}' | tr -d %
+}
+
+bar() {
+
+value=$1
+width=50
+
+filled=$((value*width/100))
+
+printf "["
+
+for ((i=0;i<filled;i++))
+do
+printf "#"
+done
+
+for ((i=filled;i<width;i++))
+do
+printf " "
+done
+
+printf "] %s%%" "$value"
+
+}
+
+graph() {
+
+arr=("$@")
+
+for v in "${arr[@]}"
+do
+
+height=$((v/5))
+
+printf "%2s|" "$v"
+
+for ((i=0;i<height;i++))
+do
+printf "#"
+done
+
+echo
+
+done
+
+}
+
+add_history() {
+
+cpu_history+=($(cpu_percent))
+mem_history+=($(mem_percent))
+disk_history+=($(disk_percent))
+
+if [ ${#cpu_history[@]} -gt $MAX_POINTS ]
+then
+
+cpu_history=("${cpu_history[@]:1}")
+mem_history=("${mem_history[@]:1}")
+disk_history=("${disk_history[@]:1}")
+
+fi
+
+}
+
+alerts() {
+
+cpu=$(cpu_percent)
+mem=$(mem_percent)
+
+if ((cpu>90))
+then
+echo -e "${RED}CPU HIGH${RESET}"
+fi
+
+if ((mem>90))
+then
+echo -e "${RED}MEMORY HIGH${RESET}"
+fi
+
+}
+
+summary() {
+
+cpu=$(cpu_percent)
+mem=$(mem_percent)
+disk=$(disk_percent)
+
+echo -e "${CYAN}=== SYSTEM SUMMARY ===${RESET}"
+
+printf "CPU  "
+bar $cpu
+echo
+
+printf "MEM  "
+bar $mem
+echo
+
+printf "DISK "
+bar $disk
+echo
+
+echo
+
+alerts
+
+}
+
+full() {
+
+summary
+
+echo
+
+echo -e "${CYAN}=== CPU GRAPH ===${RESET}"
+
+graph "${cpu_history[@]}"
+
+echo
+
+echo -e "${CYAN}=== MEMORY GRAPH ===${RESET}"
+
+graph "${mem_history[@]}"
+
+echo
+
+echo -e "${CYAN}=== DISK GRAPH ===${RESET}"
+
+graph "${disk_history[@]}"
+
+echo
+
+echo -e "${CYELLOW}Top Processes${RESET}"
+
+ps -eo comm,%cpu,%mem \
+--sort=-%cpu | head -6
+
+echo
+
+echo -e "${CYAN}Temperatures${RESET}"
+
+sensors 2>/dev/null | grep Core
+
+echo
+
+echo -e "${CYAN}GPU${RESET}"
+
+lspci | grep -Ei "VGA|3D"
+
+}
+
+while true
+do
+
+clear_screen
+
+add_history
+
+if [ "$MODE" = "summary" ]
+then
+summary
+else
+full
+fi
+
+echo
+
+echo "HardwareMon Lite v$VERSION"
+
+echo "Press:"
+echo "s = summary"
+echo "f = full"
+echo "q = quit"
+
+read -t 1 -n 1 key
+
+case "$key" in
+
+s)
+MODE="summary"
+;;
+
+f)
+MODE="full"
+;;
+
+q)
+exit
+;;
+
+esac
+
+done

hardwaremon-0.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Louis Hinchliffe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hardwaremon-0.0.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: hardwaremon
+Version: 0.0.0
+Summary: Hardware monitoring tool for Linux
+Author: Louis
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psutil
+Requires-Dist: requests
+Requires-Dist: Pillow
+Requires-Dist: gputil
+Requires-Dist: pyinstaller
+Requires-Dist: customtkinter
+Dynamic: license-file
+
+# HardwareMon #
+![HardwareMon Demo](assets/demo.gif)
+(Windows GUI)
+
+
+HardwareMon is a lightweight system monitoring tool designed to provide a detailed overview of your computer's hardware and performance metrics. It can display CPU, memory, disk, GPU, battery, network, and peripheral information in real time. The project includes a Python GUI version for Linux and a modern Windows GUI application.
+
+## Features
+
+HardwareMon gathers and presents information such as CPU usage, memory usage, disk activity, top running processes, GPU specifications and temperatures, battery status, and peripheral details. On Linux, the Python version uses the psutil library and native system commands to extract detailed system information. On Windows, both the new Python GUI and the PowerShell version leverage CIM/WMI queries to report similar statistics.
+
+The Linux version includes a GUI mode built with Tkinter, offering a modern and configurable interface with light, dark, and hacker-style themes. To cycle themes, press F2. Graphs for CPU, memory, and disk usage are updated in real time, providing a quick visual snapshot of system performance.
+
+The Windows GUI version is built with CustomTkinter and features a Windows 11 Fluent Design-inspired interface with animated arc gauges, live sparkline graphs, per-core CPU bars, a real-time process table, and a full system information page.
+
+---
+
+## Windows (Python GUI — Recommended)
+
+The new Windows GUI is a modern, standalone application built with Python and CustomTkinter. It includes six pages which may change: Overview, CPU, Memory, Disk, Network, and System.
+
+Just download the .exe from this repo.
+
+That's literally it.
+
+
+### Notes
+
+- Run as Administrator for complete process visibility.
+- The `.exe` is fully self-contained — no Python required on the target machine.
+- Tested on Windows 10 and Windows 11.
+
+---
+
+## Installation (Linux version)
+
+### Using Git
+
+Ensure Python 3 and the psutil library are installed, then clone the repository and run:
+
+```
+python3 hardware_mon.py
+```
+
+### Using Pip (Easier, Quicker)
+
+Ubuntu/Debian:
+
+```
+sudo apt update
+sudo apt install python3-pip python3-tk pipx
+pip3 --version
+```
+
+RHEL/Fedora:
+
+```
+sudo dnf install python3-pip pipx python3-tk
+pip3 --version
+```
+
+Arch Linux:
+
+```
+sudo pacman -S python-pip pipx python3-tk
+pip --version
+```
+
+Then install HardwareMon:
+
+```
+pip install hardwaremon
+```
+
+### Fixing the "Externally Managed Environment" Error
+
+On Ubuntu and Debian-based systems you may see `error: externally-managed-environment`. The recommended fix is pipx:
+
+```
+sudo apt install pipx
+pipx ensurepath
+source ~/.bashrc
+pipx install hardwaremon
+```
+
+Run with either:
+
+```
+hardwaremon
+hardwaremon_cli
+```
+
+**Option 2 — Virtual environment:**
+
+```
+python3 -m venv hardwaremon-env
+source hardwaremon-env/bin/activate
+pip install hardwaremon
+```
+
+**Option 3 — Force install (not recommended):**
+
+```
+pip install hardwaremon --break-system-packages
+```
+
+## Updating
+
+To update hardwaremon on Linux, just use this command:
+
+```
+pipx upgrade hardwaremon
+```
+
+---
+
+## GUI vs CLI Versions (Linux)
+
+HardwareMon on Linux comes in two flavours. The GUI version separates hardware data into separate pages with clickable icons, while the CLI version displays everything in the terminal.
+
+```
+hardwaremon      # GUI version
+hardwaremon_cli  # CLI version
+```
+
+The GUI version receives the majority of active development, hoping to enhance its functionality.
+
+---
+
+## Q&A
+
+**What platforms is HardwareMon available for?**
+Windows and Linux. Linux versions receive more frequent updates. Windows now has a fully featured Python GUI.
+
+**What is the difference between hardwaremon and hardwaremon_cli on Linux?**
+`hardwaremon` is the GUI version for Linux with separate pages and clickable icons. `hardwaremon_cli` is the original terminal-based version, with much deeper insight into hardware compared to the GUI version. (this will change, it's quite bare-bones at the moment.)
+
+**Which version should I use?**
+On Linux, use `hardwaremon_cli` for the best experience and advanced performance metrics. If you want a "cleaner" version for Linux that receives more development than the GUI version of HardwareMon Linux, use `hardwaremon`. On Windows, use the  GUI `.exe` for a modern, feature-rich interface.
+
+**What do the YAML workflows do?**
+One workflow lints the scripts for errors, and the other packages the GUI and CLI versions into a pip package for Linux. Both workflows only operate on the Linux versions.
+
+**Can I contribute?**
+Absolutely! Feel free to fork the repo and submit pull requests or report issues on the issue tracker.
+
+---
+
+## Notes
+
+
+The `.sh` script is more basic than the `.py` script on Linux, as it cannot use Tkinter for graph drawing.
+
+The GitHub Actions workflows only run on the Linux versions.
+
+I have packaged each version into their own folder, so you don't get confused and run the wrong script for your OS.
+
+---
+
+Made with ❤️ by Louis

hardwaremon-0.0.0/README.md

@@ -0,0 +1,160 @@
+# HardwareMon #
+![HardwareMon Demo](assets/demo.gif)
+(Windows GUI)
+
+
+HardwareMon is a lightweight system monitoring tool designed to provide a detailed overview of your computer's hardware and performance metrics. It can display CPU, memory, disk, GPU, battery, network, and peripheral information in real time. The project includes a Python GUI version for Linux and a modern Windows GUI application.
+
+## Features
+
+HardwareMon gathers and presents information such as CPU usage, memory usage, disk activity, top running processes, GPU specifications and temperatures, battery status, and peripheral details. On Linux, the Python version uses the psutil library and native system commands to extract detailed system information. On Windows, both the new Python GUI and the PowerShell version leverage CIM/WMI queries to report similar statistics.
+
+The Linux version includes a GUI mode built with Tkinter, offering a modern and configurable interface with light, dark, and hacker-style themes. To cycle themes, press F2. Graphs for CPU, memory, and disk usage are updated in real time, providing a quick visual snapshot of system performance.
+
+The Windows GUI version is built with CustomTkinter and features a Windows 11 Fluent Design-inspired interface with animated arc gauges, live sparkline graphs, per-core CPU bars, a real-time process table, and a full system information page.
+
+---
+
+## Windows (Python GUI — Recommended)
+
+The new Windows GUI is a modern, standalone application built with Python and CustomTkinter. It includes six pages which may change: Overview, CPU, Memory, Disk, Network, and System.
+
+Just download the .exe from this repo.
+
+That's literally it.
+
+
+### Notes
+
+- Run as Administrator for complete process visibility.
+- The `.exe` is fully self-contained — no Python required on the target machine.
+- Tested on Windows 10 and Windows 11.
+
+---
+
+## Installation (Linux version)
+
+### Using Git
+
+Ensure Python 3 and the psutil library are installed, then clone the repository and run:
+
+```
+python3 hardware_mon.py
+```
+
+### Using Pip (Easier, Quicker)
+
+Ubuntu/Debian:
+
+```
+sudo apt update
+sudo apt install python3-pip python3-tk pipx
+pip3 --version
+```
+
+RHEL/Fedora:
+
+```
+sudo dnf install python3-pip pipx python3-tk
+pip3 --version
+```
+
+Arch Linux:
+
+```
+sudo pacman -S python-pip pipx python3-tk
+pip --version
+```
+
+Then install HardwareMon:
+
+```
+pip install hardwaremon
+```
+
+### Fixing the "Externally Managed Environment" Error
+
+On Ubuntu and Debian-based systems you may see `error: externally-managed-environment`. The recommended fix is pipx:
+
+```
+sudo apt install pipx
+pipx ensurepath
+source ~/.bashrc
+pipx install hardwaremon
+```
+
+Run with either:
+
+```
+hardwaremon
+hardwaremon_cli
+```
+
+**Option 2 — Virtual environment:**
+
+```
+python3 -m venv hardwaremon-env
+source hardwaremon-env/bin/activate
+pip install hardwaremon
+```
+
+**Option 3 — Force install (not recommended):**
+
+```
+pip install hardwaremon --break-system-packages
+```
+
+## Updating
+
+To update hardwaremon on Linux, just use this command:
+
+```
+pipx upgrade hardwaremon
+```
+
+---
+
+## GUI vs CLI Versions (Linux)
+
+HardwareMon on Linux comes in two flavours. The GUI version separates hardware data into separate pages with clickable icons, while the CLI version displays everything in the terminal.
+
+```
+hardwaremon      # GUI version
+hardwaremon_cli  # CLI version
+```
+
+The GUI version receives the majority of active development, hoping to enhance its functionality.
+
+---
+
+## Q&A
+
+**What platforms is HardwareMon available for?**
+Windows and Linux. Linux versions receive more frequent updates. Windows now has a fully featured Python GUI.
+
+**What is the difference between hardwaremon and hardwaremon_cli on Linux?**
+`hardwaremon` is the GUI version for Linux with separate pages and clickable icons. `hardwaremon_cli` is the original terminal-based version, with much deeper insight into hardware compared to the GUI version. (this will change, it's quite bare-bones at the moment.)
+
+**Which version should I use?**
+On Linux, use `hardwaremon_cli` for the best experience and advanced performance metrics. If you want a "cleaner" version for Linux that receives more development than the GUI version of HardwareMon Linux, use `hardwaremon`. On Windows, use the  GUI `.exe` for a modern, feature-rich interface.
+
+**What do the YAML workflows do?**
+One workflow lints the scripts for errors, and the other packages the GUI and CLI versions into a pip package for Linux. Both workflows only operate on the Linux versions.
+
+**Can I contribute?**
+Absolutely! Feel free to fork the repo and submit pull requests or report issues on the issue tracker.
+
+---
+
+## Notes
+
+
+The `.sh` script is more basic than the `.py` script on Linux, as it cannot use Tkinter for graph drawing.
+
+The GitHub Actions workflows only run on the Linux versions.
+
+I have packaged each version into their own folder, so you don't get confused and run the wrong script for your OS.
+
+---
+
+Made with ❤️ by Louis