Skip to content
Back to search

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jesusdelira7-956--softwareupdatemanager-linux/badge.svg)](/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

i

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
  1. <div align="center">
  2. <img src="assets/circle_logo_large.png" alt="Software Update Manager β€” Jesse In The Lab" width="140" />
  3. # πŸ›‘οΈ Universal Linux Software Update Manager & Intrusion Shield (v1.1.0)
  4. **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**
  5. [![Buy Me A Coffee](https://img.shields.io/badge/β˜•_Buy_Me_A_Coffee-Support_Development-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/JesseInTheLab)
  6. [![1-Click Linux Install](https://img.shields.io/badge/⚑_1--Click_Install-install.sh-E95420?style=for-the-badge&logo=linux&logoColor=white)](#-easy-installation-options-choose-what-works-best-for-you)
  7. [![Windows Edition](https://img.shields.io/badge/πŸͺŸ_Windows_10/11_Edition-Also_Available-0078D6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/jesusdelira7-956/SoftwareUpdateManager)
  8. [![GitHub Release](https://img.shields.io/github/v/release/jesusdelira7-956/SoftwareUpdateManager-Linux?style=flat-square&label=Latest%20Release&color=brightgreen)](https://github.com/jesusdelira7-956/SoftwareUpdateManager-Linux/releases/latest)
  9. [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0%20(100%25%20Python%20Stdlib)-success?style=flat-square)](requirements.txt)
  10. [![CI Validation](https://img.shields.io/github/actions/workflow/status/jesusdelira7-956/SoftwareUpdateManager-Linux/ci-validate.yml?style=flat-square&label=CI%20Validation)](https://github.com/jesusdelira7-956/SoftwareUpdateManager-Linux/actions)
  11. [![Distros: Zorin | Ubuntu | Debian | Fedora | Arch | openSUSE](https://img.shields.io/badge/Distros-Zorin%20%7C%20Ubuntu%20%7C%20Debian%20%7C%20Fedora%20%7C%20Arch%20%7C%20openSUSE-E95420?style=flat-square&logo=linux)](https://zorin.com)
  12. [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
  13. <br/>
  14. <img src="assets/screenshot_dashboard.png" alt="Universal Linux Software Update Manager & Intrusion Shield Dashboard" width="880" />
  15. </div>
  16. ---
  17. 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**.
  18. > [!NOTE]
  19. > **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!
  20. ---
  21. ## 🐧 Supported Linux Distributions & Environments
  22. | Distro Family | Examples | Native Package Engine | Firewall Shield | Rollback |
  23. | :--- | :--- | :---: | :---: | :---: |
  24. | **Debian / Ubuntu** | Zorin OS, Ubuntu, Debian, Mint, Pop!_OS, Kali | `apt` (with lock waiter) | `ufw` | Timeshift |
  25. | **Fedora / RHEL** | Fedora, Nobara, Rocky, AlmaLinux, CentOS | `dnf` / `dnf5` | `firewalld` | Timeshift / Snapper |
  26. | **Arch-based** | Arch Linux, Manjaro, EndeavourOS, CachyOS | `pacman` (safe `-Syu` sync) | `ufw` / `firewalld` | Timeshift / Snapper |
  27. | **openSUSE** | Tumbleweed (`dup`), Leap (`up`) | `zypper` | `firewalld` | Snapper |
  28. | **Universal Formats** | Any Linux Distro (GNOME, KDE, XFCE, Hyprland, SSH) | Flatpak, Snap, Dev SDKs, AppImages | `ss` / `/proc/net/tcp` | Auto-detected |
  29. ---
  30. ## ⚑ Why Software Update Manager Instead of Raw `apt upgrade`?
  31. | Capability | Raw `apt upgrade` / `flatpak update` | πŸ›‘οΈ Software Update Manager (Linux v1.0.0) |
  32. | :--- | :---: | :---: |
  33. | **Unified Ecosystem** | ❌ Fragmented commands (`apt`, `flatpak`, `snap`, SDKs, AppImages) | **Single Unified Dashboard & CLI** covering all 5 software formats |
  34. | **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) |
  35. | **AppImage & Standalone Updates** | ❌ Manual re-downloading | **Smart Bandwidth Caching Engine** (ETag, HTTP Redirect, GitHub Release Tag & Build-ID caching) |
  36. | **System Rollback Safety** | ❌ None | **1-Click Pre-Update Snapshot** via native **Timeshift** or **Snapper** |
  37. | **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) |
  38. | **AI Assistant Integration** | ❌ None | **4-Tier Permission Gatekeeper + Zero-Port Stdio MCP Server** (Claude Desktop, Antigravity, Cursor, Copilot) |
  39. | **Multi-Drive & Portable Storage** | ❌ Root paths only | **Interactive Secondary Storage Wizard** (Scans NVMe, secondary SSDs, `/media`, and custom folders) |
  40. | **Least-Privilege Security** | ⚠️ Runs entire processes under `sudo` | **Privilege Split**: UI runs unprivileged; elevates *only* individual update actions via `pkexec`/`sudo` |
  41. | **Runtime Dependencies** | Various | **Zero `pip` packages** (100% Python Standard Library + built-in Tkinter) |
  42. ---
  43. ## β˜• Support the Project
  44. If this tool saves you time maintaining and securing your Linux and Zorin PCs, consider supporting future development:
  45. [![Buy Me A Coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=β˜•&slug=JesseInTheLab&button_colour=FFDD00&font_colour=000000&font_family=Inter&outline_colour=000000&coffee_colour=ffffff)](https://buymeacoffee.com/JesseInTheLab)
  46. πŸ‘‰ **[buymeacoffee.com/JesseInTheLab](https://buymeacoffee.com/JesseInTheLab)**
  47. ---
  48. ## πŸš€ Easy Installation Options (Choose What Works Best For You)
  49. ### πŸ₯‡ Option 1: 1-Click Desktop Installer (`install.sh`)
  50. > **Best for desktop users wanting a launcher in the Zorin / GNOME App Menu and Desktop icon.**
  51. Clone the repository and run the installer:
  52. ```bash
  53. git clone https://github.com/jesusdelira7-956/SoftwareUpdateManager-Linux.git
  54. cd SoftwareUpdateManager-Linux
  55. chmod +x install.sh
  56. ./install.sh
  57. ```
  58. #### What `install.sh` does automatically:
  59. - Checks if `python3` and `python3-tk` are available (prompts to install `python3-tk` if GUI mode is desired).
  60. - Installs an application launcher (`software-update-manager.desktop`) into `~/.local/share/applications/`.
  61. - Places a launcher icon directly onto your **Desktop**.
  62. - Creates a user symlink in `~/.local/bin/software-update-manager` for fast terminal access (`software-update-manager --cli`).
  63. ---
  64. ### πŸ₯ˆ Option 2: Portable / Zero-Install Run
  65. > **Best for instant use or running from a secondary SSD / USB drive. Requires NO system installation!**
  66. ```bash
  67. # Choose GUI or CLI mode interactively:
  68. python3 update_manager.py
  69. # Launch Desktop GUI directly:
  70. python3 update_manager.py --gui
  71. # Launch Interactive CLI directly:
  72. python3 update_manager.py --cli
  73. ```
  74. ---
  75. ### πŸ₯‰ Option 3: Headless & Automation Flags (Cron / CI / Scripts)
  76. > **Best for headless servers, SSH sessions, or unattended maintenance.**
  77. ```bash
  78. # Quick exit-code check (0 = up to date, 100 = updates available):
  79. python3 update_manager.py --check
  80. # Unattended sequential upgrade of all trusted packages:
  81. python3 update_manager.py --upgrade-all --yes
  82. # Network Intrusion audit of exposed 0.0.0.0 listening ports:
  83. python3 update_manager.py --audit-network
  84. # Export detailed computer specs & storage audit:
  85. python3 update_manager.py --specs
  86. ```
  87. ---
  88. ### πŸ€– Option 4: Zero-Port Stdio MCP Server (AI Agent Integration)
  89. > **Best for connecting to Claude Desktop, Antigravity IDE, Cursor, or Microsoft Copilot.**
  90. ```bash
  91. python3 update_manager.py --mcp
  92. ```
  93. Add this snippet to your AI client's MCP configuration (`claude_desktop_config.json` or `mcp_config.json`):
  94. ```json
  95. {
  96. "mcpServers": {
  97. "linux-software-update-manager": {
  98. "command": "python3",
  99. "args": ["/path/to/SoftwareUpdateManager-Linux/update_manager.py", "--mcp"]
  100. }
  101. }
  102. }
  103. ```
  104. ---
  105. ## ✨ Key Features
  106. - **🎨 Dual-Mode Interface (Desktop GUI & Interactive CLI)**:
  107. - **Tkinter Visual Dashboard**: Sleek Zorin dark-mode design with KPI cards, live log stream, multi-drive selector, and responsive layout.
  108. - **Interactive Terminal Menu**: ANSI-colorized CLI with formatted tables, progress feedback, and keyboard shortcuts.
  109. - **Automated Fallback**: Gracefully detects headless SSH sessions or missing GUI libraries and switches to CLI automatically.
  110. - **πŸ›‘οΈ Zero-Dependency Network Boundary Sentinel & Intrusion Shield (`core/network_auditor.py`)**:
  111. - 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`).
  112. - **Exposure Classification**: Identifies whether ports are safely isolated to `127.0.0.1` (Localhost) or dangerously open on `0.0.0.0` / `::` (LAN-exposed).
  113. - **1-Click UFW Firewall Hardener**: Blocks external incoming probes on developer ports while preserving localhost traffic.
  114. - **πŸ“¦ Multi-Format Sequential Package Engine (`core/package_engine.py`)**:
  115. - **APT Engine**: Updates Debian/Ubuntu repositories sequentially with automatic `/var/lib/dpkg/lock-frontend` polling.
  116. - **Flatpak & Snap Engines**: Audits user and system-level runtimes and sandboxed applications.
  117. - **Developer SDKs**: Tracks and updates `rustup`, `uv`, `bun`, `pnpm`, and `flutter` using native CLI calls and remote semver comparison.
  118. - **⚑ Smart Bandwidth Caching AppImage Engine (`core/appimage_engine.py`)**:
  119. - Tracks standalone AppImages (Obsidian, Joplin, LM Studio, AnythingLLM, Telegram, balenaEtcher, and Docker Desktop).
  120. - 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.
  121. - **πŸ›‘οΈ Pre-Update Security & Trust Gate (`core/security_auditor.py`)**:
  122. - Validates SHA-256 binary checksums before executing downloaded installers.
  123. - Cross-references package names against `pup_blocklist.json` to block adware, bundleware, and untrusted repositories.
  124. - Sanitizes package metadata and terminal arguments against Indirect Prompt Injection (IPI).
  125. - **πŸ’Ύ 1-Click System Rollback Snapshots (`core/rollback_manager.py`)**:
  126. - Automatically detects **Timeshift** or **Snapper** and creates a safety snapshot before any batch updates are applied.
  127. - **πŸ’» Hardware Specs & Secondary Storage Wizard (`core/specs_collector.py` & `core/config_manager.py`)**:
  128. - Scans CPU, GPU, RAM, Kernel version, OS build, and storage drives without external libraries.
  129. - Interactive setup wizard scans `/proc/mounts` to detect secondary NVMe, SSD, or portable drives and ask if apps are stored in custom locations.
  130. - **πŸ€– 4-Tier AI Agent Permission Model & Universal Diagnostic Bridge (`agent_bridge.py`)**:
  131. - **Universal Diagnostic Bundle**: Generates an injection-hardened system summary for 1-click clipboard pasting into web AI assistants.
  132. - **Zero-Port Stdio MCP Server**: Communicates via `sys.stdin`/`sys.stdout` JSON-RPC. **Zero listening TCP ports** β€” immune to remote network scans.
  133. ---
  134. ## πŸ“‚ Repository Structure
  135. ```text
  136. SoftwareUpdateManager-Linux/
  137. β”œβ”€β”€ .github/
  138. β”‚ β”œβ”€β”€ ISSUE_TEMPLATE/
  139. β”‚ β”‚ β”œβ”€β”€ bug_report.md # Structured Linux bug reporting form
  140. β”‚ β”‚ └── feature_request.md # Architectural feature proposal form
  141. β”‚ β”œβ”€β”€ workflows/
  142. β”‚ β”‚ └── ci-validate.yml # GitHub Actions zero-dependency validation workflow
  143. β”‚ β”œβ”€β”€ FUNDING.yml # Native GitHub "Sponsor" button config
  144. β”‚ └── pull_request_template.md # PR quality & testing checklist
  145. β”œβ”€β”€ assets/ # Application icons, emblems, and visual banners
  146. β”‚ β”œβ”€β”€ circle_logo.png # Standard circular emblem
  147. β”‚ β”œβ”€β”€ circle_logo_large.png # High-resolution branding emblem
  148. β”‚ β”œβ”€β”€ app_icon.png # Desktop application icon
  149. β”‚ └── banner_bg.png # Dark-mode dashboard header background
  150. β”œβ”€β”€ config/
  151. β”‚ β”œβ”€β”€ providers.json # Declarative standalone AppImage and binary feeds
  152. β”‚ └── pup_blocklist.json # Known PUP, adware, and high-risk definitions
  153. β”œβ”€β”€ core/
  154. β”‚ β”œβ”€β”€ ai_launcher.py # Web AI shortcuts & local desktop AI detection
  155. β”‚ β”œβ”€β”€ appimage_engine.py # Smart bandwidth-caching AppImage update engine
  156. β”‚ β”œβ”€β”€ config_manager.py # Dynamic secondary storage wizard & XDG config
  157. β”‚ β”œβ”€β”€ network_auditor.py # Network Boundary Sentinel & 0.0.0.0 socket auditor
  158. β”‚ β”œβ”€β”€ package_engine.py # APT, Flatpak, Snap, and Dev SDK update handlers
  159. β”‚ β”œβ”€β”€ privilege_helper.py # Least-privilege pkexec/sudo elevation & tk installer
  160. β”‚ β”œβ”€β”€ rollback_manager.py # Timeshift and Snapper 1-click snapshot integration
  161. β”‚ β”œβ”€β”€ security_auditor.py # Pre-Update Security Trust Gate & IPI sanitizer
  162. β”‚ └── specs_collector.py # Hardware specifications & storage inventory
  163. β”œβ”€β”€ ui/
  164. β”‚ β”œβ”€β”€ cli_app.py # ANSI-colorized interactive terminal interface
  165. β”‚ └── gui_app.py # Zorin dark-mode Tkinter visual dashboard
  166. β”œβ”€β”€ agent_bridge.py # Zero-port 4-Tier Stdio MCP Server & AI diagnostic bridge
  167. β”œβ”€β”€ update_manager.py # Unified entrypoint (CLI, GUI, Headless, MCP)
  168. β”œβ”€β”€ install.sh # 1-click Desktop & CLI symlink installer
  169. β”œβ”€β”€ AGENT_SAFETY.md # AI Agent integration, least privilege & safety rules
  170. β”œβ”€β”€ CHANGELOG.md # Release history & version ledger
  171. β”œβ”€β”€ CODE_OF_CONDUCT.md # Community standards & behavioral pledge
  172. β”œβ”€β”€ CONTRIBUTING.md # Contributor guide & zero-pip architecture rules
  173. β”œβ”€β”€ HELP_AND_USER_GUIDE.md # Comprehensive user manual & troubleshooting
  174. β”œβ”€β”€ SECURITY.md # Vulnerability reporting & supported versions policy
  175. β”œβ”€β”€ requirements.txt # Zero external dependencies (100% Python Stdlib)
  176. β”œβ”€β”€ LICENSE # MIT License
  177. └── README.md # Documentation & Quick Start Guide
  178. ```
  179. ---
  180. ## πŸ“œ License & Privacy Notice
  181. Released under the [MIT License](LICENSE). Free to use, modify, and share across personal and enterprise computers.
  182. > **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 in

Free to use. If it’s helped, pass it on.