Need help with termux-app?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

9.4K Stars 1.3K Forks Other 1.2K Commits 229 Opened issues


Termux - a terminal emulator application for Android OS extendible by variety of packages.

Services available


Need anything else?

Contributors list

Termux application

Build status Testing status Join the chat at Join the Termux discord server Termux library releases at Jitpack

Termux is an Android terminal application and Linux environment.

Note that this repository is for the app itself (the user interface and the terminal emulation). For the packages installable inside the app, see termux/termux-packages.

Quick how-to about Termux package management is available at Package Management. It also has info on how to fix

repository is under maintenance or down
errors when running


@termux is looking for Termux Application maintainers for implementing new features, fixing bugs and reviewing pull requests since the current one (@fornwall) is inactive.

Issue needs extra attention.


Termux App and Plugins

The core Termux app comes with the following optional plugin apps.


Termux can be obtained through various sources listed below for only Android

>= 7
. Support was dropped for Android
on 2020-01-01 at
, old builds are available on

The APK files of different sources are signed with different signature keys. The

app and all its plugins use the same
and so all their APKs installed on a device must have been signed with the same signature key to work together and so they must all be installed from the same source. Do not attempt to mix them together, i.e do not try to install an app or plugin from
and another one from a different source like
. Android Package Manager will also normally not allow installation of APKs with different signatures and you will get errors on installation like
App not installed
Failed to install due to an unknown error
signatures do not match previously installed version
, etc. This restriction can be bypassed with root or with custom roms.

If you wish to install from a different source, then you must uninstall any and all existing Termux or its plugin app APKs from your device first, then install all new APKs from the same new source. Check Uninstallation section for details. You may also want to consider Backing up Termux before the uninstallation so that you can restore it after re-installing from Termux different source.

In the following paragraphs, "bootstrap" refers to the minimal packages that are shipped with the

itself to start a working shell environment. Its zips are built and released here.


Termux application can be obtained from

from here.

You do not need to download the

app (via the
Download F-Droid
link) to install Termux. You can download the Termux APK directly from the site by clicking the
Download APK
link at the bottom of each version section.

It usually takes a few days (or even a week or more) for updates to be available on

once an update has been released on
. The
releases are built and published by
once they detect a new
release. The Termux maintainers do not have any control over the building and publishing of the Termux apps on
. Moreover, the Termux maintainers also do not have access to the APK signing keys of
releases, so we cannot release an APK ourselves on
that would be compatible with

Only a universal APK is released, which will work on all supported architectures. The APK and bootstrap installation size will be

does not support architecture specific APKs.


Termux application can be obtained on

either from
Github Releases
>= v0.118
or from
Github Build
action workflows.

The APKs for

Github Releases
will be listed under
drop-down of a release. These are automatically attached when a new version is released.

The APKs for

Github Build
action workflows will be listed under
section of a workflow run. These are created for each commit/push done to the repository and can be used by users who don't want to wait for releases and want to try out the latest features immediately or want to test their pull requests.

The APKs for both of these are

and are compatible with each other but they are not compatible with other sources.

Both universal and architecture specific APKs are released. The APK and bootstrap installation size will be

if using universal and
if using architecture specific. Check here for details.

Google Play Store (Deprecated)

Termux and its plugins are no longer updated on Google Play Store due to android 10 issues and have been deprecated. The last version released for Android

>= 7
. It is highly recommended to not install Termux apps from Play Store any more.

There are plans for unpublishing the Termux app and all its plugins on Play Store soon so that new users cannot install it and for disabling the Termux apps with updates so that existing users cannot continue using outdated versions. You are encouraged to move to

builds as soon as possible.

You will not need to buy plugins again if you bought them on Play Store. All plugins are free on


You can backup all your data under

before changing installation source, and then restore it afterwards, by following instructions at Backing up Termux before the uninstallation.

There is currently no work being done to solve android

