djunekz/termux-app-store

GitHub: djunekz/termux-app-store

一个专为 Termux 设计的离线优先 TUI 包管理器，支持从源码构建安装社区安全工具，无需账户且无遥测。

Stars: 18 | Forks: 7

Termux App Store — TUI Package Manager for Termux

# Termux App Store **首个专为 Termux 原生构建的、基于源码的离线优先 TUI 包管理器。** [![CI](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/af76b8ab62110657.svg)](https://github.com/djunekz/termux-app-store/actions) [![Codecov](https://codecov.io/github/djunekz/termux-app-store/branch/master/graph/badge.svg?token=357W4EP8G0)](https://codecov.io/github/djunekz/termux-app-store)
![Version](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fdjunekz%2Ftermux-app-store%2Ftags&query=%24%5B0%5D.name&style=flat&logo=github&color=3fb950&label=release) [![Downloads](https://img.shields.io/github/downloads/djunekz/termux-app-store/total?style=flat&logo=github&color=3fb950&logoColor=white)](https://github.com/djunekz/termux-app-store) [![License](https://img.shields.io/badge/License-MIT-3fb950?style=flat&logo=opensourceinitiative&logoColor=white)](LICENSE)

[![Stars](https://img.shields.io/github/stars/djunekz/termux-app-store?style=flat&logo=github&color=white&label=stars&cacheSeconds=3600)](https://github.com/djunekz/termux-app-store/stargazers) [![Forks](https://img.shields.io/github/forks/djunekz/termux-app-store?style=flat&logo=github&color=white&cacheSeconds=3600)](https://github.com/djunekz/termux-app-store/network)

[![Issues](https://img.shields.io/badge/issues-open-3fb950?style=flat&logo=github&logoColor=white)](https://github.com/djunekz/termux-app-store/issues) [![PRs](https://img.shields.io/github/issues-pr/djunekz/termux-app-store?style=flat&logo=git&logoColor=white&color=3fb950)](https://github.com/djunekz/termux-app-store/pulls) [![Community Ready](https://img.shields.io/badge/Community-Ready-3fb950?style=flat&logo=github)](https://github.com/djunekz/termux-app-store)

## 什么是 Termux App Store？ **Termux App Store** 是一个使用 Python ([Textual](https://github.com/Textualize/textual)) 构建的 **TUI (Terminal User Interface)** 和 CLI，让 Termux 用户可以直接在 Android 设备上**浏览、构建和管理工具/应用** —— 无需账户，无遥测，不依赖云端。 ## 适用人群？ | 用户 | 用途 | |---|---| | 📱 Termux 用户 | 完全掌控构建和包 | | 🛠️ 开发者 | 通过基于源码的打包分发工具 | | 🔍 审查员和审计员 | 审查和验证构建脚本 | | 📦 维护者 | 同时管理多个 Termux 包 | ## 截图

| 主界面 | 安装界面 | 菜单面板 | |:---:|:---:|:---:| | Main Interface

## 快速安装 ``` curl -fsSL https://raw.githubusercontent.com/djunekz/termux-app-store/master/install.sh | bash ``` 然后运行： ``` termux-app-store # Open interactive TUI termux-app-store -h # Show CLI help ``` ## 使用方法 ### TUI — 交互式界面 ``` termux-app-store ``` ### CLI — 直接命令 ``` termux-app-store list # List all packages termux-app-store show # Show package details termux-app-store install # Build & install a package termux-app-store update # Check for available updates termux-app-store upgrade # Upgrade all packages termux-app-store upgrade # Upgrade a specific package termux-app-store version # Check latest version termux-app-store help # Full help ``` ## ✨ 功能特性

**📦 包浏览器 (TUI)** 通过键盘和触摸屏导航，交互式地浏览 `packages/` 文件夹中的包。 **🧠 智能构建验证器** 检测 Termux 不支持的依赖，并自动显示状态徽章。 **🔍 实时搜索与过滤** 按名称或描述即时搜索包 —— 无需重新加载。 **⚡ 一键构建** 通过 `build-package.sh` 一键安装或更新包。

**✅ 一键验证器** 在分发前通过 `./termux-build` 验证包。 **🛠️ 一键管理** 通过 `./tasctl` 安装 / 更新 / 卸载 Termux App Store 本身。 **🧬 自修复路径解析器** 即使文件夹被移动或重命名，也能自动检测应用位置。 **🔐 隐私优先** 无账户，无跟踪，无遥测 —— 完全离线。

## 包状态徽章 | 徽章 | 描述 | |---|---| | **NEW** | 新添加的包（< 7 天） | | **UPDATE** | 有新版本可用 | | **INSTALLED** | 已安装的版本是最新版 | | **UNSUPPORTED** | 依赖在 Termux 中不可用 | ## 🧩 添加包每个包**必须**包含一个 `build.sh` 文件： ``` packages//build.sh ``` ### 最小化 `build.sh` 模板 ``` TERMUX_PKG_HOMEPAGE="" TERMUX_PKG_DESCRIPTION="" TERMUX_PKG_LICENSE="" TERMUX_PKG_MAINTAINER="@your-github-username" TERMUX_PKG_VERSION="" TERMUX_PKG_SRCURL="" TERMUX_PKG_SHA256="" ``` ## 🛠️ termux-build — 验证工具 **termux-build** 是一个验证和审查辅助工具 —— 而不是自动上传或自动发布工具。 ``` ./termux-build lint # Lint a build script ./termux-build check-pr # Check PR readiness ./termux-build doctor # Diagnose environment ./termux-build suggest # Get improvement suggestions ./termux-build explain # Detailed package explanation ./termux-build template # Generate build.sh template ./termux-build guide # Contribution guide ``` ## 架构 ``` termux-app-store/ ├── packages/ # All packages directory │ └── / │ └── build.sh # Metadata & build script ├── template/ │ └── build.sh # Package template ├── tasctl # TAS installer/updater/uninstaller ├── termux-build # Validation & review tool └── install.sh # Main installer ``` ## 🔐 安全与隐私

**🔐 安全** - 无需额外权限 - 未开放网络端口 - 无后台服务运行 - 构建仅在用户明确指令下运行

**🛡️ 隐私** - 无需账户或注册 - 无分析或跟踪 - 无任何形式的遥测 - 设计上优先离线

## 上传你的工具到 Termux App Store 想把你的工具分享给 Termux 社区吗？ **上传的好处：** - 你的工具将对所有 Termux 用户可用 - 更新只需修改 `build.sh` 中的 `version` 和 `sha256` - 你的工具会出现在 TUI 中，并自动显示状态徽章 **如何上传：** ``` # 1. Fork 这个 repo # 2. 添加你的 package folder： mkdir packages/your-tool-name # 3. 从 template 创建 build.sh # 4. 使用 termux-build 进行验证： ./termux-build lint packages/your-tool-name # 5. 提交 Pull Request ``` ## ❓ 帮助与文档 | 文档 | 描述 | |---|---| | [FAQ.md](FAQ.md) | 常见问题解答 | | [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | 常见问题解决方案 | | [HOW_TO_UPLOAD.md](HOW_TO_UPLOAD.md) | 如何上传你的工具 | | [CONTRIBUTING.md](CONTRIBUTING.md) | 贡献指南 | | [SUPPORT.md](SUPPORT.md) | 如何获取支持 | ## 🧠 理念 Termux App Store 是为那些希望： - 完全了解在其设备上运行内容的用户 - 直接控制构建和源码 - 避免厂商锁定和云依赖 - 与 Termux 社区公开分享工具 ## 📜 许可证本项目基于 **MIT License** 授权 —— 详见 [LICENSE](LICENSE)。 ## 👤 维护者

**Djunekz** — 独立且官方开发者 [![GitHub](https://img.shields.io/badge/GitHub-djunekz-3fb950?style=for-the-badge&logo=github)](https://github.com/djunekz)

## ⭐ 支持本项目如果 Termux App Store 对你有用： - ⭐ **Star** 本仓库 —— 帮助其他人发现它 - 🧩 在 Termux 和 Android 社区中**分享**它 - 🐛 通过 Issues **报告 Bug** - 🔀 **提交 PR** 进行任何改进 ## ⭐ Star 历史 [![Star History Chart](https://api.star-history.com/image?repos=djunekz/termux-app-store&type=date&legend=top-left)](https://www.star-history.com/?repos=djunekz%2Ftermux-app-store&type=date&legend=top-left)

标签：Android, Awesome, CLI, Cutter, DSL, SHA256校验, Termux, TUI, WiFi技术, 二进制发布, 包管理器, 应用商店, 应用安全, 开源工具, 数据集, 极客, 源码编译, 目录枚举, 离线安装, 移动安全, 系统管理, 终端, 统一API, 网络安全, 网络调试, 自动化, 逆向工具, 隐私保护