Leonid Plyushch a7f8b629a9 update sample script for new package		5 years ago
.github	[ImgBot] Optimize images	6 years ago
disabled-packages	enable package 'build-essential'	6 years ago
ndk-patches	ndk-20 update	6 years ago
packages	vim, vim-python: add support for dpkg alternatives	5 years ago
sample	update sample script for new package	5 years ago
scripts	build-package.sh: export CC_FOR_BUILD for on-device builds	5 years ago
.cirrus.yml	CI: reduce RAM limit to 8 GB	5 years ago
.gitattributes	Update .gitattributes (#872)	8 years ago
.gitignore	Add vagrant (#642)	8 years ago
BACKERS.md	Markdown New Guideline Compliance	6 years ago
LICENSE.md	avoid long lines in LICENSE.md	6 years ago
README.md	move docs to project's wiki pages	5 years ago
build-all.sh	enable on-device builds	5 years ago
build-package.sh	build-package.sh: for on-device builds value of TERMUX_ARCH should not be overridable	5 years ago
clean.sh	enable on-device builds	5 years ago

README.md

Termux packages

This project contains scripts and patches to build packages for the Termux Android application. Note that on-device package building is supported only partially for now.

More information can be found in the project's Wiki.

Directory Structure

disabled-packages: packages that cannot be built or have serious issues.
docs: documentation on how to build, formatting etc.
ndk-patches: patches for Android NDK headers.
packages: all currently available packages.
scripts: utility scripts for building.

Issues

The two most common types of issues are package requests and bug reports. There are already templates available.

You can open an issue for any package or build problems. For example, if you observing crashes or other kind of malfunction, you are certainly welcome to file an issue.

Also, if you want to request a particular package, you may suggest it in an issue. However, be prepared that package may not be available shortly. Bugfixes and improvements take precedence over new packages.

Information for Android 7+ users

If your device running Android OS with version 7 and higher, it is highly recommended to check whether your Termux installation uses our new repository with packages compiled specially for higher Android API levels (24+).

Execute following command:

grep termux-packages-24 $PREFIX/etc/apt/sources.list

It should output the line containing this URL:

https://dl.bintray.com/termux/termux-packages-24/

If not, then it is time to upgrade your installation. This procedure will involve complete erasing of $PREFIX, directory where all packages are installed (aka rootfs) but your home directory will be untouched.

So if you decided to upgrade your installation, do the following steps:

Ensure that application's version is v0.67 or higher. If not - upgrade.
Move all important files, e.g. configs, databases, custom scripts, etc to your $HOME (temporarily). Also, save the list of packages that you will need to reinstall.
Execute rm -rf $PREFIX.
Restart Termux application.
Restore all your stuff saved in step 2.

Pull Requests

We welcome any pull requests. Nevertheless, a log file should be provided in order to show that it is at least working.

All pull requests will be built by Cirrus CI. Usually, it is expected that all tasks will pass. But do not worry if CI build timed out. Alternatively, you can provide build logs by yourself.

Note that it is highly recommended to keep your pull requests up-to-date. If you do not know how to do this, take a look on manpage of git-rebase.

Contacts

General Mailing List: https://groups.io/g/termux
Developer Mailing List: https://groups.io/g/termux-dev
Developer Chat: https://gitter.im/termux/dev or #termux/development on IRC/freenode.

If you are interested in our weekly development sessions, please check the https://wiki.termux.com/wiki/Dev:Development_Sessions. Also, you may want to check the https://wiki.termux.com/wiki/Development.