LAST *officially* Updated : August 2023

Unmaintained : Due to Termux not working properly on new Android versions and also Termux not getting maintained properly.

Remaintained? Maybe?

'UNOFFICIAL' This Is A Fork, And This Is Still In Work, Attention To Some Things May Be Bad.

adi1090x For Original Project And ArchCraft Themes

---

Alright, Let's just get this straight, these are just some dotfiles & scripts, which will help you to setup a graphical environment in termux. I've tried to make it as easy as possible to setup a beautiful linux desktop on your android device with termux, So follow the steps and you'll end up making it look like this -

Openbox WM	Another Style

Lets start from the beginning...

Why This Does Exist ?

Termux-Desktop Is A Great Project And I Like It! And I Made A Fork Of It To Try And Make It In-date By Adding Arch-Craft Themes (WIP) And I Also Modified It So I Can Run It In Termux-x11,

What is termux?

Termux is an Android terminal emulator and Linux environment app that works directly with no rooting or setup required. A minimal base system is installed automatically - additional packages are available using the PKG/APT package manager. More Here...

How To install termux?

You can install termux from termux github or from f-droid.

• Download from F-Droid
  

Termux:x11 & Termux:Api

• Termux:Api F-droid : https://f-droid.org/packages/com.termux.api/
• Termux:x11 : https://github.com/termux/termux-x11/actions Or https://github.com/termux/termux-x11/releases
• Note: the first one Link To Download Termux:x11 App Requires A Github Account To Download The Files
• An Thing. if you have installed termux from github you also have to install termux api from github, the same applys to fdroid termux, if you install termux from github and termux api from f-droid, guess what? termux api fails to install because It Simply Conflicts.

More information about installation is here

Preparation

Install Termux & Termux:API Also Termux:x11 on your phone. It's recommended to install Termux API application as many desktop elements are dependent on it.

Old Test Device This setup is created and tested on :

Device - Redmi Note 9 Pro
Android - Android 10 (Q)
CPU Type - aarch64

New Test Device This setup is created and tested on :

Device - Redmi Pad
Android - Android 14, HyperOS 1.0
CPU Type - aarch64
CPU - Mediatek Helio G99
RAM - 4 GB

Installation

After installing both applications above, open Termux and follow the steps below -

• Update termux packages and install git

pkg upgrade && pkg install git

• Clone this repository

git clone --depth=1 https://github.com/Nottotallynadawr/termux-desktop-for-termux-x11.git

Warning : I'm assuming that you're doing this on a fresh termux install. If not, I'll suggest you to do so. However the setup.sh script backup every file it replace, It's still recommended that you manually backup your files in order to avoid conflicts.

• Change to cloned directory and run setup.sh with --install option

cd termux-desktop-for-termux-x11
chmod +x setup.sh
./setup.sh --install

• Or Let Me Just Make It Simpler

  
  pkg upgrade -y && pkg install git -y && git clone --depth=1 https://github.com/Nottotallynadawr/termux-desktop-for-termux-x11.git && cd termux-desktop-for-termux-x11 && chmod +x setup.sh && bash setup.sh --install
  
  

If script setup.sh fails during package installation (due to network issues), you can re-execute it again.

• During installation You Might See power10k Configure. if your screen gets randomly Rotated, you better go to termux NOW! -

That's it. Termux Desktop is installed successfully. Restart Termux and enter startdesktop command to start Termux X11 And Desktop And enter startdesktopvirgl if You Want A Virgl Hardware Accelerated Envoirment.

NOTE: VirGL Environment Is Unstable!

Uninstallation (WIP)

If you ever want to uninstall Termux Desktop, just run setup.sh with --uninstall option. Just keep the setup.sh script and delete the cloned repository to save space. I'll create a separate uninstaller script later. The command below will remove all the packages and delete all the config files it installed, including the changes you've made. So, Be careful there...

./setup.sh --uninstall

Determine port number on which VNC server listens. It can be calculated like this: 5900 + {display number}. So for display 'localhost:1' the port will be 5901.

