Motrix 下载技能

通过 Motrix 的 JSON-RPC 接口添加下载任务，支持多线程下载和断点续传。

前置条件

• Motrix 已安装在 /Applications/Motrix.app
• Motrix 需要运行中（技能会自动启动）

使用方法

1. 确保 Motrix 运行

open -a Motrix
sleep 2

2. 添加下载任务

使用 JSON-RPC 调用 aria2 接口：

curl -s -X POST http://127.0.0.1:16800/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "aria2.addUri",
    "params": [
      "token:motrix",
      ["<下载URL>"],
      {"dir": "<保存目录>", "out": "<文件名>"}
    ]
  }'

3. 查询下载状态

curl -s -X POST http://127.0.0.1:16800/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1", 
    "method": "aria2.tellActive",
    "params": ["token:motrix"]
  }'

4. 查询下载进度（指定 GID）

curl -s -X POST http://127.0.0.1:16800/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "aria2.tellStatus",
    "params": ["token:motrix", "<GID>", ["status", "totalLength", "completedLength", "downloadSpeed"]]
  }'

快捷脚本

使用 scripts/download.sh 快速下载：

bash scripts/download.sh "<URL>" "<保存目录>" "<文件名>"

常用操作

返回值说明

添加下载成功后返回 GID（任务ID），例如：

{"id":"1","jsonrpc":"2.0","result":"379b28c278b4af54"}

可用此 GID 查询下载进度或管理任务。