سطر الأوامر والأتمتة

GDM can be driven without its window in three ways:

• سطر أوامر التطبيق نفسه، ويستخدم مفاتيح التبديل نفسها التي يستخدمها IDM: أرسل عملية تنزيل إلى التطبيق قيد التشغيل من نص برمجي أو ملف دفعي أو برنامج آخر.
• misterdownloadmanager-cli، أداة سطر أوامر منفصلة: تنزيل الملفات ومقاطع الفيديو والتورنت في طرفية، مع إظهار التقدم، بدون التطبيق.
• The automation API: other programs list the running app's downloads (as JSON) and pause, start, remove or delete them, over a local, token-protected channel. AI assistants use it through GDM's MCP server: see AI assistants.

To run the whole app without a window, on a home server or a NAS, see Run GDM on a server (misterdownloadmanager --headless); to control it from a phone, Control GDM from your phone.

تستخدم الأمثلة مسارات Windows؛ في macOS و Linux، البرامج لها نفس الأسماء بدون .exe.

سطر أوامر التطبيق

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

Switches can start with / or -, in any case. If GDM is running, the command goes to it; if not, GDM starts and carries it out. For example:

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

It comes with every download of GDM, next to the app (the installer puts it in GDM's folder). It works on its own: the app needn't run, except for status and 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}

واجهة برمجة تطبيقات الأتمتة

يمكن للبرامج الأخرى أن تسأل التطبيق قيد التشغيل عما يقوم بتنزيله، وإيقاف التنزيلات مؤقتا أو بدءها أو إزالتها أو حذفها. واجهة برمجة التطبيقات معطلة افتراضيا؛ قم بتشغيلها باستخدام misterdownloadmanager-cli api on (وإيقافها باستخدام api off).

How a program talks to GDM

1. While it runs, GDM listens on a port of 127.0.0.1 (this computer only) and writes the port and a secret token to ipc.json in its data folder: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - A portable copy: data\ipc.json next to the program.

The token changes at every start; only programs that can read your data folder (yours) can use it. 2. Connect to that port and send one line of JSON: the token and the command's fields, e.g. {"token": "<token>", "query": "list"}. 3. GDM answers with one line: ok for a command, or a JSON object for a question.

ماذا يفهم

يجاب عن سؤال أو إجراء غير معروف بـ {"error": "…"}، وكذلك عن سؤال عند إيقاف API، حينها تكون الإجابة "code": "api-off" لكي تتمكن البرامج من التحقق؛ فقد يتغير نص الخطأ. ويجاب عن الرمز غير الصحيح بـ denied.

يصف مخطط JSON كل طلب وإجابة، حقلا بحقل: automation-api.schema.json (ومتاح أيضا على https://misterdownloadmanager.com/automation-api.schema.json). ينشأ المخطط من الكود الذي يستخدمه التطبيق للإجابة، لذا يظل دقيقا؛ ويمكن للبرامج استخدامه للتحقق مما ترسله وتقرأه، أو لإنشاء أنواعها منه.

أمثلة

بوويرشيل (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()

بايثون:

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}.