Командний рядок та автоматизація

MDM можна керувати без його вікна трьома способами:

• Власний командний рядок програми, ті самі перемикачі, що й у IDM: передайте завантаження запущеній програмі зі скрипта, пакетного файлу або іншої програми.
• misterdownloadmanager-cli, окремий інструмент командного рядка: завантажуйте файли, відео та торренти в терміналі, з прогресом, без програми.
• API автоматизації: інші програми перераховують завантаження запущеної програми (як JSON) і призупиняють, запускають, видаляють або видаляють їх через локальний, захищений токеном канал. Помічники ШІ використовують його через сервер MCP MDM: дивіться Помічники ШІ.

Приклади використовують шляхи Windows; на macOS та Linux програми мають ті самі назви без .exe.

Командний рядок програми

misterdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]

Перемикачі можуть починатися з / або -, у будь-якому випадку. Якщо MDM запущено, команда надходить до нього; якщо ні, MDM запускається та виконує її. Наприклад:

misterdownloadmanager.exe /d https://example.com/files/report.pdf /p D:\Reports /n
misterdownloadmanager.exe /d https://example.com/big.iso /a
misterdownloadmanager.exe /s

misterdownloadmanager-cli

Він постачається з кожним завантаженням MDM, поруч із програмою (інсталятор поміщає його в папку MDM). Він працює самостійно: програма не повинна працювати, за винятком status та api.

misterdownloadmanager-cli help <command>показує всі параметри. Команда, яка завершується невдачею (програма не запущена, вона відповідає помилкою, завантаження переривається), завершується з кодом 1. Наприклад:

misterdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
misterdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
misterdownloadmanager-cli torrent-get "magnet:?xt=urn:btih:…" --files 0

JSON для скриптів та програм

За допомогою --json (до або після команди) кожна команда виводить JSON замість тексту, один об'єкт на рядок, для читання скриптами та агентами ШІ:

Розміри в байтах (null, якщо невідомо), швидкості в байтах за секунду. При збої виводиться {"error": "…"} і програма завершується з кодом 1. Наприклад:

misterdownloadmanager-cli --json get https://example.com/big.iso -o D:\Downloads
{"event":"progress","downloaded":4194304,"size":1073741824,"speed":52428800,"connections":8,"segments":8}
…
{"event":"done","path":"D:\\Downloads\\big.iso","size":1073741824,"seconds":20.4}

API автоматизації

Інші програми можуть запитувати запущену програму, що вона завантажує, а також призупиняти, запускати, видаляти або видаляти завантаження. API вимкнено за замовчуванням; увімкніть його за допомогою misterdownloadmanager-cli api on (і вимкніть за допомогою api off).

Як програма спілкується з MDM

1. Під час роботи MDM прослуховує порт 127.0.0.1 (лише цей комп'ютер) і записує порт та секретний токен до ipc.json у своїй папці даних: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - Портативна копія: data\ipc.json поруч із програмою.

Токен змінюється при кожному запуску; лише програми, які можуть читати вашу папку даних (вашу), можуть його використовувати. 2. Підключіться до цього порту та надішліть один рядок JSON: токен та поля команди, наприклад {"token": "<token>", "query": "list"}. 3. MDM відповідає одним рядком: ok для команди або об'єктом JSON для запитання.

Що він розуміє

На невідоме запитання або дію відповідає {"error": "…"}, як і на запитання, коли API вимкнено (тоді з "code": "api-off", щоб програми могли перевірити: текст помилки може змінитися). На неправильний токен відповідає denied.

Кожен запит і відповідь описані, поле за полем, у JSON Schema: automation-api.schema.json (також за адресою https://misterdownloadmanager.com/automation-api.schema.json). Вона створена з коду, яким відповідає програма, тому залишається точною; програми можуть перевіряти те, що вони надсилають і читають, або генерувати свої типи з неї.

Приклади

PowerShell (Windows):

$ep = Get-Content "$env:APPDATA\misterdownloadmanager\ipc.json" | ConvertFrom-Json
$client = New-Object Net.Sockets.TcpClient("127.0.0.1", $ep.port)
$stream = $client.GetStream()
$writer = New-Object IO.StreamWriter($stream); $reader = New-Object IO.StreamReader($stream)
$writer.WriteLine((@{ token = $ep.token; query = "list" } | ConvertTo-Json -Compress))
$writer.Flush()
$reader.ReadLine() | ConvertFrom-Json | Select-Object -ExpandProperty downloads | Format-Table file, status, downloaded, size
$client.Close()

Python:

import json, os, socket

ipc = os.path.join(os.environ["APPDATA"], "misterdownloadmanager", "ipc.json")  # see above elsewhere
ep = json.load(open(ipc))
with socket.create_connection(("127.0.0.1", ep["port"])) as s:
    s.sendall((json.dumps({"token": ep["token"], "query": "list"}) + "\n").encode())
    answer = json.loads(s.makefile().readline())
for d in answer["downloads"]:
    print(d["file"], d["status"], d["downloaded"], d["size"])

Натомість, щоб додати завантаження, надішліть {"token": "…", "url": "https://example.com/a.zip", "silent": true}.