Go to file
WMCB-Tech 64e9882a61 Update README 2021-08-28 17:50:13 +08:00
.github Use stacktrace option in tests 2021-08-26 18:42:38 +05:30
app Update preference messages and default values 2021-08-26 18:42:38 +05:30
gradle/wrapper Update Gradle Wrapper from 7.1.1 to 7.2. 2021-08-26 18:42:38 +05:30
.gitignore Update .gitignore 2021-08-26 18:42:38 +05:30
LICENSE Create LICENSE 2019-08-26 06:29:04 +03:00
README.md Update README 2021-08-28 17:50:13 +08:00
build.gradle Bump gradle from 7.0.0 to 7.0.1 2021-08-26 18:42:38 +05:30
gradle.properties Enable jetifier and androidx in gradle.properties 2021-08-26 18:42:38 +05:30
gradlew Update Gradle Wrapper from 7.1.1 to 7.2. 2021-08-26 18:42:38 +05:30
gradlew.bat Update Gradle Wrapper from 7.0.2 to 7.1.1. 2021-08-26 18:42:38 +05:30
settings.gradle Basic and buggy Android activity backend 2019-06-30 05:01:25 +03:00

README.md

Termux:Wayland

Join the chat at https://gitter.im/termux/termux

A Termux add-on app providing Android frontend for Xwayland.

When developing (or packaging), note that this app needs to be signed with the same key as the main Termux app in order to have the permission to execute scripts.

About

Termux:Wayland (previously known as Termux:X11) uses Wayland display protocol. a modern replacement and the predecessor of the X.org server

How does it work?

the Termux:Wayland app writes files through $PREFIX/tmp in Termux directory by default and creates wayland sockets through that directory, this takes advantage of sharedUserId AndroidManifest attribute

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:Wayland

Setup Instructions

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 Xwayland packages. you can do that by doing

pkg install xwayland

Running Graphical Applications

to work with GUI applications, start Termux:Wayland first. a toast message saying Service was Created indicates that it should be ready to use

then you can start your desired graphical application by doing:

~ $ export XDG_RUNTIME_DIR=${TMPDIR}
~ $ Xwayland :1 >/dev/null &
~ $ env DISPLAY=:1 xfce4-session

You may replace xfce4-session if you use other than Xfce

If you're done using Termux:Wayland just simply exit it through it's notification drawer by expanding the Termux:Wayland notification then "Exit"

Font or scaling is too big!

Some apps may have issues with wayland regarding DPI. please see https://wiki.archlinux.org/title/HiDPI on how to override application-specific DPI or scaling

License

Released under the GPLv3 license.