Komut satırı ve otomasyon

MDM, penceresi olmadan üç şekilde çalıştırılabilir:

• Uygulamanın kendi komut satırı, IDM'ninkiyle aynı anahtarlar: çalışan uygulamaya bir betikten, toplu iş dosyasından veya başka bir programdan bir indirme görevi verin.
• misterdownloadmanager-cli, ayrı bir komut satırı aracı: uygulamayı kullanmadan, ilerlemeyi göstererek terminalde dosyaları, videoları ve torrentleri indirin.
• Otomasyon API'si: diğer programlar, çalışan uygulamanın indirmelerini (JSON olarak) listeler ve yerel, belirteç korumalı bir kanal üzerinden duraklatır, başlatır, kaldırır veya siler. Yapay zeka asistanları bunu MDM'nin MCP sunucusu aracılığıyla kullanır: Yapay zeka asistanları bölümüne bakın.

Örneklerde Windows yolları kullanılmıştır; macOS ve Linux'ta programlar .exe olmadan aynı adlara sahiptir.

Uygulamanın komut satırı

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

Anahtarlar her durumda / veya - ile başlayabilir. MDM çalışıyorsa, komut ona gider; değilse, MDM başlar ve onu yürütür. Örneğin:

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

MDM'nin her indirmesiyle birlikte, uygulamanın yanında gelir (yükleyici onu MDM'nin klasörüne koyar). Kendi başına çalışır: status ve api dışında uygulamanın çalışmasına gerek yoktur.

misterdownloadmanager-cli help <command>tüm seçenekleri gösterir. Başarısız olan bir komut (uygulama çalışmıyor, hata ile yanıt veriyor, bir indirme bozuluyor) 1 koduyla çıkar. Örneğin:

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

Betikler ve programlar için JSON

--json ile (komuttan önce veya sonra), her komut metin yerine JSON çıktısı verir, her satırda bir nesne olacak şekilde, betiklerin ve yapay zeka ajanlarının okuması için:

Boyutlar bayt cinsindendir (null bilinmiyorken), hızlar saniyedeki bayt cinsindendir. Bir hata {"error": "…"} çıktısı verir ve 1 koduyla çıkar. Örneğin:

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}

Otomasyon API'si

Diğer programlar, çalışan uygulamaya ne indirdiğini sorabilir ve indirmeleri duraklatabilir, başlatabilir, kaldırabilir veya silebilir. API varsayılan olarak kapalıdır; misterdownloadmanager-cli api on ile açın (ve api off ile kapatın).

Bir program MDM ile nasıl konuşur

1. Çalışırken, MDM 127.0.0.1'in bir portunu dinler (yalnızca bu bilgisayar) ve portu ile gizli bir jetonu veri klasörüne ipc.json yazar: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - Taşınabilir bir kopya: programın yanında data\ipc.json.

Jeton her başlangıçta değişir; yalnızca veri klasörünüzü okuyabilen programlar (sizinkiler) kullanabilir. 2. O porta bağlanın ve bir satır JSON gönderin: jeton ve komutun alanları, örn. {"token": "<token>", "query": "list"}. 3. MDM bir satırla yanıt verir: bir komut için ok veya bir soru için bir JSON nesnesi.

Ne anlar

Bilinmeyen bir soru veya eylem {"error": "…"} ile yanıtlanır, API kapalıyken bir soru da öyle (o zaman programların kontrol etmesi için "code": "api-off" ile: hata metni değişebilir). Yanlış bir jeton denied ile yanıtlanır.

Her istek ve yanıt, alan alan, bir JSON Şeması'nda açıklanmıştır: automation-api.schema.json (ayrıca https://misterdownloadmanager.com/automation-api.schema.json adresinde). Uygulamanın yanıt verdiği koddan yapılmıştır, bu yüzden doğru kalır; programlar gönderdiklerini ve okuduklarını buna göre kontrol edebilir veya türlerini bundan oluşturabilir.

Örnekler

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

Bunun yerine bir indirme eklemek için {"token": "…", "url": "https://example.com/a.zip", "silent": true} gönderin.