termux-app-store 0.2.6

The first offline-first, source-based TUI package manager built natively for Termux

Termux App Store

The first offline-first, source-based TUI package manager built natively for Termux.

Offline-first  •  Source-based  •  Binary-safe  •  Termux-native

---

What is Termux App Store?

Termux App Store is a TUI (Terminal User Interface) built with Python (Textual) and CLI that lets Termux users browse, build, and manage tools/apps directly on Android — no account, no telemetry, no cloud dependency.

[!IMPORTANT] Termux App Store is not a centralized binary repository and not a hidden auto-installer. All builds run locally, transparently, and under full user control.

---

Who Is It For?

User	Use Case
Termux Users	Full control over builds & packages
Developers	Distribute tools via source-based packaging
Reviewers & Auditors	Review and validate build scripts
Maintainers	Manage multiple Termux packages at once

---

Screenshots

Tui Interface

TUI Main Interface	TUI Install Interface	Menu Palette
TUI main menu	Package install process	Command palette

TUI User-friendly with full touchscreen support

---

CLI Interface

Other tools support	CLI Install Interface	CLI View Interface
tasctl and termux-build	Package install process	CLI help, list and show

---

GuideBook

List menu	Menu about	Menu how to upload
GuideBook main menu	Information termux-app-store	Guide how to upload

GuideBook is a information, run: python guidebook.py

---

Screenrecord

Record termux-app-store TUI, CLI, Other tool tasctl, termux-build, guidebook.py

---

Quick Install and Uninstall

Option 1 (Recommended)

pkg install python
pip install termux-app-store

Option 2 (Manual)

Simple (Recommended for not download high memory)

curl -fsSL https://raw.githubusercontent.com/djunekz/termux-app-store/master/tasctl | bash -s install

or

With git clone (For download full files repository)

git clone https://github.com/djunekz/termux-app-store
cd termux-app-store
bash install.sh

or

git clone https://github.com/djunekz/termux-app-store
cd termux-app-store
./tasctl install

After download and install then run:

termux-app-store        # Open interactive TUI
termux-app-store -h     # Show CLI help

---

Uninstall

pip uninstall termux-app-store

or

./tasctl uninstall

---

Usage

TUI — Interactive Interface

termux-app-store

CLI — Direct Commands

termux-app-store list                  # List all packages
termux-app-store show <package>        # Show package details
termux-app-store install <package>     # Build & install a package
termux-app-store update                # Check for available updates
termux-app-store upgrade               # Upgrade all packages
termux-app-store upgrade <package>     # Upgrade a specific package
termux-app-store version               # Check latest version
termux-app-store help                  # Full help

---

Features

Package Browser (TUI) Browse packages from the packages/ folder interactively with keyboard & touchscreen navigation. Smart Build Validator Detects unsupported Termux dependencies with automatic status badges. Real-time Search & Filter Instantly search packages by name or description — no reload needed. One-Click Build Install or update a package in one click via build-package.sh.

One-Click Validator Validate packages before distribution via ./termux-build. One-Click Manage Install / update / uninstall Termux App Store itself via ./tasctl. Self-Healing Path Resolver Auto-detects app location even if the folder is moved or renamed. Privacy-First No account, no tracking, no telemetry — fully offline.

---

Package Status Badges

Badge	Description
NEW	Newly added package (< 7 days)
UPDATE	A newer version is available
INSTALLED	Installed version is up-to-date
UNSUPPORTED	Dependency not available in Termux

---

Adding a Package

Every package must have a build.sh file:

packages/<tool-name>/build.sh

Minimal build.sh Template

TERMUX_PKG_HOMEPAGE=""
TERMUX_PKG_DESCRIPTION=""
TERMUX_PKG_LICENSE=""
TERMUX_PKG_MAINTAINER="@your-github-username"
TERMUX_PKG_VERSION=""
TERMUX_PKG_SRCURL=""
TERMUX_PKG_SHA256=""

[!NOTE] See the full template in template/build.sh or run: ./termux-build template

