Skip to content

Install a full Linux desktop environment on your Android device with Termux X11 or VNC and also enable hardware acceleration. Additionally, install some popular GUI applications directly within Termux

License

Notifications You must be signed in to change notification settings

sabamdarif/termux-desktop

Repository files navigation



Easily Install Termux Gui Desktop

GitHub stars GitHub issues

Features:

  • 📚 Easy To Setup
  • 🖥️ XFCE, LXQt, and OPENBOX supported
  • 🎨 New Beautiful Theme And Styles
  • 🍷 Wine To Run Windows Apps (x86_64 in arm64 device)
  • 🦾 Hardware Acceleration Enabled
  • 🖇️ Termux:X11 / Vnc For Gui Access
  • 📦 Work with both APT , PACMAN
  • 🧩 One Click To Install Some useful Apps
    • 🌐 Browser: Firefox / Chromium
    • 👨‍💻 Code Editor: VS Code / Geany
    • 📷 Image Editor: Gimp / Inkscape
    • 🔗 More...
  • 📦 Install apps like libreoffice (apps that are not avilable in termux by default)
  • 🔗 And Much More...

⚠️ Follow This Steps 👇

1. Check Basic Requirment: from here

2. Check All Avilable Desktop Styles:

Openbox keybord shortcuts :- Here

3. Check About Hardware Acceleration : from here

4. Check About Distro Container: from here [Video Tutorial]

5. Check Natively Supported Apps list: from here

6. Installation: from here [Video Tutorial]

7. Uses: from here

8. See More: from here


Minimum Requirements:

Termux from Google Play can't poperly install x11-packages due to API limitation, so instead use the F-Droid Or Github build.


Default Look (XFCE):


See Other Desktop And Their Avilable Styles: XFCE,LXQT,OPENBOX


Screenshots:

All gui apps screenshot

Browsers:

Image Editors:

Code Editors:

Media Players:

See More Natively Supported Apps: Here


Wine: See More


Want To Install More Apps (Like: Libreoffice) Which Are Not Avilable In Termux:

See How To Use Distro Container: Click Here

Libre Office:


Hardware Acceleration In Distro Container And Also In Termux:

Know More About Hardware Acceleration: Here


⚠️ About The New The Experimental GPU Drivers (mesa-vulkan-icd-wrapper)

The experimental drivers only support a few GPUs and currently use Vulkan only

In my tests, I achieved 1000+ FPS in vkmark on all my devices. I tried it on an Adreno 619 (best everything work fine), Adreno 750 (usable but some apps don't launch), Adreno 720 (good overall but with few issues), and Mali G76 (similar issue like Adreno 720).

Also if you have Adreno GPU then please select ubuntu or debian as distro container so it can use ternip in the distro container. Sadly for other then adreno, GPU might not work on the distro container.

If you type 'n/N' then it will use the old way to setup Hardware Acceleration.


Installation:

NOTE: This Only Works On Termux From Github Or Fdroid

NOTE: A Fresh Install Is Always Recommended

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

⚠️If you are in android 12 or higher then first disable Phantom Process Killer

Guide:- Here


Uses:

Command:- tx11start

  • 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)

Command:- tx11stop

  • tx11stop to stop Termux:11
  • tx11stop -f to kill Termux:11

Command:- vncstart

  • vncstart to start vncserver
  • vncstart ---nogpu to start vncserver without gpu acceleration

Command:- vncstop

  • vncstop to stop vncserver
  • vncstop -f to kill vncserver

Command:- gui

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

Command:- setup-termux-desktop

  • 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 --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 --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


If you like my work then don't forget to give a Star 😊