Uraam

URAAM 5.1.0 — Optional GTK4 Desktop Integration

URAAM 5.1.0 introduces an optional graphical desktop experience while preserving the complete Bash command-line interface and existing Android management workflows.

This release focuses on Linux desktop integration, usability, and compatibility without compromising the existing CLI or Termux support.

✨ What's New

🖥️ Optional GTK4 Desktop Interface

• Added optional GTK4 GUI installation through the universal Linux installer.
• Users can choose whether to install the graphical interface.
• Added desktop application-menu integration.
• Integrated the official URAAM SVG application icon.
• Added a read-only graphical interface for device information and Android user-0 package inventory.

📦 Debian Integration

• Added support for packaging the optional GUI payload in Debian packages.
• GTK4 dependencies remain optional.
• Systems using only the CLI do not need to install GTK4.

🔒 Safety & Compatibility

• Bash remains the complete interface for package-changing operations.
• The graphical interface is read-only.
• Termux remains CLI-only.
• Existing configurations, backups, and logs are preserved throughout the GUI installation lifecycle.
• Existing CLI workflows remain available.

🧪 Validation

The following CI workflows passed on PR #13:

• URAAM Shell Safety CI

  • Bash syntax validation
  • ShellCheck
  • UAD-NG metadata validation
  • Preview and dry-run regression tests
  • Recovery after abrupt process termination

• URAAM GUI Foundation CI

  • Bash syntax validation
  • ShellCheck
  • Python syntax and GTK4 bindings
  • Debian desktop package layout
  • Read-only JSON API validation

⬆️ Upgrade

Download the latest release from the GitHub Releases page and follow the installation instructions.

Existing configurations, backups, and logs are preserved.

📋 Release Information

