package icon

Termux:GUI

A plugin for Termux to use the Android GUI from terminal applications.
New in version 0.1.6
Implemented all Protobuf methods
Added features for the Protobuf protocol:
- setting an Activity to fullscreen
- intercepting volume buttons
- hardware-accelerated rendering with SurfaceViews
- setting the secure flag for an Activity, disabling screenshots and blanking it out in the app switcher
WebView fixes
Changed the app icon a bit
Added more demo videos
Implemented a Bash library
Implemented a C library (tutorial not yet fully finished)
With this plugin you can make GUI applications in Termux without using VNC or a X11 server.
This plugin uses the native Android GUI components to display everything.
That means it seamlessly integrates into the Android experience, but standard applications written for X11 don't work.
Also it requires a minimum of knowledge of how the Android GUI works.
See the README for a crash course.

Features:
* Display content in a task with its own back stack
* Display custom dialogs
* If you want you can also display on the lockscreen
* Create your own homescreen widgets
* Use picture-in-picture mode
* Get events from the UI and change the content on-the-fly
* Draw to a buffer on the screen directly


Using the plugin:

There are also prepackaged programs you can use.

There are currently Python bindings, C bindings and a Bash library, and the protocol used is fully documented.
Implementing the protocol only requires the ability to use unix sockets, JSON handling and reading and writing 4 byte big endian integers.
The python bindings should provide further clarification in case the protocol didn't specify something.
The python bindings also have a tutorial.



Versions

Although APK downloads are available below to give you the choice, you should be aware that by installing that way you will not receive update notifications and it's a less secure way to download. We recommend that you install the F-Droid client and use that.

Download F-Droid
  • Version 0.1.6 (7) suggested Added on Feb 20, 2025

    arm64-v8a armeabi-v7a x86 x86_64

    This version requires Android 7.0 or newer.

    It is built by F-Droid and guaranteed to correspond to this source tarball.

    Permissions
    • run foreground service
      Allows the app to make use of foreground services.
    • show notifications
      Allows the app to show notifications
    • This app can appear on top of other apps
      This app can appear on top of other apps or other parts of the screen. This may interfere with normal app usage and change the way that other apps appear.
    • prevent phone from sleeping
      Allows the app to prevent the phone from going to sleep.

    Download APK 3.3 MiB PGP Signature | Build Log