The complete, intelligent update, maintenance, and health monitoring suite for Arch Linux.
Features • Installation • GUI Overview • CLI Usage • Systemd Automation • Architecture
YAALUS v2.0 evolves from a lightweight shell script into a comprehensive, multi-tiered Arch Linux management suite. Built specifically for Arch Linux power users and newcomers alike, YAALUS provides:
- PyQt6 Modern Desktop GUI: An Arch-inspired dark interface with system health metrics, searchable update matrices, and real-time streaming terminal.
- Terminal CLI & Interactive TUI: One-liner flags and interactive shell workflow for headless systems, SSH, or terminal lovers.
- Pure Bash Fallback Engine: Zero hard dependencies required to perform safe upgrades on bare-metal recovery sessions.
- Proactive Arch News Alerts: Direct RSS feed integration warning you about upstream manual interventions before running
pacman -Syu. - Deep System Hygiene: Orphaned package purging,
paccacherotation, systemd journal vacuuming, andreflectormirror ranking. - Kernel Drift Detection: Compares running kernel against
/usr/lib/modulesto immediately alert if a reboot is necessary.
| Category | Capability | Description |
|---|---|---|
| Package Management | Multi-Repo Orchestration | Synchronous checking and updating across Official Repos (pacman), AUR (yay / paru), and Flatpak. |
| Safety First | Arch News Integration | Live fetch of archlinux.org/feeds/news/ flagging updates requiring manual intervention. |
| System Health | Metrics Dashboard | Real-time monitoring of disk cache size, journal size, orphan count, and failed systemd units. |
| Maintenance | System Cleaner | One-click or automated vacuuming of /var/cache/pacman/pkg, removal of unused packages (pacman -Qtdq), and journal compression. |
| Network Optimization | Mirror Ranking | Seamless reflector execution to benchmark and sort the fastest HTTPS mirrors by country. |
| Snapshot Hook | Pre-upgrade Safety | Detects and triggers Timeshift or Snapper system snapshots prior to running large updates. |
| Kernel Monitoring | Reboot Advisor | Identifies when an active kernel update causes module mismatch with the running system. |
YAALUS includes a native PyQt6 interface themed with an Arch Obsidian & Cyan visual palette (#0b0f15 / #1793d1).
+---------------------------------------------------------------------------------+
| YAALUS - Yet Another Arch Linux Update Suite [ - + X ]|
+---------------------------------------------------------------------------------+
| [ Dashboard ] [ System Maintenance ] [ Arch News ] [ Process Logs ] |
+---------------------------------------------------------------------------------+
| System Metrics |
| +----------------+ +----------------+ +----------------+ +----------------+ |
| | Pending: 31 | | Cache: 2.1 GB | | Orphans: 19 | | Failed Units: 0| |
| +----------------+ +----------------+ +----------------+ +----------------+ |
| |
| Pending Updates Filter: [ search package... ] |
| +------------------------+------------------+------------------+-------------+|
| | Package Name | Current Version | New Version | Repository ||
| +------------------------+------------------+------------------+-------------+|
| | linux | 6.11.2.arch1-1 | 6.11.3.arch1-1 | core ||
| | kwin | 6.8.1-1.1 | 6.8.1-2.1 | extra ||
| | visual-studio-code-bin | 1.95.0-1 | 1.95.1-1 | AUR ||
| +------------------------+------------------+------------------+-------------+|
| |
| [ Check Updates ] [ Upgrade Official & AUR ] [ Upgrade All (Inc. Flatpak) ] |
+---------------------------------------------------------------------------------+
- Dashboard: Live updates table with quick search filter, repository color-coded badges, and one-click upgrades.
- Maintenance Tab: Dedicated controls to prune orphaned packages, clean package cache, compress system logs, and rank mirrors.
- Arch News Tab: Clean feed cards showing title, publish date, summary, and direct links to archlinux.org.
- Process Logs Tab: Integrated ANSI terminal showing streaming sub-process logs (
pacman,yay,reflector) in real time.
git clone https://github.com/x-eon-max/YAALUS.git
cd YAALUSYAALUS CLI and Bash fallback work out of the box with standard Arch packages. To enable the PyQt6 interface:
# Using pacman (Recommended on Arch)
sudo pacman -S python-pyqt6
# Or using pip
pip install -r requirements.txtRecommended companion utilities (detected automatically if installed):
sudo pacman -S pacman-contrib reflector flatpak
# Optional AUR helper: yay or paruTo add YAALUS to your application menu (KDE Plasma, GNOME, XFCE, Waybar/Rofi/Wofi):
./scripts/install_desktop.shYAALUS can be run directly from terminal or integrated into automated scripts:
# Launch modern PyQt6 GUI (default if desktop is active)
./bin/yaalus --gui
# Launch terminal interactive TUI menu
./bin/yaalus --cli
# Quick update scan
./bin/yaalus --check
# Full unattended system upgrade (Pacman + AUR + Flatpak)
./bin/yaalus --upgrade --unattended
# Deep system maintenance (Cache pruning + Orphan removal + Journal vacuum)
./bin/yaalus --clean
# Fetch latest Arch Linux News
./bin/yaalus --news
# Benchmark and update mirrorlist with Reflector
./bin/yaalus --mirrors
# Check if reboot is recommended
./bin/yaalus --reboot-check| Flag | Description |
|---|---|
--gui |
Launch Graphical User Interface |
--cli |
Launch Interactive Terminal Menu |
-c, --check |
Scan for pending official, AUR, and Flatpak updates |
-u, --upgrade |
Run system-wide upgrade |
--clean |
Prune package caches, orphans, and systemd journals |
--mirrors |
Rank top 20 HTTPS mirrors via reflector |
--news |
Display latest critical Arch Linux news items |
--reboot-check |
Verify whether installed kernel matches active running kernel |
-y, --unattended |
Execute commands without interactive prompts |
YAALUS includes pre-configured systemd user timer units for automated update notifications via notify-send:
# Copy units to user systemd directory
mkdir -p ~/.config/systemd/user/
cp systemd/yaalus-check.service ~/.config/systemd/user/
cp systemd/yaalus-check.timer ~/.config/systemd/user/
# Enable and start the background check timer (runs every 3 hours)
systemctl --user daemon-reload
systemctl --user enable --now yaalus-check.timerYAALUS/
├── bin/
│ └── yaalus # Convenient binary symlink / execution wrapper
├── yaalus/
│ ├── __init__.py # Package version & metadata
│ ├── __main__.py # CLI / TUI / GUI entrypoint dispatcher
│ ├── core/
│ │ ├── checker.py # Update checking (pacman, AUR, flatpak, health)
│ │ ├── models.py # Data structures (PackageUpdate, SystemHealth, etc.)
│ │ ├── news.py # Live Arch RSS feed parser
│ │ └── updater.py # Safe update & maintenance execution builder
│ ├── ui/
│ │ ├── main_window.py # Main PyQt6 Application Window & worker threads
│ │ ├── theme.py # Dark Arch QSS stylesheet & icon loader
│ │ └── tabs/
│ │ ├── dashboard_tab.py # Overview, update list, quick triggers
│ │ ├── maintenance_tab.py # Cleaner, orphans, mirrors, snapshots
│ │ ├── news_tab.py # Arch Linux news viewer
│ │ └── log_tab.py # Real-time process log output viewer
│ └── resources/
│ └── yaalus.svg # Scalable application icon
├── scripts/
│ └── install_desktop.sh # Installs desktop entry and system icons
├── systemd/
│ ├── yaalus-check.service # Desktop notification check service
│ └── yaalus-check.timer # Scheduled timer (boots + 3h interval)
├── tests/
│ ├── test_checker.py # Core engine unit tests
│ └── test_gui.py # Headless PyQt6 GUI test harness
├── yaalus.sh # Universal shell entrypoint with fallback
├── YAALUS.sh # Backward compatibility script
├── requirements.txt # PyQt6 dependency specification
└── LICENSE # MIT License
YAALUS has full headless test coverage for both core routines and PyQt6 GUI components:
python3 -m unittest discover testsDistributed under the MIT License. See LICENSE for details.
Developed with ❤️ for the Arch Linux Community by X-EON.