Skip to content

Commit 19e3c4d

Browse files
author
c4ttysam
authored
Update termux-x11.md
1 parent f2aba63 commit 19e3c4d

File tree

1 file changed

+22
-15
lines changed

1 file changed

+22
-15
lines changed

udroid-landing/setting-up-gui/termux-x11.md

Lines changed: 22 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,26 +2,33 @@
22
description: guide for setting termux-x11 for udroid GUI
33
---
44

5-
# setting up termux-x11
5+
# Termux:X11
6+
Termux:X11 is a termux addon providing android frontend for xwayland. It uses Wayland display protocol, which is aimed to become the successor of the X Window System. Note that it is not a fully fledged wayland server, its like a X system in wayland.
67

7-
### Prerequisites
8+
### 1. How does it work?
89

9-
* Get termux from [termux.com](https://termux.com) or [F-Droid.](https://f-droid.org/en/packages/com.termux/)
10-
* termux-x11 app from [<mark style="color:orange;">Github actions</mark>](https://github.com/termux/termux-x11/actions/workflows/debug\_build.yml) <mark style="color:orange;"></mark> ( prefer downloading one with a green tick mark )
10+
Through its companion package, the executable creates socket through $XDG_RUNTIME_DIR in Termux directory by default.
11+
12+
The wayland sockets is the way for the graphical applications to communicate with. Termux X11 applications do not have wayland support yet, this kind of setup may not be straightforward and therefore additional packages should be installed in order for X11 applications to be run in Termux:X11.
13+
14+
15+
16+
### 2. Requirements
17+
18+
* Termux from workflows builds
19+
* Termux:x11 companion app from [<mark style="color:orange;">Github actions</mark>](https://github.com/termux/termux-x11/actions/workflows/debug\_build.yml) <mark style="color:orange;"></mark> ( prefer downloading one with a green tick mark )
1120
* <img src="../../../.gitbook/assets/image (3).png" alt="" data-size="original">![](<../../../.gitbook/assets/image (2).png>)
1221

13-
### Setting up termux
22+
### 3. Setup Instructions
1423

15-
`xwayland` ( binaries for Wayland ) is in `x11-repo` & `termux-x11` ( available as zip in action builds )
24+
Get xwayland and termux-x11 from x11 repository
1625

1726
```bash
1827
pkg install x11-repo -y
1928
pkg install xwayland termux-x11
2029
```
2130

22-
#### Change termux properties
23-
24-
set property `allow-external-apps` to `true` in `~/.termux/termux.properties`
31+
Set property `allow-external-apps` to `true` in `~/.termux/termux.properties`
2532

2633
```
2734
echo 'allow-external-apps = true' >> ~/.termux/termux.properties
@@ -32,8 +39,6 @@ termux-reload-settings
3239
Recommended to restart termux
3340
{% endhint %}
3441

35-
#### Installing termux-x11 starter
36-
3742
The zip you installed from[ STEP 2](termux-x11.md#prerequisites) contains a `.deb` file. to start `termux-x11` the server we need to install it in `termux` session
3843

3944
```
@@ -44,11 +49,10 @@ cd termux-x11
4449
dpkg -i --force-depends termux-x11.deb
4550
```
4651

47-
Setting termux is done ✌️
4852

49-
### Using Termux-x11 to run `proot-distro` Linux
53+
### 4. Using Termux-x11 to run udroid
5054

51-
assuming you installed ubuntu with proot-distro with xfce4 installed, in your termux execute
55+
Assuming you installed ubuntu with proot-distro with xfce4 installed, in termux session execute
5256

5357
```bash
5458
termux-x11
@@ -80,7 +84,10 @@ dbus-launch --exit-with-session startxfce4
8084

8185
That's all now if you open minimized Termux:x11 app you see xfce4 running
8286

83-
### Further sources
87+
### 5. Troubleshooting
88+
will be updated soon...
89+
90+
### References
8491

8592
Official termux-x11 repo
8693

0 commit comments

Comments
 (0)