Now open the VNC Viewer application and create a new connection with the following information (assuming that port is 5901) -

Address:
127.0.0.1:5901

Name:
Termux

Now launch it. You will be prompted for password that you entered during installation. After entering password, you'll be headed directly to this desktop -

First Impression

Let's take a look at following installed programs you'll get here -

File Manager	Text Editor/IDE

Terminal Emulator	Web Browser

Openbox Menu	Many CLI based Programs

vim & htop	ranger & calcurse	mutt & elinks	mpd & ncmpcpp

Rofi Application launcher and Applets -

App Launcher	Music Player

Battery Status	Exit Menu	Network Info

Styles

There are total Eight different styles/themes available in this setup. To change style, Right click on desktop > Preferences > Change Style and select the one you want to apply.

Default	Beach	Forest	Grid

Manhattan	Slime	Spark	Wave

Applications of Termux Desktop

Well, These are some ideas or things you can do with termux desktop. From Learning coding to Penetration testing, Chatting over IRC to Browsing web and Downloading file, Playing classic retro games to run Windows from 90s.

• Learn and practice you coding skill without having a laptop

Python	Bash

• Chatting, Web Browsing and Downloading files

Hexchat & Pidgin	Netsurf & Uget	Browsing Wiki

• Penetration testing and Learn cyber security stuff

I'm not doing anything illegal or sponsoring any kind of Hacking and Cracking. Termux is a powerful tool, use it with responsibilities.

Metasploit - Sherlock - Socialfish - Zphisher - Sqlmap

• Play classic retro games or Run Microsoft Windows from 90s with Dosbox

Turbo C++, Windows 1 and Windows 3	Duke and Blue Brothers

Mario and Pacman	Prince of Persia (both)

Wolfenstein and Turrican2	SuperKarts and Spiderman

You'll probably get the idea of possible things you can do with Termux and how Termux Desktop makes it more easy.

Keybindings

Here's some shortcut keys you want to use to speed up your work. For more, Right click on desktop > Keybinds

Keys	Action	-----	Keys	Action
W-1	Go To Desktop 1		S-W-1	Send To Desktop 1
W-2	Go To Desktop 2		S-W-2	Send To Desktop 2
W-3	Go To Desktop 3		S-W-3	Send To Desktop 3
W-4	Go To Desktop 4		S-W-4	Send To Desktop 4
W-5	Go To Desktop 5		S-W-5	Send To Desktop 5
W-S-Left	Send To Prev Desktop		W-S-Right	Send To Next Desktop
A-Tab	Next Window (Current Workspace)		W-Tab	Next Window (All Workspaces)
W-h	Move to TopLeft		W-j	Move to BottomLeft
W-k	Move to TopRight		W-l	Move to BottomRight
W-Left	Move To Left Edge		W-Right	Move To Right Edge
W-Up	Maximized		W-Down	Unmaximized
W-q/c	Close Windows		A-r/m	Toggle Resize/Move
W-Space	Openbox Menu		W-p/A-F1	App Launcher
W-d	Toggle Desktop		W-v	Set Tasks
W-f	File Manager		W-e	Text Editor
W-t/return	Terminal		W-w	Web Browser
W-x	Exit Menu		W-m	Music Menu
W-b	Battery Menu		W-n	Network Menu
C-A-v	Vim		C-A-r	Ranger
C-A-h	Htop		C-A-n	Nano

Additional Tools

You can install additional tools for termux, to make it visually look good.

1. Oh my zsh, Setup zsh with oh-my-zsh framework. (Already Added in this setup)
2. Termux style, Change color and fonts in termux.

FYI

• If you face any problem or get any error, you can create an issue & i'll try to help.
• Edit ~/.local/bin/email and put your Email ID and Password (Use an App password) to show unread mails on polybar.
• You may need to edit some config files accoring to your need (~/.mutt/muttrc, ~/.gitconfig)
• Don't Email or DM me to ask how to hack, I ain't a Hacker.
• Have Fun, Share this repository with your friends.