issues and working updates will not be resumed on Google Play Store any time soon. We will continue targeting sdk
for now. So there is not much point in staying on Play Store builds and waiting for updates to be resumed. If for some reason you don't want to move to
sources for now, then at least check Package Management to change your mirror, otherwise, you will get
repository is under maintenance or down
errors when running
commands. After that, it is also highly advisable to run
pkg upgrade
command to update all packages to the latest available versions, or at least update
package with
pkg install termux-tools

If you plan on staying on Play Store sources in future as well, then you may want to disable automatic updates in Play Store for Termux apps, since if and when updates to disable Termux apps are released, then you will not be able to downgrade and will be forced to move since apps won't work anymore. Only a way to backup

data may be provided.

Why Disable?

  • They should be disabled because deprecated things get removed and are not supported after some time, its the standard practice. It has been many months now since deprecation was announced and updates have not been released on Play Store since after 29 September 2020.

  • The new versions have lots of new features and fixes which you can mostly check out in the Changelog of Github Releases that you may be missing out. Extra detail is usually provided in commit messages.

  • Users on old versions are quite often reporting issues in multiple repositories and support forums that were fixed months ago, which we then have to deal with. The maintainers of @termux work in their free time, majorly for free, to work on development and provide support and having to re-re-deal with old issues takes away the already limited time from current work and is not possible to continue doing. Play Store page of termux-app has been filled with bad reviews of "broken app", even though its clearly mentioned on the page that app is not being updated, yet users don't read and still install and report issues.

  • Asking people to pay for plugins when the termux-app at installation time is broken due to repository issues and has bugs is unethical.

  • Old versions don't have proper logging/debugging and crash report support. Reporting bugs without logs or detailed info is not helpful in solving them.

  • It's also easier for us to solve package related issues and provide custom functionality with app updates, which can't be done if users continue using old versions. For example, the bintray shudown causing package install/update failures for new Play Store users is/was not an issue for F-Droid users since it is being shipped with updated bootstrap and repo info, hence no reported issues from new F-Droid users.


Uninstallation may be required if a user doesn't want Termux installed in their device anymore or is switching to a different install source. You may also want to consider Backing up Termux before the uninstallation.

To uninstall Termux completely, you must uninstall any and all existing Termux or its plugin app APKs listed in Termux App and Plugins.

Go to

Android Settings
and then look for those apps. You can also use the search feature if it’s available on your device and search
in the applications list.

Even if you think you have not installed any of the plugins, it's strongly suggested to go through the application list in Android settings and double-check.

Important Links


All community links are available here.

The main ones are the following.




Terminal resources

Terminal emulators

For Maintainers and Contributors

The termux-shared library was added in

. It defines shared constants and utils of the Termux app and its plugins. It was created to allow for the removal of all hardcoded paths in the Termux app. Some of the termux plugins are using this as well and rest will in future. If you are contributing code that is using a constant or a util that may be shared, then define it in

library if it currently doesn't exist and reference it from there. Update the relevant changelogs as well. Pull requests using hardcoded values will/should not be accepted.

The main Termux constants are defined by

class. It also contains information on how to fork Termux or build it with your own package name. Changing the package name will require building the bootstrap zip packages and other packages with the new

, check Building Packages for more info.

Check Termux Libraries for how to import termux libraries in plugin apps and Forking and Local Development for how to update termux libraries for plugins.

Commit messages should preferably use Conventional Commits specs. Use the following

Added: Add foo
Added|Fixed: Add foo and fix bar
Changed!: Change baz as a breaking change
, etc. This should also allow automated generation of Changelogs in future.
  • Added for new features.
  • Changed for changes in existing functionality.
  • Deprecated for soon-to-be removed features.
  • Removed for now removed features.
  • Fixed for any bug fixes.
  • Security in case of vulnerabilities.

Changelogs for releases are generated based on Keep a Changelog specs.


  • Check
    javadocs for instructions on what changes to make in the app to change package name.
  • You also need to recompile bootstrap zip for the new package name. Check here and here for experimental work on it.
  • Currently, not all plugins use
    library and have hardcoded
    values and will need to be manually patched.
  • If forking termux plugins, check Forking and Local Development for info on how to use termux libraries for plugins.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.