Termux:API v0.53.0

Termux:API是一款功能强大的附加组件，它能把Termux终端模拟器的功能拓展到安卓系统本身。打个比方，Termux:API就如同连接安卓手机和Termux丰富软件生态的“粘合剂”。它让你可以借助命令行直接和手机互动，能够将那些重复且耗时的任务自动化，进而显著提升效率。

借助 Termux:API 工具，你能够通过脚本对手机的多项功能进行操控。比如，你可以通过命令行发送通知消息、获取 GPS 定位信息、扫描二维码内容、读取或修改剪贴板数据，还能控制手电筒的开关以及振动器的启停。尤为重要的是，你可以灵活组合运用这些命令，来定制安卓设备的各类高级功能，这极大地拓展了 Termux 的应用范围。此外，Termux:API 无需获取 root 权限，它依托安卓系统提供的标准公共 API 与权限机制，让非 root 用户也能访问并控制设备的多种功能，有需求的用户可在本站免费使用该工具。

功能特色

1、连接手机硬件与命令行：

它能让你的终端脚本直接访问并控制安卓设备的硬件功能，像摄像头、GPS以及手电筒之类的都包含在内。

2、实现系统自动化：

它能让你借助命令行来完成那些原本得手动操作的任务，像发送通知、读写剪贴板或者获取电池信息之类的，进而达成任务自动化的目标。

3、整合虚拟环境与主机：

它就像一座连接Termux里运行的Linux或其他虚拟环境与安卓手机系统的桥梁，使得虚拟机中的程序也能够和手机展开交互。

Termux:API命令大全

1、获取电池状态：

借助 `termux-battery-status` 命令，能够获取设备电池的电量、充电状态以及温度等方面的详细信息。

2、控制屏幕亮度：

`termux-brightness` 支持你借助命令行来调整屏幕亮度，其数值范围处于 0 至 255 之间。

3、读写剪贴板：

借助 `termux-clipboard-get` 与 `termux-clipboard-set` 这两个工具，你能够在终端脚本里轻松实现对系统剪贴板内容的获取或是设置操作。

4、显示系统通知：

`termux-notification` 能够在 Android 系统的通知栏里展示自定义通知，可支持设置标题、内容、图标等元素。

5、获取设备位置：

借助 `termux-location` 命令，能够获取设备的 GPS 定位信息或者网络定位信息。

6、控制手电筒和振动：

`termux-torch` 与 `termux-vibrate` 这两个工具，能够让用户借助命令行来实现对设备手电筒开关状态的控制，以及对振动器的操控。

7、发送短信：

`termux-sms-send` 能够让你借助命令行给指定号码发送短信，这在自动化任务中十分实用。

8、访问联系人列表：

`termux-contact-list` 能够列出设备上的全部联系人信息。

9、拍照和访问摄像头：

`termux-camera-photo` 能够让你借助命令行拍摄照片，并将其保存到你指定的文件中。

10、显示对话框：

`termux-dialog` 系列命令能够创建文本输入框、确认框、列表选择框等多种弹出式对话框，以便在脚本里实现与用户的交互。

Termux:API使用教程

1、前期准备与安装

在使用 Termux:API 之前，你需要安装终端：

Termux：这是你的终端模拟器，本站可

2、核心软件包安装

打开 Termux 后，输入下方命令安装 Termux:API 的核心软件包，该软件包整合了所有可用于操控 Android 功能的命令行工具。

pkg install termux-api

3、授予必要的权限

这是最关键的一步。Termux:API 必须获取对应的Android权限才能正常运行，你可以借助以下命令进行授权：

存储权限是最基础的权限，作用是访问设备的内部和外部存储。执行这条命令后，系统会弹出权限请求窗口，需要你手动进行允许操作。

termux-setup-storage

其他特定权限说明如下：若要使用定位、摄像头这类功能，你可以手动前往“系统设置”→“应用”→“Termux:API”→“权限”路径进行授予。另外，在你首次执行相关命令时，系统也会弹出权限请求提示供你操作。

4、第一个实用范例：发送通知

我们可以从一个简单的例子入手，借助 `termux-notification` 命令来发送一条通知。

termux-notification --title "Hello Termux:API" --content "这是我的第一个通知，来自命令行！"

执行这条命令后，你的通知栏会马上弹出一条新通知，标题是“Hello Termux:API”，通知内容则是你预先设置好的文字。

更新日志

v0.53.0版本

已修复BatteryStatusAPI中因null Integer转换为batteryCurrentNow int类型时引发的NullPointerException问题，且该场景下不再输出null值。

详细信息

• 文件大小：3.77MB
• 当前版本：v0.53.0
• 上线时间：2026-01-20 07:55:08