Mini OS Helper

Desktop utility for quick system checks, shortcuts, and notes.

Features

• Live CPU, RAM, disk, battery, and uptime snapshot
• Quick actions for folders, websites, and shell commands
• Notes tab with persistent local storage
• Light/dark preference with modern rounded UI

Dependencies

Runtime

• Python 3.11+
• Optional: psutil for richer system metrics

Linux UI stack:

• GTK4 + PyGObject
• xdg-utils

Windows UI stack:

• PySide6 (Qt)

Install dependencies by distro

Arch Linux / Nyarch

sudo pacman -S --needed python python-gobject gtk4 xdg-utils python-psutil

Debian / Ubuntu

sudo apt update
sudo apt install -y python3 python3-gi gir1.2-gtk-4.0 xdg-utils python3-psutil

Fedora

sudo dnf install -y python3 python3-gobject gtk4 xdg-utils python3-psutil

Run from source

Linux

cd /home/'your username'/Documents/mini-os-helper
python3 main.py

Windows

cd C:\Users\your-username\Documents\mini-os-helper
py -m pip install PySide6 psutil
py main.py

Build AppImage

Build requirements

python3 -m pip install --user pyinstaller

Install appimagetool in PATH, or place one of these files in ./tools/:

• appimagetool.AppImage
• appimagetool-x86_64.AppImage

Build command

cd /home/'your username'/Documents/mini-os-helper
chmod +x build-appimage.sh
./build-appimage.sh

The script outputs an .AppImage file in the project root.

Build Windows (PyInstaller)

cd C:\Users\your-username\Documents\mini-os-helper
build-windows.bat

The executable is emitted to dist\MiniOSHelper\.