dhizuku-cli

Dhizuku Device Owner command-line client over TCP with TOTP authentication.

A Python client that talks to the dhizuku-cli Android server app, executes Device Owner commands via Dhizuku.

---

English

About

This is the Python client for dhizuku-cli.

It communicates with the Android server app over TCP, using TOTP for authentication and AES-GCM for encryption. The server app executes Device Owner commands via Dhizuku.

Requirements

• Python 3.6+
• cryptography library
• The Android server app running on your device

Installation

pip install dhizuku-cli

Quick Start

1. Install the Android server app from Releases.

2. Open the app, tap Check Dhizuku, then Start TCP Service.

3. Copy the key shown in the app and save it:

   echo "" > ~/.dcli_key

4. Run a command:

   dcli ping dcli lock_now dcli hide com.example.app

Commands

Command	Argument	Description
ping	—	Test connection
lock_now	—	Lock the screen
hide	package	Hide an app
unhide	package	Unhide an app
suspend	package	Suspend an app
resume	package	Resume an app
block_uninstall	package	Block uninstall
unblock_uninstall	package	Allow uninstall

Options

--host, -H <ip>    Server IP (default 127.0.0.1)
--                 Stop option parsing
--help, -h         Show help

LAN Mode

To control from another device on the same network:

1. In the app, change bind address to LAN (0.0.0.0)

2. On the client:

   dcli --host 192.168.1.100 ping

   Or set once:

   echo "192.168.1.100" > ~/.dcli_host

Configuration

File	Content
~/.dcli_key	TOTP shared key
~/.dcli_host	Server IP (optional)
DCLI_KEY	Env var for key
DCLI_HOST	Env var for host

Priority: command-line > env var > current dir file > home dir file > default.

Security

• The TOTP key is the only credential. Keep it safe.
• All messages are encrypted with AES-GCM.
• Do not enable LAN mode on untrusted networks.

---

简体中文

关于

这是 dhizuku-cli 的 Python 客户端。

它通过 TCP 与 Android 服务端通信，用 TOTP 做认证，用 AES-GCM 加密。 服务端通过 Dhizuku 执行 Device Owner 命令。

依赖

• Python 3.6+
• cryptography 库
• 设备上运行的服务端 App

安装

pip install dhizuku-cli

快速开始

1. 从 Releases 下载并安装 Android 服务端。

2. 打开 App，点检测 Dhizuku，再点启动 TCP 服务。

3. 复制 App 里显示的密钥，写入文件：

   echo "<App 里的密钥>" > ~/.dcli_key

4. 执行命令：

   dcli ping dcli lock_now dcli hide com.example.app

命令列表

命令	参数	说明
ping	无	测试连接
lock_now	无	立即锁屏
hide	包名	隐藏应用
unhide	包名	取消隐藏
suspend	包名	挂起应用
resume	包名	恢复挂起
block_uninstall	包名	阻止卸载
unblock_uninstall	包名	允许卸载

选项

--host, -H <ip>    服务端 IP（默认 127.0.0.1）
--                 停止解析后续选项
--help, -h         显示帮助

局域网模式

要从同网络的其他设备控制：

1. 在 App 里把监听地址改成局域网 (0.0.0.0)

2. 客户端执行：

   dcli --host 192.168.1.100 ping

   或者一次写好：

   echo "192.168.1.100" > ~/.dcli_host

配置

文件	内容
~/.dcli_key	TOTP 共享密钥
~/.dcli_host	服务端 IP（可选）
DCLI_KEY	密钥环境变量
DCLI_HOST	地址环境变量

优先级：命令行 > 环境变量 > 当前目录文件 > HOME 文件 > 默认值。

安全说明

• TOTP 密钥是唯一的认证凭据，请妥善保管。
• 所有消息都经过 AES-GCM 加密。
• 不要在不可信网络上开启局域网模式。

---

License

GPL-3.0. See LICENSE for details.

Copyright (C) 2026 nsyhykui