Dòng lệnh và tự động hóa

GDM can be driven without its window in three ways:

• Dòng lệnh của ứng dụng, các tùy chọn giống như của IDM: chuyển một lượt tải xuống cho ứng dụng đang chạy từ một tập lệnh, tệp bó hoặc chương trình khác.
• misterdownloadmanager-cli, một công cụ dòng lệnh riêng biệt: tải xuống tệp, video và torrent trong một thiết bị đầu cuối, có hiển thị tiến độ, mà không cần ứng dụng.
• 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.

Các ví dụ sử dụng đường dẫn của Windows; trên macOS và Linux, các chương trình có cùng tên mà không có .exe.

Dòng lệnh của ứng dụng

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>hiển thị mọi tùy chọn. Lệnh thất bại (ứng dụng không chạy, trả lời bằng lỗi hoặc lượt tải xuống bị gián đoạn) sẽ thoát với mã 1. Ví dụ:

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 cho tập lệnh và chương trình

Với --json (trước hoặc sau lệnh), mọi lệnh đều xuất JSON thay vì văn bản, mỗi dòng một đối tượng, để tập lệnh và tác nhân AI đọc:

Kích thước tính bằng byte (null nếu chưa xác định), tốc độ tính bằng byte mỗi giây. Khi có lỗi, lệnh xuất {"error": "…"} rồi thoát với mã 1. Ví dụ:

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 tự động hóa

Các chương trình khác có thể hỏi ứng dụng đang chạy xem ứng dụng đang tải xuống những gì, cũng như tạm dừng, bắt đầu, gỡ khỏi danh sách hoặc xóa các lượt tải xuống. API tắt theo mặc định; bật bằng misterdownloadmanager-cli api on (và tắt bằng 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.

Các lệnh được hỗ trợ

Câu hỏi hoặc hành động không xác định sẽ nhận được phản hồi {"error": "…"}. Câu hỏi khi API đang tắt cũng nhận được phản hồi này (kèm theo "code": "api-off", để chương trình kiểm tra; nội dung lỗi có thể thay đổi). Mã thông báo không hợp lệ sẽ nhận được phản hồi denied.

Mọi yêu cầu và câu trả lời đều được mô tả chi tiết theo từng trường trong một JSON Schema: automation-api.schema.json (cũng có tại https://misterdownloadmanager.com/automation-api.schema.json). Schema này được tạo từ mã mà ứng dụng dùng để trả lời, nên luôn chính xác. Các chương trình có thể dùng schema này để kiểm tra dữ liệu gửi đi và nhận về, hoặc tạo các kiểu dữ liệu từ schema.

Ví dụ

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"])

Để thêm một lượt tải xuống, hãy gửi {"token": "…", "url": "https://example.com/a.zip", "silent": true}.