Mini OS Helper

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

• 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

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

Linux UI stack:

• PySide6 (Qt)
• xdg-utils

sudo pacman -S --needed python python-pyside6 xdg-utils python-psutil

sudo apt update
sudo apt install -y python3 python3-pyside6 xdg-utils python3-psutil

sudo dnf install -y python3 python3-pyside6 xdg-utils python3-psutil

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

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

python3 -m pip install --user pyinstaller

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

• appimagetool.AppImage
• appimagetool-x86_64.AppImage

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.

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

The executable is emitted to dist\MiniOSHelper\.