SoftwareUpdateManager-Linux
Universal zero-dependency Linux Software Updater (APT, DNF, Pacman, Zypper, Flatpak, Snap, AppImage), UFW/firewalld LAN Intrusion Shield & 4-Tier Stdio MCP AI Bridge (100% Python Stdlib)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jesusdelira7-956--softwareupdatemanager-linux)HTML
<a href="/listings/jesusdelira7-956--softwareupdatemanager-linux"><img src="/api/listings/jesusdelira7-956--softwareupdatemanager-linux/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
π₯ Option 1: 1-Click Desktop Installer (`install.sh`)
> **Best for desktop users wanting a launcher in the Zorin / GNOME App Menu and Desktop icon.**
Clone the repository and run the installer:
git clone https://github.com/jesusdelira7-956/SoftwareUpdateManager-Linux.git cd SoftwareUpdateManager-Linux chmod +x install.sh ./install.sh
What `install.sh` does automatically:
- Checks if `python3` and `python3-tk` are available (prompts to install `python3-tk` if GUI mode is desired). - Installs an application launcher (`software-update-manager.desktop`) into `~/.local/share/applications/`. - Places a launcher icon directly onto your **Desktop**. - Creates a user symlink in `~/.local/bin/software-update-manager` for fast terminal access (`software-update-manager --cli`).
---
π₯ Option 2: Portable / Zero-Install Run
> **Best for instant use or running from a secondary SSD / USB drive. Requires NO system installation!**
# Choose GUI or CLI mode interactively: python3 update_manager.py # Launch Desktop GUI directly: python3 update_manager.py --gui # Launch Interactive CLI directly: python3 update_manager.py --cli
---
π₯ Option 3: Headless & Automation Flags (Cron / CI / Scripts)
> **Best for headless servers, SSH sessions, or unattended maintenance.**
# Quick exit-code check (0 = up to date, 100 = updates available): python3 update_manager.py --check # Unattended sequential upgrade of all trusted packages: python3 update_manager.py --upgrade-all --yes # Network Intrusion audit of exposed 0.0.0.0 listening ports: python3 update_manager.py --audit-network # Export detailed computer specs & storage audit: python3 update_manager.py --specs
---
π€ Option 4: Zero-Port Stdio MCP Server (AI Agent Integration)
> **Best for connecting to Claude Desktop, Antigravity IDE, Cursor, or Microsoft Copilot.**
python3 update_manager.py --mcp
Add this snippet to your AI client's MCP configuration (`claude_desktop_config.json` or `mcp_config.json`):
{
"mcpServers": {
"linux-software-update-manager": {
"command": "python3",
"args": ["/path/to/SoftwareUpdateManager-Linux/update_manager.py", "--mcp"]
}
}
}---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 234 lines
- <div align="center">
- <img src="assets/circle_logo_large.png" alt="Software Update Manager β Jesse In The Lab" width="140" />
- # π‘οΈ Universal Linux Software Update Manager & Intrusion Shield (v1.1.0)
- **Universal Multi-Distro Updates (APT β’ DNF β’ Pacman β’ Zypper β’ Flatpak β’ Snap β’ AppImage) β’ `0.0.0.0` LAN Intrusion Shield (UFW & firewalld) β’ Zero-Port 4-Tier AI MCP Bridge**
- [](https://buymeacoffee.com/JesseInTheLab)
- [](#-easy-installation-options-choose-what-works-best-for-you)
- [](https://github.com/jesusdelira7-956/SoftwareUpdateManager)
- [](https://github.com/jesusdelira7-956/SoftwareUpdateManager-Linux/releases/latest)
- [-success?style=flat-square)](requirements.txt)
- [](https://github.com/jesusdelira7-956/SoftwareUpdateManager-Linux/actions)
- [](https://zorin.com)
- [](LICENSE)
- <br/>
- <img src="assets/screenshot_dashboard.png" alt="Universal Linux Software Update Manager & Intrusion Shield Dashboard" width="880" />
- </div>
- ---
- A portable, universal desktop application and CLI for **all major Linux distributions β Zorin OS, Ubuntu, Debian, Linux Mint, Pop!_OS, Fedora, RHEL, Nobara, Arch Linux, Manjaro, EndeavourOS, and openSUSE (Tumbleweed & Leap)** β built with **100% Python Standard Library (zero third-party `pip` runtime dependencies)**. It audits hardware specifications, scans installed software across **APT, DNF/DNF5, Pacman, Zypper, Flatpak, Snap, Dev SDKs, and AppImages**, updates packages safely, enforces a **Pre-Update Security & Trust Gate**, defends against LAN probes with **UFW & `firewalld`** auto-detection, and connects safely to AI assistants via a **4-Tier Local Agent Permission Model & Zero-Port Stdio MCP Server**.
- > [!NOTE]
- > **What's New in v1.1.0 (Universal Linux Release):** Full native support for **Fedora/RHEL (`dnf`/`dnf5`)**, **Arch/Manjaro (`pacman` with safe full-sync guard)**, **openSUSE (`zypper`)**, **`firewalld`** 1-click port blocking alongside `ufw`, **KDE Plasma (`kdialog`) + GNOME (`zenity`)** prompts, **`doas`/`run0`** elevation fallbacks, and portable terminal detection across all desktop environments!
- ---
- ## π§ Supported Linux Distributions & Environments
- | Distro Family | Examples | Native Package Engine | Firewall Shield | Rollback |
- | :--- | :--- | :---: | :---: | :---: |
- | **Debian / Ubuntu** | Zorin OS, Ubuntu, Debian, Mint, Pop!_OS, Kali | `apt` (with lock waiter) | `ufw` | Timeshift |
- | **Fedora / RHEL** | Fedora, Nobara, Rocky, AlmaLinux, CentOS | `dnf` / `dnf5` | `firewalld` | Timeshift / Snapper |
- | **Arch-based** | Arch Linux, Manjaro, EndeavourOS, CachyOS | `pacman` (safe `-Syu` sync) | `ufw` / `firewalld` | Timeshift / Snapper |
- | **openSUSE** | Tumbleweed (`dup`), Leap (`up`) | `zypper` | `firewalld` | Snapper |
- | **Universal Formats** | Any Linux Distro (GNOME, KDE, XFCE, Hyprland, SSH) | Flatpak, Snap, Dev SDKs, AppImages | `ss` / `/proc/net/tcp` | Auto-detected |
- ---
- ## β‘ Why Software Update Manager Instead of Raw `apt upgrade`?
- | Capability | Raw `apt upgrade` / `flatpak update` | π‘οΈ Software Update Manager (Linux v1.0.0) |
- | :--- | :---: | :---: |
- | **Unified Ecosystem** | β Fragmented commands (`apt`, `flatpak`, `snap`, SDKs, AppImages) | **Single Unified Dashboard & CLI** covering all 5 software formats |
- | **APT Mutex Lock Collisions** | β Fails with `Could not get lock /var/lib/dpkg/lock-frontend` | **Auto Lock Waiter** (polls and waits gracefully until background updater finishes) |
- | **AppImage & Standalone Updates** | β Manual re-downloading | **Smart Bandwidth Caching Engine** (ETag, HTTP Redirect, GitHub Release Tag & Build-ID caching) |
- | **System Rollback Safety** | β None | **1-Click Pre-Update Snapshot** via native **Timeshift** or **Snapper** |
- | **Local AI & Dev Port Security** | β None | **Network Boundary Sentinel** (Flags `0.0.0.0` LAN exposure on Ollama/LM Studio/WebUI + 1-Click UFW Hardener) |
- | **AI Assistant Integration** | β None | **4-Tier Permission Gatekeeper + Zero-Port Stdio MCP Server** (Claude Desktop, Antigravity, Cursor, Copilot) |
- | **Multi-Drive & Portable Storage** | β Root paths only | **Interactive Secondary Storage Wizard** (Scans NVMe, secondary SSDs, `/media`, and custom folders) |
- | **Least-Privilege Security** | β οΈ Runs entire processes under `sudo` | **Privilege Split**: UI runs unprivileged; elevates *only* individual update actions via `pkexec`/`sudo` |
- | **Runtime Dependencies** | Various | **Zero `pip` packages** (100% Python Standard Library + built-in Tkinter) |
- ---
- ## β Support the Project
- If this tool saves you time maintaining and securing your Linux and Zorin PCs, consider supporting future development:
- [](https://buymeacoffee.com/JesseInTheLab)
- π **[buymeacoffee.com/JesseInTheLab](https://buymeacoffee.com/JesseInTheLab)**
- ---
- ## π Easy Installation Options (Choose What Works Best For You)
- ### π₯ Option 1: 1-Click Desktop Installer (`install.sh`)
- > **Best for desktop users wanting a launcher in the Zorin / GNOME App Menu and Desktop icon.**
- Clone the repository and run the installer:
- ```bash
- git clone https://github.com/jesusdelira7-956/SoftwareUpdateManager-Linux.git
- cd SoftwareUpdateManager-Linux
- chmod +x install.sh
- ./install.sh
- ```
- #### What `install.sh` does automatically:
- - Checks if `python3` and `python3-tk` are available (prompts to install `python3-tk` if GUI mode is desired).
- - Installs an application launcher (`software-update-manager.desktop`) into `~/.local/share/applications/`.
- - Places a launcher icon directly onto your **Desktop**.
- - Creates a user symlink in `~/.local/bin/software-update-manager` for fast terminal access (`software-update-manager --cli`).
- ---
- ### π₯ Option 2: Portable / Zero-Install Run
- > **Best for instant use or running from a secondary SSD / USB drive. Requires NO system installation!**
- ```bash
- # Choose GUI or CLI mode interactively:
- python3 update_manager.py
- # Launch Desktop GUI directly:
- python3 update_manager.py --gui
- # Launch Interactive CLI directly:
- python3 update_manager.py --cli
- ```
- ---
- ### π₯ Option 3: Headless & Automation Flags (Cron / CI / Scripts)
- > **Best for headless servers, SSH sessions, or unattended maintenance.**
- ```bash
- # Quick exit-code check (0 = up to date, 100 = updates available):
- python3 update_manager.py --check
- # Unattended sequential upgrade of all trusted packages:
- python3 update_manager.py --upgrade-all --yes
- # Network Intrusion audit of exposed 0.0.0.0 listening ports:
- python3 update_manager.py --audit-network
- # Export detailed computer specs & storage audit:
- python3 update_manager.py --specs
- ```
- ---
- ### π€ Option 4: Zero-Port Stdio MCP Server (AI Agent Integration)
- > **Best for connecting to Claude Desktop, Antigravity IDE, Cursor, or Microsoft Copilot.**
- ```bash
- python3 update_manager.py --mcp
- ```
- Add this snippet to your AI client's MCP configuration (`claude_desktop_config.json` or `mcp_config.json`):
- ```json
- {
- "mcpServers": {
- "linux-software-update-manager": {
- "command": "python3",
- "args": ["/path/to/SoftwareUpdateManager-Linux/update_manager.py", "--mcp"]
- }
- }
- }
- ```
- ---
- ## β¨ Key Features
- - **π¨ Dual-Mode Interface (Desktop GUI & Interactive CLI)**:
- - **Tkinter Visual Dashboard**: Sleek Zorin dark-mode design with KPI cards, live log stream, multi-drive selector, and responsive layout.
- - **Interactive Terminal Menu**: ANSI-colorized CLI with formatted tables, progress feedback, and keyboard shortcuts.
- - **Automated Fallback**: Gracefully detects headless SSH sessions or missing GUI libraries and switches to CLI automatically.
- - **π‘οΈ Zero-Dependency Network Boundary Sentinel & Intrusion Shield (`core/network_auditor.py`)**:
- - Uses native Linux `ss -tlnp` (with `/proc/net/tcp` standard library fallback) to scan active listening ports across local AI engines (Ollama `11434`, LM Studio `1234`, Open WebUI `8081`, ComfyUI `8188`, SwarmUI `7801`, dev ports `3000-9000`).
- - **Exposure Classification**: Identifies whether ports are safely isolated to `127.0.0.1` (Localhost) or dangerously open on `0.0.0.0` / `::` (LAN-exposed).
- - **1-Click UFW Firewall Hardener**: Blocks external incoming probes on developer ports while preserving localhost traffic.
- - **π¦ Multi-Format Sequential Package Engine (`core/package_engine.py`)**:
- - **APT Engine**: Updates Debian/Ubuntu repositories sequentially with automatic `/var/lib/dpkg/lock-frontend` polling.
- - **Flatpak & Snap Engines**: Audits user and system-level runtimes and sandboxed applications.
- - **Developer SDKs**: Tracks and updates `rustup`, `uv`, `bun`, `pnpm`, and `flutter` using native CLI calls and remote semver comparison.
- - **β‘ Smart Bandwidth Caching AppImage Engine (`core/appimage_engine.py`)**:
- - Tracks standalone AppImages (Obsidian, Joplin, LM Studio, AnythingLLM, Telegram, balenaEtcher, and Docker Desktop).
- - Uses **ETag, HTTP 302 Redirect Header, GitHub Release Tag, and Build-ID caching** stored in `~/.config/software-update-manager/cache/` to eliminate redundant gigabytes of downloads.
- - **π‘οΈ Pre-Update Security & Trust Gate (`core/security_auditor.py`)**:
- - Validates SHA-256 binary checksums before executing downloaded installers.
- - Cross-references package names against `pup_blocklist.json` to block adware, bundleware, and untrusted repositories.
- - Sanitizes package metadata and terminal arguments against Indirect Prompt Injection (IPI).
- - **πΎ 1-Click System Rollback Snapshots (`core/rollback_manager.py`)**:
- - Automatically detects **Timeshift** or **Snapper** and creates a safety snapshot before any batch updates are applied.
- - **π» Hardware Specs & Secondary Storage Wizard (`core/specs_collector.py` & `core/config_manager.py`)**:
- - Scans CPU, GPU, RAM, Kernel version, OS build, and storage drives without external libraries.
- - Interactive setup wizard scans `/proc/mounts` to detect secondary NVMe, SSD, or portable drives and ask if apps are stored in custom locations.
- - **π€ 4-Tier AI Agent Permission Model & Universal Diagnostic Bridge (`agent_bridge.py`)**:
- - **Universal Diagnostic Bundle**: Generates an injection-hardened system summary for 1-click clipboard pasting into web AI assistants.
- - **Zero-Port Stdio MCP Server**: Communicates via `sys.stdin`/`sys.stdout` JSON-RPC. **Zero listening TCP ports** β immune to remote network scans.
- ---
- ## π Repository Structure
- ```text
- SoftwareUpdateManager-Linux/
- βββ .github/
- β βββ ISSUE_TEMPLATE/
- β β βββ bug_report.md # Structured Linux bug reporting form
- β β βββ feature_request.md # Architectural feature proposal form
- β βββ workflows/
- β β βββ ci-validate.yml # GitHub Actions zero-dependency validation workflow
- β βββ FUNDING.yml # Native GitHub "Sponsor" button config
- β βββ pull_request_template.md # PR quality & testing checklist
- βββ assets/ # Application icons, emblems, and visual banners
- β βββ circle_logo.png # Standard circular emblem
- β βββ circle_logo_large.png # High-resolution branding emblem
- β βββ app_icon.png # Desktop application icon
- β βββ banner_bg.png # Dark-mode dashboard header background
- βββ config/
- β βββ providers.json # Declarative standalone AppImage and binary feeds
- β βββ pup_blocklist.json # Known PUP, adware, and high-risk definitions
- βββ core/
- β βββ ai_launcher.py # Web AI shortcuts & local desktop AI detection
- β βββ appimage_engine.py # Smart bandwidth-caching AppImage update engine
- β βββ config_manager.py # Dynamic secondary storage wizard & XDG config
- β βββ network_auditor.py # Network Boundary Sentinel & 0.0.0.0 socket auditor
- β βββ package_engine.py # APT, Flatpak, Snap, and Dev SDK update handlers
- β βββ privilege_helper.py # Least-privilege pkexec/sudo elevation & tk installer
- β βββ rollback_manager.py # Timeshift and Snapper 1-click snapshot integration
- β βββ security_auditor.py # Pre-Update Security Trust Gate & IPI sanitizer
- β βββ specs_collector.py # Hardware specifications & storage inventory
- βββ ui/
- β βββ cli_app.py # ANSI-colorized interactive terminal interface
- β βββ gui_app.py # Zorin dark-mode Tkinter visual dashboard
- βββ agent_bridge.py # Zero-port 4-Tier Stdio MCP Server & AI diagnostic bridge
- βββ update_manager.py # Unified entrypoint (CLI, GUI, Headless, MCP)
- βββ install.sh # 1-click Desktop & CLI symlink installer
- βββ AGENT_SAFETY.md # AI Agent integration, least privilege & safety rules
- βββ CHANGELOG.md # Release history & version ledger
- βββ CODE_OF_CONDUCT.md # Community standards & behavioral pledge
- βββ CONTRIBUTING.md # Contributor guide & zero-pip architecture rules
- βββ HELP_AND_USER_GUIDE.md # Comprehensive user manual & troubleshooting
- βββ SECURITY.md # Vulnerability reporting & supported versions policy
- βββ requirements.txt # Zero external dependencies (100% Python Stdlib)
- βββ LICENSE # MIT License
- βββ README.md # Documentation & Quick Start Guide
- ```
- ---
- ## π License & Privacy Notice
- Released under the [MIT License](LICENSE). Free to use, modify, and share across personal and enterprise computers.
- > **Privacy & Anti-Solicitation Notice:** Automated scraping of maintainer contact details, unsolicited third-party "trust index" or badge-farming outreach, and commercial email solicitations regarding this repository are unwelcome. All legitimate inquiries and bug reports belong exclusively in **GitHub Issues**. Please respect developer privacy.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.