कमांड लाइन और ऑटोमेशन

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 प्रिंट करता है, प्रति पंक्ति एक ऑब्जेक्ट, स्क्रिप्ट और AI एजेंटों के पढ़ने के लिए:

आकार बाइट्स में हैं (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 से बंद करें)।

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 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()

पायथन:

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} भेजें।