A Termux X11 server add-on app.
Termux:X11 is a fully fledged X server. It is built with Android NDK and optimized to be used with Termux.
This repo uses submodules. Use
~ $ git clone --recurse-submodules https://github.com/termux/termux-x11
or
~ $ git clone https://github.com/termux/termux-x11
~ $ cd termux-x11
~ $ git submodule update --init --recursive
Just like any other X server.
Application runs only on Android 8+ devices.
For this one you must enable the x11-repo
repository can be done by executing pkg install x11-repo
command
For X applications to work, you must install Termux-x11 companion package.
You can install nightly companion package from repositories with pkg in x11-repo && pkg in termux-x11-nightly
Or you can download an artifact from last successful build and installing termux-x11-*-debug.apk
(according to device architecture
, universal if you are doubting) and *.deb
(if you use termux with pkg
) or *.tar.xz
(if you use termux with pacman
) files from termux-companion packages
artifact.
You can start your desired graphical application by doing:
~ $ termux-x11 :1 -xstartup "dbus-launch --exit-with-session xfce4-session"
or
~ $ termux-x11 :1 &
~ $ env DISPLAY=:1 dbus-launch --exit-with-session xfce4-session
You may replace xfce4-session
if you use other than Xfce
dbus-launch
does not work for some users so you can start session with
~ $ termux-x11 :1 -xstartup "xfce4-session"
Also you can do
export TERMUX_X11_XSTARTUP="xfce4-session"
termux-x11 :1
In this case you can same TERMUX_X11_XSTARTUP somewhere in .bashrc
or other script and not type it every time you invoke termux-x11.
If you're done using Termux:X11 just simply exit it through it's notification drawer by expanding the Termux:X11 notification then "Exit"
But you should pay attention that termux-x11
command is still running and can not be killed this way.
For some reason some devices output only black screen with cursor instead of normal output so you should pass -legacy-drawing
option.
~ $ termux-x11 :1 -legacy-drawing -xstartup "xfce4-session"
For some reason some devices show screen with swapped colours, in this case you should pass -force-bgra
option.
~ $ termux-x11 :1 -force-bgra -xstartup "xfce4-session"
If you plan to use the program with proot, keep in mind that you need to launch proot/proot-distro with the --shared-tmp option.
If passing this option is not possible, set the TMPDIR environment variable to point to the directory that corresponds to /tmp in the target container.
If you are using proot-distro you should know that it is possible to start termux-x11
command from inside proot container.
If you plan to use the program with chroot or unshare, you must to run it as root and set the TMPDIR environment variable to point to the directory that corresponds to /tmp in the target container.
This directory must be accessible from the shell from which you launch termux-x11, i.e. it must be in the same SELinux context, same mount namespace, and so on.
Also you must set XKB_CONFIG_ROOT
environment variable pointing to container's /usr/share/X11/xkb
directory, otherwise you will have xkbcomp
-related errors.
You can get loader for nightly build from an artifact of last successful build
Do not forget to disable SELinux
setenforce 0
export TMPDIR=/path/to/chroot/container/tmp
export CLASSPATH=$(/system/bin/pm path com.termux.x11 | cut -d: -f2)
/system/bin/app_process / com.termux.x11.CmdEntryPoint :0
termux-x11's X server runs in process with name "app_process", not "termux-x11". But you can kill it by searching "com.termux.x11" in commandline. So killing it will look like
pkill -f com.termux.x11
am broadcast -a com.termux.x11.ACTION_STOP -p com.termux.x11
If you need to obtain logs from the com.termux.x11
application,
set the TERMUX_X11_DEBUG
environment variable to 1, like this:
TERMUX_X11_DEBUG=1 termux-x11 :0
The log obtained in this way can be quite long. It's better to redirect the output of the command to a file right away.
In Android 13 post notifications was restricted so you should explicitly let Termux:X11 show you notifications.
Video
img_enable-notifications.3.webm
Preferences: You can access preferences menu three ways:
Just press "Back" button.
In touchpad emulation mode you can use the following gestures:
- Tap for click
- Double tap for double click
- Two-finger tap for right click
- Three-finger tap for middle click
- Two-finger vertical swipe for vertical scroll
- Two-finger horizontal swipe for horizontal scroll
- Three-finger swipe down to show-hide additional keys bar.
In simulated touchscreen mode you can use the following gestures:
- Single tap for left button click.
- Long tap for mouse holding.
- Double tap for double click
- Two-finger tap for right click
- Three-finger tap for middle click
- Two-finger vertical swipe for vertical scroll
- Two-finger horizontal swipe for horizontal scroll
- Three-finger swipe down to show-hide additional keys bar.
Some apps may have issues with X server regarding DPI. please see https://wiki.archlinux.org/title/HiDPI on how to override application-specific DPI or scaling.
You can fix this in your window manager settings (in the case of xfce4 and lxqt via Applications Menu > Settings > Appearance). Look for the DPI value, if it is disabled enable it and adjust its value until the fonts are the appropriate size.
Also you can start termux-x11
with -dpi
option.
~ $ termux-x11 :1 -xstartup "xfce4-session" -dpi 120
It is possible to change preferences of termux-x11 from command line.
termux-x11-nightly
package contains termux-x11-preference
tool which can be used like
termux-x11-preference [list] {key:value} [{key2:value2}]..."
Use termux-x11-preference
to dump current preference.
Use termux-x11-preference > file
to dump current preferences to file.
Use termux-x11-preferences < file
to restore preferences from file.
Use termux-x11-preferences "fullscreen"="false" "showAdditionalKbd"="true"
to disable fullscreen and enable additional key bar. The full list of preferences you can modify is available with termux-x11-preference list
command. You can specify one or more preferences here.
Termux:X11 activity should be available in background or foreground, otherwise termux-x11-preferences
tool will hang indefinitely.
In the case if there is Store preferences for secondary displays separately
preference active termux-x11-preference
will use/modify preferences of display where Termux:X11 activity is currently opened.
It is possible to use Termux:X11 with 3rd party apps.
Check how shell-loader/src/main/java/com/termux/x11/Loader.java
works.
Released under the GPLv3 license.