Skip to content
x-eon-maxPublic

About

Yet Another Arch Linux Update Script (YAALUS)

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

24 Commits

Folders and files

Repository files navigation

YAALUS Logo

YAALUS (Yet Another Arch Linux Update Suite)

The complete, intelligent update, maintenance, and health monitoring suite for Arch Linux.

License: MIT Arch Linux Python 3.10+ PyQt6 Tests

Features • Installation • GUI Overview • CLI Usage • Systemd Automation • Architecture


🌟 Overview

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, paccache rotation, systemd journal vacuuming, and reflector mirror ranking.
  • Kernel Drift Detection: Compares running kernel against /usr/lib/modules to immediately alert if a reboot is necessary.

🚀 Key Features

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.

💻 Graphical User Interface

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) ]  |
+---------------------------------------------------------------------------------+

GUI Highlights

  • 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.

📦 Installation

1. Clone Repository

git clone https://github.com/x-eon-max/YAALUS.git
cd YAALUS

2. Optional: Install GUI Dependencies

YAALUS 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.txt

Recommended companion utilities (detected automatically if installed):

sudo pacman -S pacman-contrib reflector flatpak
# Optional AUR helper: yay or paru

3. Install Desktop Launcher & System Menu

To add YAALUS to your application menu (KDE Plasma, GNOME, XFCE, Waybar/Rofi/Wofi):

./scripts/install_desktop.sh

⚡ CLI & TUI Usage

YAALUS 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

Command Flags

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

🔔 Background Checker & Notifications

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.timer

🏗️ Architecture

YAALUS/
├── 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

🧪 Testing

YAALUS has full headless test coverage for both core routines and PyQt6 GUI components:

python3 -m unittest discover tests

📄 License

Distributed under the MIT License. See LICENSE for details.

Developed with ❤️ for the Arch Linux Community by X-EON.

About

Yet Another Arch Linux Update Script (YAALUS)

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages