Dannex Download Manager
  1. Strona główna
  2. Pomoc
  3. Wiersz poleceń i automatyzacja

Wiersz poleceń i automatyzacja

DDM 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.
  • dannexdownloadmanager-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 DDM: zobacz Asystenci AI.

Aby uruchomić całą aplikację bez okna, na serwerze domowym lub NAS, zobacz Uruchamianie DDM na serwerze (dannexdownloadmanager --headless); aby sterować nią z telefonu, Sterowanie DDM z telefonu.

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

Wiersz poleceń aplikacji

dannexdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
Przełącznik Działanie
/d URL Adres do pobrania.
/p folder Zapisz w tym folderze (w przeciwnym razie w folderze kategorii z Opcje → Zapisz w).
/f name Zapisz pod tą nazwą.
/a Dodaj do głównej kolejki pobierania bez uruchamiania.
/n Cichy: brak okna Informacje o pliku do pobrania, pobieranie rozpoczyna się (lub jest kolejkowane, z /a) natychmiast.
/s Uruchom główną kolejkę pobierania.
/exit Zapisz i zamknij uruchomioną aplikację (instalator używa tego przed aktualizacją).
/startup Uruchom w obszarze powiadomień, z ukrytym oknem: tak Uruchom Dannex Download Manager przy starcie systemu uruchamia DDM po zalogowaniu. Tam, gdzie ikona DDM nie jest widoczna w obszarze powiadomień (niektóre pulpity Linux), DDM uruchamia się zminimalizowany. Działający DDM pozostaje w swoim stanie.
plik .torrent lub link magnet: Otwórz w Dodaj torrent (co Windows przekazuje, gdy DDM otwiera torrenty).

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

dannexdownloadmanager.exe /d https://example.com/files/report.pdf /p D:\Reports /n
dannexdownloadmanager.exe /d https://example.com/big.iso /a
dannexdownloadmanager.exe /s

dannexdownloadmanager-cli

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

Polecenie Działanie
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] Pobiera plik, używając do 8 połączeń (-c, od 1 do 128), pokazując postęp. Ctrl+C wstrzymuje pobieranie; resume wznawia. --checksum sprawdza ukończony plik: hex MD5, SHA-1, SHA-256, SHA-512 lub CRC32, opcjonalnie nazwany (sha256:…). --dns wybiera DNS: system (domyślny); usługę i sposób zapytania, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; adresy serwerów DNS, 9.9.9.9,149.112.112.112; lub adres DNS-over-HTTPS. Nigdy nie wraca do systemowego DNS. --adapter wysyła każde połączenie przez jeden adapter sieciowy, po jego nazwie (Ethernet, wg0) lub jednym z jego adresów; gdy nie jest podłączony, nic nie jest wysyłane, a pobieranie kończy się niepowodzeniem. Link z hosta plików, który obsługuje jedno z twoich kont debrid (Opcje → Konta), przechodzi przez to konto, tak jak w aplikacji, a get mówi through Real-Debrid; --direct pobiera sam adres (Konta usług debrid).
resume file.mdm.json [-c connections] [-H ...] [--direct] Wznawia wstrzymane lub przerwane pobieranie z pliku .mdm.json obok. Przez konto debrid, tak jak get: usługa podaje nowy link, gdy stary wygasł; --direct kontynuuje z samego adresu.
install-gallery-dl Instaluje lub aktualizuje gallery-dl dla galerii obrazów: lista sum kontrolnych jest sprawdzana z kluczem podpisu autora, a program z tą listą (Windows i Linux x86-64; w innych systemach zainstaluj samodzielnie).
gallery-get URL [-o folder] [--limit N] [-c N] [--adapter name] Pobierz obrazy z galerii (kategoria Wikimedia Commons, album Flickr, ...) do folderu nazwanego jak galeria, wewnątrz -o: gallery-dl je wylistuje, własny mechanizm pobierania DDM je pobierze, -c naraz (domyślnie 8, tyle co połączeń get); --limit pobiera najwyżej tyle, pierwsze z wylistowanych przez witrynę. Uruchomione ponownie, pobiera tylko nowe. --adapter kieruje swoje połączenia i połączenia gallery-dl przez jedną kartę sieciową, jak dla get.
video-info URL Jakie wideo zawiera strona (YouTube, Vimeo, ...), i dostępne jakości do wyboru.
playlist-info URL [--from N] [--count N] Filmy z playlisty lub kanału, każdy w osobnym wierszu, w kolejności, w jakiej są wymienione: pozycja, długość, tytuł i adres.
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] Pobierz filmy z playlisty lub kanału, jeden po drugim, do folderu nazwanego tak jak lista, wewnątrz -o. -f to jedna jakość dla wszystkich, tak jak dla video-get (domyślnie najlepsza dla każdego filmu; bv*[height<=720]+ba/b[height<=720] = do 720p; ba = oryginalny dźwięk; mp3:320, opus:, flac: tak jak dla video-get). -c tak jak dla video-get.
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] Pobierz film; -f wybiera jakość z video-info (b = najlepszy pojedynczy plik; ba = sam dźwięk, w oryginalnym formacie ze strony, bez konwersji; mp3:320, mp3:256, mp3:192 lub mp3:128 = dźwięk jako MP3 z podaną przepływnością bitów, mp3:0 z najlepszą zmienną przepływnością; opus: = jako Opus; flac: = jako FLAC, bezstratny, ale nie lepszy niż dźwięk ze strony; konwersje wymagają ffmpeg). -c: własny program pobierający DDM pobiera każdy strumień znaleziony przez yt-dlp za pomocą tylu połączeń (domyślnie 8, od 1 do 128), a strumień w częściach (HLS, DASH) w tylu częściach jednocześnie. --subs zapisuje napisy obok: kody języków z video-info (en,fr) lub all dla wszystkich udostępnionych przez przesyłającego; --auto-subs zamiast tego pobiera automatyczne napisy ze strony; --embed-subs umieszcza je w filmie (wymaga ffmpeg, MP4 lub MKV). --adapter wysyła połączenia pobierania oraz yt-dlp (i ffmpeg) przez jeden adapter sieciowy, tak jak dla get; gdy nie jest podłączony, nic się nie uruchamia.
install-ytdlp, install-ffmpeg Zainstaluj lub zaktualizuj pomocników potrzebnych do filmów: yt-dlp (sprawdzane względem klucza podpisu) i ffmpeg (Windows; w systemach macOS i Linux DDM używa systemowych).
torrent-info SOURCE Nazwa torrenta, pliki (numerowane) i rozmiar; SOURCE to link magnet lub plik .torrent.
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] Pobiera torrent lub tylko niektóre z jego plików. Jeśli część plików znajduje się już w folderze, pobieranie zostaje zatrzymane, a nazwy tych plików są wyświetlane; --use-existing używa ich zamiast pobierać je ponownie (pasujące pliki zostają zachowane, a pozostałe są pobierane).
torrent-create PATH -o file.torrent Utwórz .torrent pliku lub folderu (użytkownicy znajdują go przez DHT).
status Pobrania w działającej aplikacji w formacie JSON wraz z ich identyfikatorami (API automatyzacji musi być włączone).
pause ID..., start ID... Wstrzymuje aktywne pobierania lub uruchamia (wznawia) zatrzymane, oczekujące lub nieudane pobierania w działającej aplikacji.
remove ID..., delete ID... Usuwa pobieranie z listy aktywnej aplikacji: remove zachowuje pliki, delete usuwa je również. Aktywne pobieranie jest najpierw wstrzymywane (pause).
api on, api off Włącza lub wyłącza API automatyzacji w działającej aplikacji.

dannexdownloadmanager-cli help <command>pokazuje wszystkie opcje. Jeśli polecenie zakończy się niepowodzeniem (aplikacja nie działa, odpowiada błędem lub pobieranie zostaje przerwane), program kończy działanie z kodem 1. Na przykład:

dannexdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
dannexdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
dannexdownloadmanager-cli torrent-get "magnet:?xt=urn:btih:…" --files 0

JSON dla skryptów i programów

Po dodaniu --json (przed poleceniem lub po nim) każde polecenie wyświetla JSON zamiast tekstu, po jednym obiekcie w wierszu, do odczytu przez skrypty i agentów AI:

Polecenie Zawartość
get, resume {"event": "through", "service"}najpierw, gdy pobieranie odbywa się przez konto debrid, następnie linia {"event": "progress", "downloaded", "size", "speed", "connections", "segments"} co pół sekundy, potem {"event": "done", "path", "size", "seconds"}, lub {"event": "paused", "state"} po Ctrl+C (state to plik, który resume pobiera).
video-get {"event": "progress", "downloaded", "size", "speed"}wiersze, a następnie {"event": "done", "path", "subtitles", "subtitle_problems"}: pliki napisów zapisane obok oraz języki, których strona nie udostępniła ({"code", "name", "reason", "beside"}; beside: napisy pobrano przy drugiej próbie i zapisano obok filmu, a nie w nim).
torrent-get {"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}wiersze, a następnie {"event": "done", "path", "size"} lub {"event": "stopped", "downloaded", "seconds"} z --seconds.
video-info {"title", "choices": [{"label", "format", "size"}], "subtitles": [{"code", "name", "automatic"}]}; format wybranej opcji to wartość przyjmowana przez video-get -f, a code napisów — wartość przyjmowana przez --subs.
torrent-info {"name", "info_hash", "size", "files": [{"index", "size", "path"}]}.
torrent-create {"info_hash", "path"}.
install-ytdlp, install-ffmpeg {"tool", "version", "path"}.
status, pause, start, remove, delete,api Odpowiedź aplikacji, która jest już w formacie JSON (patrz poniżej).

Rozmiary są podawane w bajtach (null, gdy nie są znane), a prędkości w bajtach na sekundę. W razie błędu wyświetlane jest {"error": "…"}, a program kończy działanie z kodem 1. Na przykład:

dannexdownloadmanager-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ą sprawdzać, co pobiera działająca aplikacja, a także wstrzymywać, uruchamiać, usuwać pobrania z listy lub kasować pobrane pliki. API jest domyślnie wyłączone; włącz je za pomocą dannexdownloadmanager-cli api on (wyłącz za pomocą api off).

Jak program komunikuje się z DDM

  1. Podczas działania DDM nasłuchuje na porcie 127.0.0.1 (dostępnym tylko na tym komputerze) i zapisuje port oraz tajny token w pliku ipc.json w swoim folderze danych: - Windows: %APPDATA%\dannexdownloadmanager\ipc.json - macOS: ~/Library/Application Support/dannexdownloadmanager/ipc.json - Linux: ~/.local/share/dannexdownloadmanager/ipc.json - Wersja przenośna: data\ipc.json obok programu.

Token zmienia się przy każdym uruchomieniu. Mogą go używać tylko programy, które mają dostęp do Twojego folderu danych. 2. Połącz się z tym portem i wyślij jeden wiersz JSON zawierający token i pola polecenia, np. {"token": "<token>", "query": "list"}. 3. DDM odpowiada jednym wierszem: ok w przypadku polecenia lub obiektem JSON w przypadku zapytania.

Obsługiwane polecenia

Pola (oprócz token) Odpowiedź
{"query": "list"} Każde pobieranie i całkowita prędkość: {"downloads": [{"id", "file", "url", "path", "status", "size", "downloaded", "speed", "added", "category", "error"}], "speed": bytes per second, "queues": [{"name", "running", "ids"}], "categories": [{"key", "name"}], "free": bytes}. status to Queued, Downloading, Stopped, Complete lub Error; size to null, gdy nieznane; error (dlaczego się nie powiodło) jest dostępne tylko dla pobierania w Error; category to key kategorii; free to wolne miejsce, gdzie trafiają pobrane pliki (null, gdy nieznane). Tylko gdy API jest włączone.
{"action": "pause", "ids": [3, 4]} Działa na pobieraniach według identyfikatora: "pause", "start", "remove" (plik zostaje), "delete" (plik także usunięty) lub "folder" (pokazuje plik w jego folderze, tak jak Otwórz folder). Odpowiada {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; trwające pobieranie trzeba wstrzymać przed usunięciem. Tylko gdy API jest włączone.
{"action": "start_queue", "queue": "Main download queue"} Uruchamia (lub z "stop_queue", zatrzymuje) kolejkę o tej nazwie (nazwa z queues listy). Odpowiada {"done": [], "skipped": []} lub {"error": …, "code": "unknown-queue"}. Tylko gdy API jest włączone.
{"api": true} / {"api": false} Włącza lub wyłącza API: {"api": true}.
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} Dodaje pobieranie, tak jak /d /p /f /n w wierszu poleceń ("later": true to /a); ok. "category" (klucz z categories listy) umieszcza go w folderze tej kategorii zamiast w folderze wybranym przez jego typ; "queue" (nazwa kolejki) to kolejka, w której czeka z "later". Również przy wyłączonym API, tak jak w wierszu poleceń.
{"start_queue": true} Uruchamia główną kolejkę pobierania; ok.

Na nieznane pytanie lub działanie zwracana jest odpowiedź {"error": "…"}. Tak samo dzieje się w przypadku pytania, gdy API jest wyłączone (wtedy zwracana jest odpowiedź "code": "api-off", którą programy mogą sprawdzać; tekst błędu może się zmienić). Na nieprawidłowy token zwracana jest odpowiedź denied.

Przycisk paska narzędzi rozszerzenia przeglądarki wyświetla pobierania DDM za pomocą tego samego list oraz wstrzymuje je, wznawia i otwiera ich foldery tymi samymi akcjami, niezależnie od przełącznika API: jego pomocnik oznacza swoje zapytania przez "browser": true. W ten sposób nie pyta o nic innego.

Każde żądanie i odpowiedź są opisane, pole po polu, w schemacie JSON: automation-api.schema.json (również pod https://dannex.kavangi.co.ke/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\dannexdownloadmanager\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"], "dannexdownloadmanager", "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}.

Darmowy, open source, bez reklam, bez wersji próbnej.

Pobierz Dannex Download Manager