কমান্ড লাইন এবং অটোমেশন

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 স্কিমাতে বর্ণিত আছে: 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} পাঠান।