Dannex Download Manager
  1. Главная
  2. Справка
  3. Командная строка и автоматизация

Командная строка и автоматизация

DDM можно управлять без его окна тремя способами:

  • Собственная командная строка приложения, те же параметры, что и у IDM: передайте загрузку запущенному приложению из скрипта, пакетного файла или другой программы.
  • dannexdownloadmanager-cli, отдельный инструмент командной строки: загружайте файлы, видео и торренты в терминале, с отображением прогресса, без приложения.
  • API автоматизации: другие программы выводят список загрузок запущенного приложения (в формате JSON) и ставят их на паузу, запускают, удаляют или стирают их через локальный, защищенный токеном канал. AI-помощники используют его через сервер MCP DDM: см. AI-помощники.

Чтобы запустить приложение без окна, например, на домашнем сервере или сетевом хранилище, см. Запуск DDM на сервере (dannexdownloadmanager --headless); для управления с телефона — Управление DDM с телефона.

В примерах используются пути Windows; в macOS и Linux программы имеют те же имена без .exe.

Командная строка приложения

dannexdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
Параметр Что он делает
/d URL Адрес для загрузки.
/p folder Сохранить в этой папке (иначе в папке категории из Параметры → Сохранить в).
/f name Сохранить под этим именем.
/a Добавить в основную очередь загрузки без запуска.
/n Тихий режим: нет окна Информация о загружаемом файле, загрузка начинается (или ставится в очередь, с /a) сразу.
/s Запустить основную очередь загрузки.
/exit Сохранить и закрыть запущенное приложение (установщик использует это перед обновлением).
/startup Запускает DDM в области уведомлений со скрытым окном, если включена опция Запускать Dannex Download Manager при запуске системы. Если область уведомлений не отображает значок DDM (некоторые рабочие столы Linux), DDM запускается свёрнутым. Уже запущенный DDM остаётся в текущем состоянии.
файл .torrent или ссылка magnet: Открыть в Добавить торрент (что Windows передает, когда DDM открывает торренты).

Параметры могут начинаться с / или -, в любом регистре. Если DDM запущен, команда передается ему; если нет, DDM запускается и выполняет ее. Например:

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

Он поставляется с каждой загрузкой DDM, рядом с приложением (установщик помещает его в папку DDM). Он работает самостоятельно: приложение не обязательно должно быть запущено, за исключением status и api.

Команда Что он делает
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] Загружает файл, используя до 8 соединений (-c, от 1 до 128), с отображением прогресса. Ctrl+C приостанавливает загрузку; resume продолжает. --checksum проверяет готовый файл: шестнадцатеричный MD5, SHA-1, SHA-256, SHA-512 или CRC32, опционально с именем (sha256:…). --dns выбирает DNS: system (по умолчанию); службу и способ запроса к ней, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; адреса DNS-серверов, 9.9.9.9,149.112.112.112; или адрес DNS-over-HTTPS. Он никогда не возвращается к системному DNS. --adapter отправляет каждое соединение через один сетевой адаптер по его имени (Ethernet, wg0) или одному из его адресов; если он не подключен, ничего не отправляется и загрузка завершается ошибкой. Ссылка с файлового хостинга, который поддерживает одна из ваших учетных записей дебрида (Параметры → Учетные записи), проходит через эту учетную запись, как в приложении, и get говорит through Real-Debrid; --direct загружает сам адрес (Учетные записи службы дебрида).
resume file.mdm.json [-c connections] [-H ...] [--direct] Продолжает приостановленную или прерванную загрузку из файла .mdm.json рядом с ним. Через учетную запись дебрида, как get: служба предоставляет новую ссылку, когда старая истекла; --direct продолжает с самого адреса.
install-gallery-dl Устанавливает или обновляет gallery-dl для галерей изображений: его список контрольных сумм проверяется по ключу подписи автора, а программа — по этому списку (Windows и Linux x86-64; в других случаях установите его самостоятельно).
gallery-get URL [-o folder] [--limit N] [-c N] [--adapter name] Скачивает картинки галереи (категории Wikimedia Commons, альбома Flickr, ...) в папку с её названием внутри -o: gallery-dl составляет их список, загрузчик DDM их скачивает, файлов одновременно: -c (по умолчанию 8, как соединений у get); --limit берёт не больше этого числа, первые из списка сайта. При повторном запуске скачивает только новые. --adapter направляет свои соединения и соединения gallery-dl через один сетевой адаптер, как для get.
video-info URL Какое видео содержит страница (YouTube, Vimeo, ...), и доступные качества.
playlist-info URL [--from N] [--count N] Видео из плейлиста или канала, по одному в строке, как они перечислены: их место, длительность, название и адрес.
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] Скачать видео из плейлиста или канала одно за другим в папку с названием плейлиста внутри -o. -f — это одно качество для всех, как для video-get (по умолчанию лучшее для каждого видео; bv*[height<=720]+ba/b[height<=720] = до 720p; ba = оригинальный звук; mp3:320, opus:, flac: как для video-get). -c как для video-get.
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] Скачать видео; -f принимает селектор качества из video-info (b = лучший отдельный файл; ba = только звук в том виде, в каком он есть на сайте, без конвертации; mp3:320, mp3:256, mp3:192 или mp3:128 = звук в формате MP3 с указанным битрейтом, mp3:0 с лучшим переменным битрейтом; opus: = в формате Opus; flac: = в формате FLAC, без потерь, но не лучше, чем звук на сайте; для конвертации требуется ffmpeg). -c: собственный загрузчик DDM загружает каждый поток, найденный yt-dlp, через указанное количество соединений (по умолчанию 8, от 1 до 128), а поток, состоящий из частей (HLS, DASH), — по столько частей одновременно. --subs сохраняет субтитры рядом с видео: коды языков из video-info (en,fr) или all для всех, предоставленных загрузчиком; --auto-subs вместо этого использует автоматические субтитры сайта; --embed-subs встраивает их в видео (требуется ffmpeg, MP4 или MKV). --adapter направляет соединения для загрузок, а также yt-dlp (и ffmpeg) через один сетевой адаптер, как для get; если он не подключен, ничего не запускается.
install-ytdlp, install-ffmpeg Установить или обновить вспомогательные программы, необходимые для видео: yt-dlp (проверяется по его ключу подписи) и ffmpeg (Windows; в macOS и Linux DDM использует системные).
torrent-info SOURCE Имя торрента, файлы (пронумерованные) и размер; SOURCE — это magnet-ссылка или файл .torrent.
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] Загрузить торрент или только некоторые из его файлов. Если некоторые из его файлов уже находятся в папке, он останавливается и называет их; --use-existing вместо этого использует их (совпадающие файлы сохраняются, остальные загружаются).
torrent-create PATH -o file.torrent Создать .torrent файла или папки (пиры находят его через DHT).
status Загрузки запущенного приложения в формате JSON, с их идентификаторами (API автоматизации должен быть включен).
pause ID..., start ID... Приостанавливает текущие загрузки или запускает (возобновляет) остановленные, поставленные в очередь или неудавшиеся загрузки в запущенном приложении.
remove ID..., delete ID... Удаляет загрузки из списка запущенного приложения: remove сохраняет их файлы, delete также удаляет их. Запущенная загрузка сначала приостанавливается (pause).
api on, api off Включает или выключает API автоматизации запущенного приложения.

dannexdownloadmanager-cli help <command>показывает все параметры. Команда, которая завершается неудачей (приложение не запущено, оно отвечает ошибкой, загрузка прерывается), завершается с кодом 1. Например:

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 для скриптов и программ

С --json (до или после команды) каждая команда выводит JSON вместо текста, по одному объекту на строку, для чтения скриптами и ИИ-агентами:

Команда Выводит
get, resume {"event": "through", "service"}сначала, когда загрузка идет через учетную запись дебрида, затем строка {"event": "progress", "downloaded", "size", "speed", "connections", "segments"} каждые полсекунды, затем {"event": "done", "path", "size", "seconds"}, или {"event": "paused", "state"} после Ctrl+C (state — это файл, который принимает resume).
video-get {"event": "progress", "downloaded", "size", "speed"}строки, затем {"event": "done", "path", "subtitles", "subtitle_problems"}: файлы субтитров, сохраненные рядом, и языки, которые сайт отклонил ({"code", "name", "reason", "beside"}; beside: они были получены со второй попытки, рядом с видео вместо того, чтобы быть в нем).
torrent-get {"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}строки, затем {"event": "done", "path", "size"}, или {"event": "stopped", "downloaded", "seconds"} с --seconds.
video-info {"title", "choices": [{"label", "format", "size"}], "subtitles": [{"code", "name", "automatic"}]}; format выбора — это то, что принимает video-get -f, code субтитров — это то, что принимает --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 Ответ приложения, который уже является JSON (см. ниже).

Размеры указаны в байтах (null, если неизвестно), скорости — в байтах в секунду. При сбое выводится {"error": "…"} и происходит выход с кодом 1. Например:

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 автоматизации

Другие программы могут запрашивать у запущенного приложения информацию о загрузках, а также приостанавливать, запускать, удалять или стирать загрузки. API по умолчанию отключен; включите его с помощью dannexdownloadmanager-cli api on (и выключите с помощью api off).

Как программа взаимодействует с DDM

  1. Во время работы DDM прослушивает порт 127.0.0.1 (только этот компьютер) и записывает порт и секретный токен в ipc.json в своей папке данных: – Windows: %APPDATA%\dannexdownloadmanager\ipc.json – macOS: ~/Library/Application Support/dannexdownloadmanager/ipc.json – Linux: ~/.local/share/dannexdownloadmanager/ipc.json – Портативная копия: data\ipc.json рядом с программой.

Токен меняется при каждом запуске; использовать его могут только программы, которые могут читать вашу папку данных (вашу). 2. Подключитесь к этому порту и отправьте одну строку JSON: токен и поля команды, например {"token": "<token>", "query": "list"}. 3. DDM отвечает одной строкой: ok для команды или объект JSON для вопроса.

Что он понимает

Поля (кроме token) Ответ
{"query": "list"} Каждая загрузка и общая скорость: {"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 — это Queued, Downloading, Stopped, Complete или Error; size — null, если неизвестно; error (почему не удалось) есть только для загрузки в Error; category — это key категории; free — свободное место, куда сохраняются загрузки (null, если неизвестно). Только при включенном API.
{"action": "pause", "ids": [3, 4]} Действует на загрузки по идентификатору: "pause", "start", "remove" (файл сохраняется), "delete" (файл тоже удаляется) или "folder" (показывает файл в его папке, как Открыть папку). Отвечает {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; запущенную загрузку нужно приостановить, прежде чем удалять. Только при включённом API.
{"action": "start_queue", "queue": "Main download queue"} Запускает (или с "stop_queue", останавливает) очередь с этим именем (имя из queues списка). Отвечает {"done": [], "skipped": []} или {"error": …, "code": "unknown-queue"}. Только при включенном API.
{"api": true} / {"api": false} Включает или выключает API: {"api": true}.
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} Добавляет загрузку, как это делает /d /p /f /n в командной строке ("later": true — это /a); ok. "category" (ключ из categories списка) помещает ее в папку этой категории вместо той, которую выбирает ее тип; "queue" (имя очереди) — это очередь, в которой она ждет с "later". Также при выключенном API, как и в командной строке.
{"start_queue": true} Запускает основную очередь загрузок; ok.

На неизвестный вопрос или действие дается ответ {"error": "…"}, как и на вопрос при выключенном API (тогда с "code": "api-off", для проверки программами: текст ошибки может измениться). На неверный токен дается ответ denied.

Кнопка расширения для браузера на панели инструментов показывает список загрузок DDM с тем же list и приостанавливает, возобновляет и открывает их папки теми же действиями, независимо от переключателя API: её вспомогательная программа помечает свои запросы с помощью "browser": true. Больше ничего таким способом она не запрашивает.

Каждый запрос и ответ описывается, поле за полем, в JSON Schema: automation-api.schema.json (также по адресу https://dannex.kavangi.co.ke/automation-api.schema.json). Он создается из кода, которым отвечает приложение, поэтому остается точным; программы могут проверять то, что они отправляют и читают, или генерировать свои типы из него.

Примеры

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

Чтобы вместо этого добавить загрузку, отправьте {"token": "…", "url": "https://example.com/a.zip", "silent": true}.

Бесплатно, с открытым исходным кодом, без рекламы, без пробного периода.

Загрузить Dannex Download Manager