Skip to content

Latest commit

 

History

208 Commits

Folders and files

Repository files navigation

🐧 Modded Ubuntu for Termux

Modern Ubuntu Desktop (XFCE4) environment for Android without root.

Ubuntu 26.04 LTS Termux XFCE4 License

Preview

Stars Forks Issues PRs Last Commit 2.1.0

Features • Requirements • Installation • Video Tutorial • Contributors • Changelog


🌟 Features

  • 🔒 No Root Required

  • 🚀 Latest Ubuntu 26.04

  • ⚡ Fully Automatic Setup

  • 🌐 Pre-patched Web Browsers

  • 🔊 Fixed Audio Output

  • 🎨 Beautiful Desktop Look

  • 🖱️ Lightweight & Modular

    Web Browsers IDE
    firefox vscode
    chromium sublime

📋 System Requirements

Requirement Recommended Specification
Operating System Android 7.0 (Nougat) or higher
Terminal App Termux (v0.118+ from F-Droid or GitHub) • F-Droid • Github
Available Storage At least 4 GB - 8 GB free space
Architecture aarch64 / arm64 (recommended), armhf, x86_64
VNC Client RealVNC Viewer or AVNC

⚡ Installation

Important

Always install Termux from F-Droid or GitHub Releases.

Step 1: Clone & Run Installer

Open Termux and execute the following commands:

yes | pkg up

pkg install git wget -y

# Clone repository
git clone --depth=1 https://github.com/modded-ubuntu/modded-ubuntu.git
cd modded-ubuntu
bash setup.sh

Note

During setup, you will be prompted to enter a username for your Ubuntu environment (must be lowercase, no spaces).


Step 2: Configure Desktop GUI

After the base environment finishes installing, restart Termux and run:

ubuntu
sudo bash gui.sh

Note

Follow the on-screen prompts to select your desired desktop components and set your VNC password.


🖥️ How to Connect

1. Start the VNC Server

Inside Ubuntu start the VNC server:

vncstart

To shut down the server:

vncstop

2. Connect via VNC Viewer

  1. Tap the + (Add) button.
  2. Configure the connection:
    • Address: localhost:1
    • Name: Modded Ubuntu (or anything you prefer)
  3. Set Picture Quality to High.
  4. Tap Connect, enter the password and enjoy your Linux desktop!

📹 Video Tutorial

Need a step-by-step demonstration? Watch the video below:


👥 Contributors

A huge shoutout to everyone who has contributed to improving this project!

📄 Credits

This project utilizes the official Ubuntu rootfs distribution powered by Termux PRoot-Distro

All credit for base container distribution goes to the PRoot-Distro maintainers.

Termux Proot Distro - https://github.com/termux/proot-distro

See the full Changelog for version release notes.


Star History

Star History Chart

⭐ If you find this project helpful, please consider giving it a star! ⭐

Releases

Contributors

Languages