Okay, let's get straight to the point, here are some dots and text, that will help you set the click environment in the termux. I've tried to make it as easy as possible to set up a beautiful linux desktop on your Android device with termux, so follow the steps and you'll end up making them look like this - 

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

First Impression

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

Openbox WMAnother Style
File ManagerText Editor/IDE
Terminal EmulatorWeb Browser
Vim & htopranger & calcursemutt & elinksmpd & ncmpcpp

Keybindings  ( Shot Key )

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

W-1Go To Desktop 1S-W-1Send To Desktop 1
W-2Go To Desktop 2S-W-2Send To Desktop 2
W-3Go To Desktop 3S-W-3Send To Desktop 3
W-4Go To Desktop 4S-W-4Send To Desktop 4
W-5Go To Desktop 5S-W-5Send To Desktop 5
W-S-LeftSend To Prev DesktopW-S-RightSend To Next Desktop
A-TabNext Window (Current Workspace)W-TabNext Window (All Workspaces)
W-hMove to TopLeftW-jMove to BottomLeft
W-kMove to TopRightW-lMove to BottomRight
W-LeftMove To Left EdgeW-RightMove To Right Edge
W-q/cClose WindowsA-r/mToggle Resize/Move
W-SpaceOpenbox MenuW-p/A-F1App Launcher
W-dToggle DesktopW-vSet Tasks
W-fFile ManagerW-eText Editor
W-t/returnTerminalW-wWeb Browser
W-xExit MenuW-mMusic Menu
W-bBattery MenuW-nNetwork Menu

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

Turbo C++, Windows 1 and Windows 3Duke and Blue Brothers
Mario and PacmanPrince of Persia (both)
Wolfenstein and Turrican2SuperKarts and Spiderman

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

Video  ( How to Install Full Video )

✅ Installation ✅

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

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

  • Update termux packages and install git

pkg upgrade && pkg install git

Step 2  :- Clone this repository ( Install Tool )

git clone --depth=1 https://github.com/adi1090x/termux-desktop.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.

Step 3  :- Change to cloned directory and run setup.sh with --install option

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

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

Step 4  :-  During installation, you'll be asked to set up password for VNC -

[*] Setting up VNC Server...

You will require a password to access your desktops.

Would you like to enter a view-only password (y/n)? n

Note that passwords are not visible when you are typing them and minimum password length is 6 characters. Remember the password you typed as it'll be required to connect via vnc client.

Step 5  :-  If everything is okay, you will see this message -

New 'localhost:1 ()' desktop is localhost:1

Creating default startup script /data/data/com.termux/files/home/.vnc/xstartup
Creating default config /data/data/com.termux/files/home/.vnc/config
Starting applications specified in /data/data/com.termux/files/home/.vnc/xstartup
Log file is /data/data/com.termux/files/home/.vnc/localhost:1.log

[*] Server Is Running...

TigerVNC server sessions:

:1              XXXXX

It means that X (vnc) server is available on display 'localhost:1'.

Step 6  :-  That's it. Termux Desktop is installed successfully. Restart Termux and enter startdesktop command to start vncserver and connect via VNC Client.



[*] Starting VNC Server...

New 'localhost:1 ()' desktop is localhost:1

Starting applications specified in /data/data/com.termux/files/home/.vnc/xstartup
Log file is /data/data/com.termux/files/home/.vnc/localhost:1.log

VNC Client

Step 7  :-  Now you need a VNC client app to connect to server. I'm using this Android VNC client: VNC Viewer. You can use TigerVNC if you're trying to connect to server by a computer (Windows or Linux).

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


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 -


✅ Uninstallation ✅

If you want to uninstall Termux Desktop, just use setup.sh with the uninstall option. Just save the setup.sh script and delete the compiled archive to save space. I'll create a different script for later download. The command below will delete all packages and delete all configuration files you have installed, including the changes you have made. So, be careful when ...

./setup.sh --uninstall

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.