Ubuntu Modded Optimized

Full Ubuntu on your Android device - one command, zero hassle

---

🌐 Language

🇬🇧 English · 🇸🇦 العربية

---

📋 Table of Contents

• What is UMO?
• Screenshots
• Desktop Environments
• Quick Start
• Commands
• CLI Options
• Requirements
• Project Structure
• Documentation
• Contributing
• License

---

🤔 What is UMO?

UMO (Ubuntu Modded Optimized) is a free, open-source Ubuntu installer for Termux - rewritten from scratch to fix the root problems found in every similar project. No external UI dependencies, no manual configuration, no surprises.

Problem	Other Projects	UMO
dialog breaks the UI	❌ Still using it	✅ Pure POSIX TUI - no deps
VNC dies on screen lock	❌ No fix	✅ termux-wake-lock built-in
No audio inside proot	❌ Manual workaround	✅ PulseAudio TCP bridge
systemctl fails	❌ Confusing errors	✅ Generic shell emulator (any service)
20+ manual steps	❌ Too complex	✅ One command: bash install.sh

---

🖼️ Screenshots

The guided installer - every step is a menu, numbered in the order you see it:

1 · Version - 22.04 LTS or 24.04 LTS	2 · Desktop - XFCE4 · LXDE · Openbox · CLI	3 · Theme - Night or Day mode
4 · Apps - six application sets	5 · Summary - review before install	6 · Done - completion report

The result - the XFCE session you get out of the box:

7 · The desktop - UMO theme, wallpaper and Fastfetch, ready

---

🖥️ Desktop Environments

Environment	Type	Best For	UMO Design
XFCE4	Full DE	Daily use - balanced performance	Themed panel, xfwm4 windows, wallpaper, whiskermenu
LXDE	Lightweight DE	Low-end and older devices	Themed lxpanel, pcmanfm wallpaper
Openbox	Window Manager	Advanced users, minimal footprint	Clearlooks windows, tint2 panel, root menu
Minimal	CLI only	Servers and headless usage	Terminal only - no theme applied

All graphical desktops get the full design system: Orchis GTK theme (compact), Tela icons, DMZ cursors, Ubuntu SemiBold + FiraCode Nerd Mono fonts, a matching Fastfetch config, and the UMO wallpaper - applied to both root and the umo user. Pick Night Mode (Orchis-Dark-Compact + Tela-black-dark) or Day Mode (Orchis-Light-Compact + Tela) in the installer, or with --theme=umo-dark|umo-light.

Includes: TigerVNC · PulseAudio Bridge · Termux:X11 · Generic systemctl emulator · Session Control

---

🚀 Quick Start

bash <(curl -fsSL https://raw.githubusercontent.com/shadow-x78/ubuntu-modded-optimized/main/umo.sh)

Downloads the latest release from GitHub (SHA-256 verified) and launches the installer. For a non-interactive install:

curl -fsSL https://raw.githubusercontent.com/shadow-x78/ubuntu-modded-optimized/main/umo.sh -o umo.sh && bash umo.sh --no-gui --de=xfce4 --apps=full

From source (contributors)

git clone https://github.com/shadow-x78/ubuntu-modded-optimized.git ~/UMO
cd ~/UMO
bash install.sh

After installation:

umo start
umo login

---

⌨️ Commands

In Termux

Command	Description
umo start	Start session with VNC & Audio
umo stop	Stop all services
umo status	Show running status of services
umo login	Root shell inside Ubuntu (interactive only - commands go through umo run)
umo user	Login as default user
umo run "<cmd>"	Run one command inside the container
umo backup [dir]	Archive the Ubuntu rootfs
umo update	Full update: pulls the latest UMO, re-applies your saved settings (theme mode, app set, desktop), and upgrades every Ubuntu package. Use --scripts-only for a fast scripts-only refresh or --no-upgrade to skip the Ubuntu system upgrade
umo refresh	Re-render the umo CLI, host scripts and container scripts from the local tool copy (no git pull)
umo uninstall	Remove UMO completely (rootfs, host scripts, umo command, aliases)
umo credit	About UMO and the developer
umo version	Display current UMO version

Host-side scripts (umo-login.sh, umo-start.sh, umo-stop.sh, umo-vnc-*.sh, aliases.sh) live in ~/.umo/ - the Termux home stays clean. The installer sources ~/.umo/aliases.sh from your shell rc, so umo-start, umo-stop, umo-startvnc, umo-stopvnc, umo-login and umo-user are usable as plain commands.

Inside Ubuntu

Command	Description
umo-startvnc	Start VNC server
umo-stopvnc	Stop VNC server
systemctl start <service>	Start a service (emulated)
systemctl status <service>	Check service status
systemctl restart <service>	Restart a service

---

🔧 CLI Options

bash install.sh [OPTIONS]

  --no-gui, --non-interactive    Skip menus, use defaults/env vars
  --de=xfce4|lxde|openbox        Choose desktop environment
  --apps=basic|dev|media|office|browser|full   Application group to install
  --dir=PATH                     Custom installation directory
  --ubuntu=22.04|24.04           Ubuntu version to install
  --perf=balanced|aggressive|off Choose performance tuning level
  --theme=umo-dark|umo-light|none
                                 Choose desktop theme (default: umo-dark)
  --mode=dark|light              Theme mode alias for --theme
  --lean                         Remove docs/man/locales to save space

---

📋 Requirements

• Android 8.0+ - ARM64 processor (aarch64)
• Termux from F-Droid or GitHub - not from Play Store
• 2 GB+ free storage
• Internet connection

---

🏗️ Project Structure

UMO/
├── bin/
│   ├── umo-install          # Main installer logic
│   ├── umo-start            # Session starter (Termux-side)
│   └── umo-stop             # Session stopper (Termux-side)
├── lib/
│   ├── core-ansi.sh         # ANSI colors, logging, banners
│   ├── core-ui.sh           # TUI: menus, prompts, confirms
│   ├── core-system.sh       # Platform detection, storage, internet
│   ├── core-net.sh          # Downloads, mirrors, extraction
│   └── core-fs.sh           # Safe file ops, backups, templates
├── modules/
│   ├── umo-proot.sh         # Proot container setup
│   ├── umo-vnc.sh           # TigerVNC installation & session scripts
│   ├── umo-audio.sh         # PulseAudio TCP bridge
│   ├── umo-systemctl.sh     # Generic systemctl emulator
│   ├── umo-desktop.sh       # DE installer (XFCE4 / LXDE / Openbox)
│   ├── umo-theme.sh         # Desktop design engine (all DEs)
│   └── umo-apps.sh          # App group installer
├── assets/
│   ├── logo/                # The UMO mark (SVG + PNG set)
│   └── screenshots/         # Installer screenshots
├── config/
│   ├── xstartup             # VNC session template
│   └── theme/               # Design templates: GTK, XFCE4, LXDE, Openbox, fonts, wallpaper
│       └── icons/           # UMO brand icon set (hicolor + menu button)
├── docs/
│   ├── INSTALL.md           # Detailed installation guide
│   └── TROUBLESHOOTING.md   # Common issues and fixes
├── install.sh               # Quick-start entry point
├── umo.sh                   # One-liner release installer (curl | bash)
├── CHANGELOG.md             # Release history
├── LICENSE                  # GPL-3.0-or-later
└── README.md                # This file

---

📚 Documentation

Document	Description
INSTALL.md	Detailed installation guide
TROUBLESHOOTING.md	Common issues and fixes

---

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

---

📜 License

Distributed under the GPL-3.0 License.

---

Built by shadow-x78 · Changelog

_{© 2026 Ubuntu Modded Optimized (UMO)}