package icon

Termux:GUI

A plugin for Termux to use the Android GUI from terminal applications.
New in version 0.1.4
Added screen on/off events
Added events for airplane mode, locale, timezone and configuration changes
Added requestFocus to focus an EditText and display the soft keyboard
Added HorizontalScrollView
Added item snapping for HorizontalScrollView and NestedScrollView
Added a settings screen
Added a method to turn the screen on
Added a method to request the user to unlock the screen
Added TabLayout
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 only Python bindings, but 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.

Example code is provided in examples/code, but it's not commented and more used for testing features.


Packages

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.4 (5) suggested Added on 2022-01-11

    This version requires Android 7.0 or newer.

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

    Permissions
    • run foreground service
      Allows the app to make use of foreground services.
    • 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 2.0 MiB PGP Signature | Build Log

  • Version 0.1.3 (4) - Added on 2021-12-16

    This version requires Android 7.0 or newer.

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

    Permissions
    • run foreground service
      Allows the app to make use of foreground services.
    • 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.

    Download APK 1.8 MiB PGP Signature | Build Log