136 lines
4.1 KiB
Markdown
136 lines
4.1 KiB
Markdown
# Termux packages
|
|
|
|
[](https://bintray.com)
|
|
|
|
[](https://cirrus-ci.com/termux/termux-packages)
|
|
[](https://gitter.im/termux/termux)
|
|
|
|
This project contains scripts and patches to build packages for the [Termux]
|
|
Android application.
|
|
|
|
There available packages only from main set. We have some additional
|
|
repositories:
|
|
|
|
- https://github.com/termux/game-packages
|
|
|
|
Game packages, e.g. `angband` or `moon-buggy`.
|
|
|
|
- https://github.com/termux/science-packages
|
|
|
|
Science-related packages like `gap` and `gnucap`.
|
|
|
|
- https://github.com/termux/termux-root-packages
|
|
|
|
All packages which usable only on rooted devices. Some stuff available
|
|
here requiring custom kernel (like `aircrack-ng` or `lxc`).
|
|
|
|
- https://github.com/termux/unstable-packages
|
|
|
|
Staging repository. Packages that are not stable available only here. New
|
|
packages most likely will be placed here too.
|
|
|
|
- https://github.com/termux/x11-packages
|
|
|
|
Packages requiring X11 Windowing System.
|
|
|
|
Termux package management quick how-to available on https://wiki.termux.com/wiki/Package_Management.
|
|
To learn about using our build environment, read the [Developer's Wiki].
|
|
|
|
## Project structure
|
|
|
|
There 2 main branches available:
|
|
|
|
- [master] - packages for Android 7.0 or higher.
|
|
|
|
Packages are built automatically by [CI] and published on [Bintray].
|
|
|
|
- [android-5] - packages for Android versions 5.x - 6.x.
|
|
|
|
Packages are built by @fornwall and published on https://termux.net.
|
|
|
|
Directories:
|
|
|
|
- [disabled-packages](disabled-packages/):
|
|
|
|
Packages that cannot be published due to serious issues.
|
|
|
|
- [ndk-patches](ndk-patches/):
|
|
|
|
Our changes to Android NDK headers.
|
|
|
|
- [packages](packages/):
|
|
|
|
Main set of packages.
|
|
|
|
- [sample](sample/):
|
|
|
|
Sample structure for creating new packages.
|
|
|
|
- [scripts](scripts/):
|
|
|
|
Set of utilities and build system scripts.
|
|
|
|
## Contributing
|
|
|
|
### Bug reports
|
|
|
|
Please, use templates for submitting bug reports. The *bug report* issue template
|
|
can be initialized by clicking on https://github.com/termux/termux-packages/issues/new?template=bug_report.md.
|
|
|
|
General requirements for bug reports are:
|
|
|
|
- All packages are up-to-date.
|
|
|
|
- Problem is not related to third-party software.
|
|
|
|
- Output of `termux-info` attached.
|
|
|
|
- Be ready to provide more info if requested.
|
|
|
|
### New packages
|
|
|
|
Use the *package request* template: https://github.com/termux/termux-packages/issues/new?template=package_request.md.
|
|
|
|
General requirements for new packages are:
|
|
|
|
- Packages should be open source and have widely recognised OSS licenses like
|
|
GNU GPL.
|
|
|
|
- Packages should not be installable via language-specific package managers such
|
|
as `gem`, `pip` or `cpan`.
|
|
|
|
- Packages should not be outdated dead projects.
|
|
|
|
- Be ready that your package request will not be processed immediately.
|
|
|
|
## Pull Requests
|
|
|
|
All pull requests are welcome.
|
|
|
|
We use [CI] for processing all pushes including pull requests. All build logs
|
|
and artifacts are public, so you can verify whether your changes work properly.
|
|
|
|
People who are new for packaging can begin with sending PRs for updating
|
|
packages. Check the outdated packages on https://repology.org/projects/?inrepo=termux&outdated=1.
|
|
|
|
Get started with information available on [Developer's Wiki].
|
|
|
|
## 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.
|
|
|
|
[Bintray]: <https://bintray.com/termux/termux-packages-24>
|
|
[CI]: <https://cirrus-ci.com/termux/termux-packages>
|
|
[Developer's Wiki]: <https://github.com/termux/termux-packages/wiki>
|
|
[Termux]: <https://github.com/termux/termux-app>
|
|
[android-5]: <https://github.com/termux/termux-packages/tree/android-5>
|
|
[master]: <https://github.com/termux/termux-packages/tree/master>
|