Adding a Package using termux-build

Open directory termux-app-store

cd termux-app-store

Then run

./termux-build create nameyourtool

[!NOTE] When naming, do not use spaces, use the - sign in the name. For example: this-is-my-tool

---

termux-build — Build package and Validation Tool

termux-build is a validation and reviewer helper tool — not an auto-upload or auto-publish tool.

./termux-build create <package>      # Create package for distribution
./termux-build lint <package>        # Lint a build script
./termux-build init <url-repo>       # Auto create and build package for distribution
./termux-build check-pr <package>    # Check PR readiness
./termux-build doctor                # Diagnose environment
./termux-build suggest <package>     # Get improvement suggestions
./termux-build explain <package>     # Detailed package explanation
./termux-build template              # Generate build.sh template
./termux-build guide                 # Contribution guide

[!NOTE] termux-build only reads and validates — it does not modify files, or upload to GitHub.

tasctl — Termux App Store Controller

tasctl is a controller termux-app-store system

./tasctl install       # Install Termux App Store (latest)
./tasctl update        # Update to latest version
./tasctl uninstall     # Remove Termux App Store
./tasctl doctor        # Diagnose environment
./tasctl self-update   # Update tasctl itself
./tasctl help          # Show this help

guidebook — All Information Termux App Store

guidebook.py is a information use, build, contributing to Termux App Store

python guidebook.py

[!NOTE] guidebook currently only supports two languages: English and Indonesia

---

Architecture

termux-app-store/
├── packages/              # All packages directory
│   └── <tool-name>/
│       └── build.sh       # Metadata & build script
├── template/
│   └── build.sh           # Package template
├── tasctl                 # TAS installer/updater/uninstaller
├── termux-build           # Validation & review tool
└── install.sh             # Main installer

Full details: ARCHITECTURE

---

Security & Privacy

Security No extra permissions required No network ports opened No background services running Builds only run on explicit user command

Privacy No account or registration No analytics or tracking No telemetry of any kind Offline-first by design

Full details: SECURITY  |  PRIVACY  |  DISCLAIMER

---

Upload Your Tool to Termux App Store

Want to share your tool with the Termux community?

Benefits of uploading:

• Your tool becomes available to all Termux users
• Updates only require changing version and sha256 in build.sh
• Your tool appears in the TUI with automatic status badges

How to upload:

# 1. Fork this repo
# 2. Add your package folder:
mkdir packages/your-tool-name
# 3. Create build.sh from the template or with termux-build
# 4. Validate with termux-build:
./termux-build lint packages/your-tool-name
# 5. Submit a Pull Request

Full guide: How to upload package in termux-app-store

---

Contributing

All contributions are welcome!

How to Contribute	Description
Add a package	Submit a new tool package
Report a bug	Open an issue on GitHub
Send a PR	Code or documentation improvements
Review PRs	Help validate others' contributions
Security audit	Review build script security
Improve docs	Clarify or translate documentation

Full guide: CONTRIBUTING

---

Help & Documentation

Document	Description
FAQ	Frequently asked questions
TROUBLESHOOTING	Solutions to common problems
HOW TO UPLOAD	How to upload your tool
CONTRIBUTING	Contribution guide
SUPPORT	How to get support

---

Philosophy

"Local first. Control over convenience. Transparency over magic."

Termux App Store is built for users who want to:

• Fully understand what runs on their device
• Control builds and sources directly
• Avoid vendor lock-in and cloud dependency
• Share tools openly with the Termux community

---

License

This project is licensed under the MIT License — see LICENSE for details.

---

Maintainer

Djunekz — Independent & Official Developer

---

Support This Project

If Termux App Store has been useful to you:

• Star this repo — helps others discover it
• Share it in Termux & Android communities
• Report bugs via Issues
• Submit a PR for any improvement

---

Star History

---

© Termux App Store — Built for everyone, by the community.

termux · termux app store · termux package manager · termux tui · android terminal tools · termux tools · termux packages · termux cli