OronBox

命令行工具

桌面端 --nogui 命令行：设备、资源、账号、队列与 JSON 输出

桌面端可以用 --nogui 以命令行方式运行，适合脚本化操作

桌面端有一个后台守护进程统一管理蓝牙连接与任务，命令行和图形界面共用它，不需要手动管理

Linux 上命令行模式同样要求已登录的图形桌面会话；--nogui 只是隐藏窗口，不能在没有显示服务器的 SSH 会话中运行

守护进程

oronbox --nogui daemon start
oronbox --nogui daemon status
oronbox --nogui daemon stop

其他命令会自动启动守护进程（除非指定 --no-autostart）

设备与本地安装

oronbox --nogui device paired
oronbox --nogui device scan --timeout 10
oronbox --nogui device connect AA:BB:CC:DD:EE:FF
oronbox --nogui device info
oronbox --nogui install quickapp ./demo.rpk
oronbox --nogui install watchface ./face.mwz --device AA:BB:CC:DD:EE:FF

使用 --detach 可以将安装加入队列并立即返回任务 ID，配合 --wait 等待任务完成，并根据结果返回对应的退出码

在线资源

oronbox --nogui resource sources
oronbox --nogui resource devices --source bandbbs
oronbox --nogui resource search 关键词 --source bandbbs --filter watchface,free,bandbbs-category:101 --sort time
oronbox --nogui resource list --source astrobox-repo --filter quickapp,hide-paid,hide-force-paid,o65m
oronbox --nogui resource info bandbbs:6751
oronbox --nogui resource download bandbbs:6751
oronbox --nogui resource install bandbbs:6751

--filter 接收逗号分隔的筛选条件：

  • quickapp、watchface、firmware 或 miniprogram：资源类型，一次只能选一种
  • free：只显示免费资源
  • hide-paid：隐藏普通付费资源
  • hide-force-paid：隐藏强制付费资源（主要用于 AstroBox Repo）
  • 其他值：设备或分区 ID，可同时选多个（先用 resource devices --source SOURCE 查询）

--sort random|name|time 设置排序，--page N 与 --page-size N 控制分页

设备内容、账号与设置

oronbox --nogui app list
oronbox --nogui app launch com.example.app
oronbox --nogui app uninstall com.example.app
oronbox --nogui watchface list
oronbox --nogui watchface set FACE_ID
oronbox --nogui watchface remove FACE_ID
oronbox --nogui account list
oronbox --nogui account login amazfit --username user@example.com
oronbox --nogui account logout bandbbs
oronbox --nogui settings list
oronbox --nogui settings set auto_reconnect true

非交互式登录请使用 --password-stdin，不要把密码直接写在命令行参数里

队列、日志与机器可读输出

oronbox --nogui queue list
oronbox --nogui queue get TASK_ID
oronbox --nogui queue wait TASK_ID
oronbox --nogui queue watch
oronbox --nogui queue cancel TASK_ID
oronbox --nogui queue remove TASK_ID
oronbox --nogui queue retry TASK_ID
oronbox --nogui queue start
oronbox --nogui queue pause
oronbox --nogui logs watch
oronbox --nogui --json device status

指定 --json 后，命令结果以 JSON 输出，进度和事件以 JSONL 输出

CLI 退出码：

退出码含义
0成功
2用法或参数无效
3文件错误
4没有合适的设备
5连接失败
6资源校验失败
7安装失败
8守护进程错误
70内部错误

On this page

守护进程设备与本地安装在线资源设备内容、账号与设置队列、日志与机器可读输出