Wiersz poleceń i automatyzacja

MDM można obsługiwać bez okna na trzy sposoby:

• Wiersz poleceń aplikacji, te same przełączniki co w IDM: przekazanie pobierania do uruchomionej aplikacji ze skryptu, pliku wsadowego lub innego programu.
• misterdownloadmanager-cli, oddzielne narzędzie wiersza poleceń: pobieranie plików, filmów i torrentów w terminalu, z postępem, bez aplikacji.
• API automatyzacji: inne programy wyświetlają listę pobrań uruchomionej aplikacji (jako JSON) oraz wstrzymują, uruchamiają, usuwają lub kasują je za pośrednictwem lokalnego, chronionego tokenem kanału. Asystenci AI używają go za pośrednictwem serwera MCP MDM: zobacz Asystenci AI.

Przykłady używają ścieżek Windows; w systemach macOS i Linux programy mają te same nazwy bez .exe.

Wiersz poleceń aplikacji

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

Przełączniki mogą zaczynać się od / lub -, w dowolnej wielkości liter. Jeśli MDM jest uruchomiony, polecenie trafia do niego; jeśli nie, MDM uruchamia się i wykonuje je. Na przykład:

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

Jest dołączony do każdego pobrania MDM, obok aplikacji (instalator umieszcza go w folderze MDM). Działa samodzielnie: aplikacja nie musi być uruchomiona, z wyjątkiem status i api.

misterdownloadmanager-cli help <command>pokazuje wszystkie opcje. Komenda, która zakończy się niepowodzeniem (aplikacja nie działa, odpowiada błędem, pobieranie zostaje przerwane), kończy działanie z kodem 1. Na przykład:

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 dla skryptów i programów

Z --json (przed lub po komendzie) każda komenda drukuje JSON zamiast tekstu, jeden obiekt na linię, do odczytu przez skrypty i agentów AI:

Rozmiary są w bajtach (null, gdy nieznane), prędkości w bajtach na sekundę. Błąd drukuje {"error": "…"} i kończy działanie z kodem 1. Na przykład:

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 automatyzacji

Inne programy mogą pytać działającą aplikację, co pobiera, oraz wstrzymywać, uruchamiać, usuwać lub kasować pobieranie. API jest domyślnie wyłączone; włącz je za pomocą misterdownloadmanager-cli api on (i wyłącz za pomocą api off).

Jak program komunikuje się z MDM

1. Podczas działania MDM nasłuchuje na porcie 127.0.0.1 (tylko ten komputer) i zapisuje port oraz tajny token do ipc.json w swoim folderze danych: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - Przenośna kopia: data\ipc.json obok programu.

Token zmienia się przy każdym uruchomieniu; tylko programy, które mogą odczytać Twój folder danych (Twój), mogą go używać. 2. Połącz się z tym portem i wyślij jedną linię JSON: token i pola komendy, np. {"token": "<token>", "query": "list"}. 3. MDM odpowiada jedną linią: ok dla komendy lub obiekt JSON dla pytania.

Co rozumie

Nieznane pytanie lub działanie jest odpowiadane {"error": "…"}, podobnie jak pytanie, gdy API jest wyłączone (wtedy z "code": "api-off", aby programy mogły sprawdzić: tekst błędu może się zmienić). Błędny token jest odpowiadany denied.

Każde żądanie i odpowiedź są opisane, pole po polu, w schemacie JSON: automation-api.schema.json (również pod https://misterdownloadmanager.com/automation-api.schema.json). Jest on tworzony z kodu, którym odpowiada aplikacja, więc pozostaje dokładny; programy mogą sprawdzać, co wysyłają i odczytują, lub generować z niego swoje typy.

Przykłady

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

Aby zamiast tego dodać pobieranie, wyślij {"token": "…", "url": "https://example.com/a.zip", "silent": true}.