Termux Desktop

Easily Install Termux GUI Desktop

---

Key Features:

• 📚 Easy Setup: Easy-to-follow installation process.
• 🖥️ Desktop Styles: Supports XFCE, LXQt, and OPENBOX... with beautiful themes.
• 🦾 Hardware Acceleration: It will install all the drivers in order to It will install all the drivers in order to get hardware acceleration working under termux.
• 🖇️ GUI Access: Supports Termux:X11 and VNC (vnc is optional).
• 📦 Package Management: Compatible with both APT and PACMAN.
• 🛍️ App Store: A appstore to install apps from termux and suppoted proot-distro.
• 📦 Apps Normally, you're limited to apps that are supported by Termux, but it have a option for installing apps like LibreOffice via proot-distro and use them as a native app.
• And a lot more...

---

Getting Started:

1. Ensure Requirements Are Met:

• Android 8+ device

• Termux (download from GitHub or F-Droid)

  NOTE: This Only Works On Termux From Github Or Fdroid

  Avoid using Termux from Google Play due to API limitations.

• Termux:X11

• Termux-API

• Minimum 2GB of RAM (3GB recommended)

• 1.5-2GB of Internet data

• 3-4GB of free storage

• VNC Client RealVNC or NetHunter Kex (Optional)

2. Explore Desktop Styles:

• XFCE
• LXQt
• OPENBOX
• MATE

3. Hardware Acceleration and Distro Container:

• Learn more about hardware acceleration.
• Check out distro container usage.

4. Start Installation:

Full Installation YouTube Video Guide:- Here

Note: Fresh installations are recommended for best results.

Note: If you are in android 12 or higher then first disable Phantom Process Killer Guide:- Here

curl -Lf https://raw.githubusercontent.com/sabamdarif/termux-desktop/main/setup-termux-desktop -o setup-termux-desktop && chmod +x setup-termux-desktop && ./setup-termux-desktop

5. Usage Instructions:

• Commands for starting and stopping Termux:X11 and VNC sessions are provided below.

---

Command Reference:

Start Termux:X11

tx11start [options]

Options:

• --nogpu: Disable GPU acceleration.
• --legacy: Enable legacy drawing.
• --nodbus: Disable DBus.
• Combine options for specific configurations (e.g., tx11start --nogpu --legacy).
• --help: To show help.

Full Example:

• tx11start to star Termux:11 with gpu acceleration
• tx11start --nogpu to star Termux:11 without gpu acceleration
• tx11start --nogpu --legacy to star Termux:11 without gpu acceleration and -legacy-drawing
• tx11start --nodbus to star Termux:11 without dbus
• tx11start --nodbus --nogpu to star Termux:11 without gpu acceleration and dbus
• tx11start --nodbus --nogpu --legacy to star Termux:11 without gpu acceleration and dbus and with -legacy-drawing
• tx11start --nodbus --legacy to star Termux:11 without dbus and use -legacy-drawing (nodbus and gpu)
• tx11start --legacy to star Termux:11 with -legacy-drawing (with dbus and gpu)
• tx11start --debug --OTHER-PARAMETERS To see log of that commmand

  tx11start --debug --nogpu To See tx11start --nogpu's log

Stop Termux:X11

tx11stop [-f]

Options:

• -f: Force stop.
• --help: To show help.

Start VNC

vncstart [options]

Options:

• --nogpu: Disable GPU acceleration.
• --help: To show help.

Stop VNC

vncstop [-f]

Options:

• -f: Force stop.
• --help: To show help.

GUI Commands

gui [options]

Options:

• --start: Start GUI (use vnc or tx11 as arguments).
• --stop: Stop GUI.
• --kill: Stop all GUI sessions.
• --help: To show help.

Full Example:

If you select only one of them to access gui

• gui --start / gui -l to start Termux gui
• gui --stop / gui -s to stop gui

If you select both for gui access

• gui -l / --start vnc to start VNC
• gui -l / --start tx11 to start Termux:X11
• gui -s / --stop vnc to stop VNC
• gui -s / --stop tx11 to stop Termux:X11
• gui -k / --kill / -kill to kill both vncserver and Termux:x11 At Once

Setup Commands

setup-termux-desktop [options]

Options:

• --change style: Change desktop style.
• --change hw: Modify hardware acceleration settings.
• --reset: Reset all changes.
• --remove: Uninstall Termux Desktop.
• --local-config Start the installation from pre made config file
• --help: To show help.

Full Example:

• setup-termux-desktop --change style To Change Desktop Style
• setup-termux-desktop --change hw To Change Hardware Acceleration Method
• setup-termux-desktop --change pd To Change Installed Proot-Distro
• setup-termux-desktop --change autostart To change autostart behaviour
• setup-termux-desktop --change display To change termux:x11 display port

• setup-termux-desktop --reinstall icons / themes /config To Reinstall Icons / Themes / Config
• setup-termux-desktop --reinstall icons,themes,..etc To Reinstall Them At Once

• setup-termux-desktop --reset To Reset All Changes Made By This Script Without Uninstalling The Packages

• setup-termux-desktop --remove / -r To Remove Termux Desktop

• setup-termux-desktop --local-config / -config Start the installation from pre made config file

  Each time you install the desktop environment or made some changes using the script it write all your config to the /data/data/com.termux/files/usr/etc/termux-desktop/configuration.conf file. Copy that somewhere else, so next time when you want to install the desktop environment with that old config all you have to do setup-termux-desktop --local-config /path/to/configuration.conf

• setup-termux-desktop --debug (At The Start) To generate a log file for any of the above command

  • setup-termux-desktop --debug --install To create a log of whole installation process

---

Screenshots:

Demo Looks

XFCE	LXQT
OPENBOX	MATE

See More...

App Store:

Appstore UI:

Loading	Installing
Installed	Prompt

---

Advanced Topics:

Wine:

Run Windows applications seamlessly. Learn more here.

Distro Containers:

Install additional apps like LibreOffice. Details here.

Hardware Acceleration:

Enhance performance with GPU acceleration. Learn more here.

---

Associated Repos:

• Termux-AppStore
• sabamdarif/nautilus-scripts

---

Acknowledgments:

Special thanks to:

• LinuxDroidMaster/Termux-Desktops
• phoenixbyrd/Termux_XFCE
• Yisus7u7/termux-desktop-xfce
• adi1090x/termux-desktop
• Generator/termux-motd
• ar37-rs/virgl-angle
• mayTermux/myTermux
• catppuccin

---

If you enjoy this project, consider giving it a star! 🌟

Join the conversation: Telegram Chat.