Termux application

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

We are looking for Termux Android application maintainers.

NOTICE: Termux may be unstable on Android 12+. Android OS will kill any (phantom) processes greater than 32 (limit is for all apps combined) and also kill any processes using excessive CPU. You may get

Contents

• Termux App and Plugins
• Installation
• Uninstallation
• Important Links
• Debugging
• For Maintainers and Contributors
• Forking

Termux App and Plugins

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

• Termux:API
• Termux:Boot
• Termux:Float
• Termux:Styling
• Termux:Tasker
• Termux:Widget

Installation

Latest version is

NOTICE: It is highly recommended that you update to

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

Support for both app and packages was dropped for Android

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

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

F-Droid

Termux application can be obtained from

You do not need to download the

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

The

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

GitHub

Termux application can be obtained on

The APKs for

The APKs for

The APKs for both of these are

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

Security warning: APK files on GitHub are signed with a test key that has been shared with community. This IS NOT an official developer key and everyone can use it to generate releases for own testing. Be very careful when using Termux GitHub builds obtained elsewhere except https://github.com/termux/termux-app. Everyone is able to use it to forge a malicious Termux update installable over the GitHub build. Think twice about installing Termux builds distributed via Telegram or other social media. If your device get caught by malware, we will not be able to help you.

The test key shall not be used to impersonate @termux and can't be used for this anyway. This key is not trusted by us and it is quite easy to detect its use in user generated content.

Alias name: alias
Creation date: Oct 4, 2019
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=APK Signer, OU=Earth, O=Earth
Issuer: CN=APK Signer, OU=Earth, O=Earth
Serial number: 29be297b
Valid from: Wed Sep 04 02:03:24 EEST 2019 until: Tue Oct 26 02:03:24 EEST 2049
Certificate fingerprints:
         SHA1: 51:79:55:EA:BF:69:FC:05:7C:41:C7:D3:79:DB:BC:EF:20:AD:85:F2
         SHA256: B6:DA:01:48:0E:EF:D5:FB:F2:CD:37:71:B8:D1:02:1E:C7:91:30:4B:DD:6C:4B:F4:1D:3F:AA:BA:D4:8E:E5:E1
Signature algorithm name: SHA1withRSA (disabled)
Subject Public Key Algorithm: 2048-bit RSA key
Version: 3

Google Play Store (Experimental branch)

There is currently a build of Termux available on Google Play for Android 11+ devices, with extensive adjustments in order to pass policy requirements there. This is under development and has missing functionality and bugs (see here for status updates) compared to the stable F-Droid build, which is why most users who can should still use F-Droid or GitHub build as mentioned above.

Currently, Google Play will try to update installations away from F-Droid ones. Updating will still fail as sharedUserId has been removed. A planned 0.118.1 F-Droid release will fix this by setting a higher version code than used for the PlayStore app. Meanwhile, to prevent Google Play from attempting to download and then fail to install the Google Play releases over existing installations, you can open the Termux apps pages on Google Play and then click on the 3 dots options button in the top right and then disable the Enable auto update toggle. However, the Termux apps updates will still show in the PlayStore app updates list.

If you want to help out with testing the Google Play build (or cannot install Termux from other sources), be aware that it's built from a separate repository (https://github.com/termux-play-store/) - be sure to report issues there, as any issues encountered might very well be specific to that repository.

Uninstallation

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

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

Community

All community links are available here.

The main ones are the following.

• Termux Reddit community
• Termux User Matrix Channel (Gitter)
• Termux Dev Matrix Channel (Gitter)
• Termux X (Twitter)
• Termux Support Email

Wikis

• Termux Wiki
• Termux App Wiki
• Termux Packages Wiki

Miscellaneous

• FAQ
• Termux File System Layout
• Differences From Linux
• Package Management
• Remote Access
• Backing up Termux
• Terminal Settings
• Touch Keyboard
• Android Storage and Sharing Data with Other Apps
• Android APIs
• Moved Termux Packages Hosting From Bintray to IPFS
• Running Commands in Termux From Other Apps via
  RUN_COMMAND
  intent
• Termux and Android 10

Terminal

Debugging

You can help debug problems of the

The plugin apps do not execute the commands themselves but send execution intents to

Once log levels have been set, you can run the

Moreover, users can generate termux files

Users must post complete report (optionally without sensitive info) when reporting issues. Issues opened with (partial) screenshots of error reports instead of text will likely be automatically closed/deleted.

Log Levels

• Off
  - Log nothing.
• Normal
  - Start logging error, warn and info messages and stacktraces.
• Debug
  - Start logging debug messages.
• Verbose
  - Start logging verbose messages.

For Maintainers and Contributors

The termux-shared library was added in

The main Termux constants are defined by

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.

The

Commit Messages Guidelines

Commit messages must use the Conventional Commits spec so that chagelogs as per the Keep a Changelog spec can automatically be generated by the

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Only the

• 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.

Forking

• Check
  TermuxConstants
  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 building bootstrap, here and here.
• Currently, not all plugins use
  TermuxConstants
  from
  termux-shared
  library and have hardcoded
  com.termux
  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.