termux / termux-app

# 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 **`repository is under maintenance or down`** errors when running `apt` or `pkg` commands.
**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 `[Process completed (signal 9) - press Enter]` message in the terminal without actually exiting the shell process yourself. Check the related issue #2366, issue tracker, phantom cached and empty processes docs and this TLDR comment on how to disable trimming of phantom and excessive cpu usage processes. A proper docs page will be added later. An option to disable the killing should be available in Android 12L or 13, so upgrade at your own risk if you are on Android 11, specially if you are not rooted.
***
## Contents
- Termux App and Plugins
- Installation
- Uninstallation
- Important Links
- Debugging
- For Maintainers and Contributors
- Forking
- Sponsors and Funders
##
## 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 `v0.118.3`.
**NOTICE: It is highly recommended that you update to `v0.118.0` or higher ASAP for various bug fixes, including a critical world-readable vulnerability reported here. See below for information regarding Termux on Google Play.**
Termux can be obtained through various sources listed below for **only** Android `>= 7` with full support for apps and packages.
Support for both app and packages was dropped for Android `5` and `6` on 2020-01-01 at `v0.83`, however it was re-added just for the app *without any support for package updates* on 2022-05-24 via the GitHub sources. Check here for the details.
The APK files of different sources are signed with different signature keys. The `Termux` app and all its plugins use the same `sharedUserId` `com.termux` 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 `F-Droid` and another one from a different source like `GitHub`. 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`, `INSTALL_FAILED_UPDATE_INCOMPATIBLE`, `INSTALL_FAILED_SHARED_USER_IN