• Version: 5.1.0
• Release date: November 12, 2026
• Repository: https://github.com/Ruraam/Uraam
• Changelog: "CHANGELOG.md" (https://github.com/Ruraam/Uraam/blob/main/CHANGELOG.md)

---

URAAM 5.1.0 — Android package management, now with an optional Linux desktop experience.

Uraam

Changelog — URAAM

This project follows a Keep a Changelog-inspired format. Version numbers are added when a release is published.

[Unreleased]

Documentation

• Completely redesigned the main "README.md".
• Added a dedicated documentation index in "Docs/README.md".
• Rewrote the Quick Start Guide with updated installation and connection instructions.
• Added a technical architecture guide covering runtime components, backends and data flow.
• Added a comprehensive Safety and Recovery guide.
• Updated the UAD-NG review catalogue documentation.
• Modernized the Shizuku and Wireless ADB guide.
• Reworked contributor instructions and debloat profile documentation.
• Archived obsolete and device-specific documentation to prevent confusion with current workflows.
• Preserved the legacy safety documentation path as a compatibility redirect.

Security and operational safety

• Documented the manual package-selection workflow.
• Clarified the distinction between UAD-NG risk classifications and actual device safety.
• Documented OEM and ROM detection as informational checks, not removal authorization.
• Documented device identity and package inventory revalidation before destructive operations.
• Documented exclusive locking for concurrent apply protection.
• Documented operation journaling and interrupted-operation recovery.
• Clarified timeout behavior and uncertain command outcomes.
• Documented fail-closed behavior for invalid or incomplete package inventories.
• Clarified that interrupted operations are never automatically replayed.

UAD-NG

• Documented the pinned UAD-NG source revision.
• Added catalogue statistics and classification explanations.
• Clarified the manual-selection policy:
  • Recommended, Advanced and Expert entries may be reviewed manually.
  • Unsafe entries are blocked.
  • Unknown or unlisted entries are blocked.
  • URAAM's built-in safety protections take precedence.
• Documented OEM profile limitations and contribution requirements.

Maintenance

• Updated the documentation structure and internal navigation.
• Reviewed internal Markdown links.
• Updated development and testing instructions.
• No runtime code or user-data paths were intentionally modified in this documentation update.

Validation

• "URAAM shell safety CI": passed.
• "Validate debloat configurations": passed.
• Both workflows completed successfully on the documentation PR commit.
• Documentation changes merged into "main" through PR #9.

Real-device validation remains separate from mocked CI testing.

[Previous versions]

For earlier changes, consult the Git history and published GitHub Releases:

https://github.com/Ruraam/Uraam/releases

https://github.com/Ruraam/Uraam/commits/main

Uraam

Changelog - URAAM v4.4.7

🛡️ Critical Security & Safety Improvements

Added

• Strict Safety Whitelist Engine (SAFETY_WHITELIST):
• Implemented an unbypassable core whitelist protecting mission-critical Android system packages from being frozen, disabled, or uninstalled foruser 0.
• Protects essential system modules against bootloops and runtime bricking:
  *System Framework & UI: android, com.android.systemui, com.android.settings, com.android.keyguard, etc.
• Package & Permission Controllers: com.android.packageinstaller, com.android.permissioncontroller, Google permission layers.
• Telephony & Emergency: com.android.phone, com.android.server.telecom, com.android.emergency, com.android.providers.telephony.
  *Cryptographic & Keyring Stores: com.android.keychain, com.android.certinstaller.
• Google Play Core Services: com.google.android.gms, com.google.android.gsf, com.android.vending.
• Proactive Interception Logic (is_whitelisted):
• Added real-time package checking before invoking any pm disable-user or pm uninstall command.
• Attempted debloat operations targeting whitelisted packages are blocked on the fly and flagged as PROTECTED.
• Execution Metrics Tracking:
• Updated summary stats on debloat tasks: explicitly tracks how many critical packages were preserved by the safetyguard (X protected).

---

⚡ Fixes & Hardening

• Safe Fallthrough: If third-party JSON presets include fundamental system components by accident, execution continues safely without breaking execution loops or bricking the target OS.
• Audit Logging: Every intercepted critical package is tracked directly in debloat execution logs for review.

Uraam

🚀 URAAM Installer v4.4.6 — The Bulletproof Update

A complete overhaul of the installer engine:lighter, smarter, and ready for true cross-platform deployment from bare-metal Debian servers down to rooted Android handhelds.

---

⚡ Highlights & Key Changes

•Zero-Friction Termux Experience 📱

•Added instantTermux: Widget shortcut creation (~/.shortcuts/URAAM). Launch URAAM right from your Android home screen!

•ADB is no longer a mandatory installer dependency: URAAM now natively respects on-device execution modes (Root & Shizuku / rish) without forcing external tools.

•Fail-Safe Self-Updating (bash -n) 🛡️

•Remote scripts are now dynamically syntax-checked before any file replacement. If a network blip or upstream bug corrupts the download, your existing setup remains 100% untouched.

Smarter Package Management 📦

•Full semantic version comparisons powered by dpkg --compare-versions (goodbye alphabetical version bugs).

•Robust privilege escalation: smart fallbacks traversing EUID 0 ➔ sudo➔ properly quoted su -c.

---

🐛 Bug Fixes & Under-The-Hood Polish

•Environment& Pathing: Bulletproof symlink resolution and rock-solid detection between host Linux distributions and Termux sandbox prefixes.

•HardwareTelemetry: Completely overhauled hardware identification (getprop / DMI strings) for accurate device branding on startup.

•Integrity Audits: Pre-flight inspection on downloaded .deb payloads using dpkg-deb -e / -c checks before handing over to apt-get.

•Clean State Traps: Added deterministic cleanup routines for temporary files during interruptions (INT, TERM, EXIT)

.---

🧹 Non-Destructive Uninstallation

•The uninstaller now strictly cleans binary executables (/usr/local/bin/uraam, ${PREFIX}/bin/uraam) and package records(uraam-debian, uraam-termux).

•Your data is safe: Custom debloat JSON profiles, logs, and device restoration snapshots are strictly preserved in ~/.config/uraam and ~/.local/share/uraam.

---

🌐 Verified Compatibility Matrix

Platform	Tier	Support Level
Android (Termux)	Tier 1	Native(Rootless via Shizuku / Local Root via su)
Debian / Ubuntu / Mint /Pop!_OS	Tier 1	Full Native (.deb & APT Integration)
ArchLinux / Manjaro	Tier 2	Standalone CLI (pacman dependency resolution)
Fedora / RHEL	Tier 2	Standalone CLI (dnf dependency resolution)
openSUSE/ Alpine	Tier 2	Standalone CLI (zypper / apk support)

URAAM

🚀 URAAM v4.4.4 — Linux Packaging & Instant Startup

This update marks a major milestone in integrating URAAM into the Linux desktop ecosystem while delivering instant startup performance and maintaining seamless cross-platform support(Android & Linux).

✨ What's New & Improvements

• 📦 Official Debian Package (.deb):
•Full compliance with Debian / FHS packaging standards.
•Automatic installation of the XDG desktop entry (uraam.desktop) and its dedicated application icon.
•Seamless integration into desktop application menus (XFCE Whisker Menu, GNOME, KDE,etc.) under the Accessories / System Tools category.
•Robust postinst and postrm maintainer scripts ensuring clean handling by apt and dpkg.

•⚡ Instant Startup (Zero Freeze):
•Overhauled backend detection logic.•Strict isolation of Android-specific privilege checks (su and rish / Shizuku) to prevent PAM authentication timeouts on Debian/Ubuntu systems.
•Immediate dashboard launch when runningvia ADB on desktop PCs.

•📱 Preserved Dual-Engine Compatibility:
•Unified, transparent behavior across alltarget environments:
•Android (Termux): Automatic prioritized detection (Root Magisk/KernelSU ➔ Shizuku/Rish).
•Desktop Linux: Native management via ADB.---

---

The installer will automatically detect your platform and guide you through:

• Debian / Ubuntu / WSL: Native .deb package (recommended) or standalone binary.
• Android (Termux): Automatic setup with storage and environment checks.
• macOS & other Linux distros: Direct standalone installation.

Run the universal installer directly in your terminal (Linux PC, Mac, or Android Termux):

bash <(curl -fsSL https://raw.githubusercontent.com/Uraam/Uraam/main/installer.sh || wget -qO- https://raw.githubusercontent.com/Uraam/Uraam/main/installer.sh)

Or install the local package via APT
sudo apt install ./uraam_*.deb

🚀 Usage Anywhere

Once installed, simply run the global command from any directory:

uraam

or directly via the desktop application menu or via Termux:Widget shotcuts.

Launch from terminal or directly via the desktopapplication menu

uraam---Special thanks for the community feedback and real-world testing! 🐧📱🔥

URAAM

What's Changed in v4.4.2

📦 Universal 1-Line Installer

The installer will automatically detect your platform and guide you through:

• Debian / Ubuntu / WSL: Native .deb package (recommended) or standalone binary.
• Android (Termux): Automatic setup with storage and environment checks.
• macOS & other Linux distros: Direct standalone installation.

Run the universal installer directly in your terminal (Linux PC, Mac, or Android Termux):

bash <(curl -fsSL https://raw.githubusercontent.com/Uraam/Uraam/main/installer.sh || wget -qO- https://raw.githubusercontent.com/Uraam/Uraam/main/installer.sh)

🚀 Usage Anywhere

Once installed, simply run the global command from any directory:

uraam

💡 Desktop Integration: If installed via the .deb package (Debian, Ubuntu, etc.), a desktop entryis automatically created. You can launch URAAM directly from your system applications menu under the Accessories / Utility category.

URAAM

What's Changed in v4.4.1

• Added one-click update for uraam-debian-*.deb, directly download Uraam DEB Latest Release on Github Repo & install it automatically. Select option "Update Uramm" in Dashboard.
• Improvements & fix bugs

URAAM

🚀 What's Changed in v4.4.0

One-Click Wireless ADB & Shizuku Setup : The script will automatically start Shizuku, switch ADB to wireless mode, find your device's IP, and connect to it over Wi-Fi.

URAAM

What's Changed in v4.3.0 🚀

This release introduces native package manager support (.deb), refines system paths for desktop/Termux environments, and streamlines the WirelessADB setup.

📦 Packaging & Updates

• Debian & Termux .deb Lifecycle: Added full support andhandling for package manager installations, preventing conflicts and cleanly handling updates across environments.
• Automated Package Builds: Introducedautomated CI/CD workflows generating ready-to-install .deb packages for both Debian and Termux directly on release.

📶 Connectivity & Wireless ADB

• Optimized Pairing Flow: Refined the Wireless ADB setup logicto abort cleanly if pairing fails.
• Mobile-Friendly Input: Improved IP/port parsing for faster and easier inputdirectly on mobile devices.

🛠 System & Directory Architecture

• Standardized FHS & XDG Paths: Cleaned up source and configuration loading directories (/usr/share/uraam, Termux prefix, and user configs) for strictLinux standard compliance.
• Array & Globbing Safety: Hardened Bash array initialization using nullglob acrossall configuration loaders.

URAAM - Universal Ruvomain ADB App-Manager v4.2.0

🚀 What's New in URAAM v4.2.0

• You can install now in Debian & Termux with uuram-*_4.2.0_all.deb (See command below)

🔄 Lifecycle & Maintenance

• Integrated Auto-Updater: Easily update URAAM to the latest commit directly from the Dashboard (Option 6) via Git fetching with atomic hot-reloading.
• One-Line Installer: Hassle-free deployment using a single curl | bash command, automatically configuring dependencies, directories, and the global uraam PATH symlink.

🛠️ Improvements

• Environment-aware path resolution (Linux & Termux ready).
• Zero-footprint update cycle preserving custom local backups and logs.

---

📥 Quick Install

Direct install with Uraam installer (all system):

bash <(command -v curl >/dev/null && curl -fsSL https://raw.githubusercontent.com/Ruvyrom/Uraam/main/installer.sh || wget -qO- https://raw.githubusercontent.com/Ruvyrom/Uraam/main/installer.sh)

DEB installation for Debian with uraam-debian_*.deb**

curl -LO https://github.com/Ruvyrom/Uraam/releases/download/v4.2.0/uraam-debian_4.2.0_all.deb || wget https://github.com/Ruvyrom/Uraam/releases/download/v4.2.0/uraam-debian_4.2.0_all.deb
sudo apt install ./uraam-debian_4.2.0_all.deb

DEB installation fo installation with uraam-termux_*.deb

curl -LO https://github.com/Ruvyrom/Uraam/releases/download/v4.2.0/uraam-termux_4.2.0_all.deb || wget https://github.com/Ruvyrom/Uraam/releases/download/v4.2.0/uraam-termux_4.2.0_all.deb
pkg install ./uraam-termux_4.2.0_all.deb