MDM можно управлять без его окна тремя способами:
- Собственная командная строка приложения, те же параметры, что и у IDM: передайте загрузку запущенному приложению из скрипта, пакетного файла или другой программы.
mattdownloadmanager-cli, отдельный инструмент командной строки: загружайте файлы, видео и торренты в терминале, с отображением прогресса, без приложения.- API автоматизации: другие программы выводят список загрузок запущенного приложения (в формате JSON) и ставят их на паузу, запускают, удаляют или стирают их через локальный, защищенный токеном канал. AI-помощники используют его через сервер MCP MDM: см. AI-помощники.
Чтобы запустить приложение без окна, например, на домашнем сервере или сетевом хранилище, см. Запуск MDM на сервере (mattdownloadmanager --headless); для управления с телефона — Управление MDM с телефона.
В примерах используются пути Windows; в macOS и Linux программы имеют те же имена без .exe.
Командная строка приложения
mattdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
| Параметр | Что он делает |
|---|---|
/d URL |
Адрес для загрузки. |
/p folder |
Сохранить в этой папке (иначе в папке категории из Параметры → Сохранить в). |
/f name |
Сохранить под этим именем. |
/a |
Добавить в основную очередь загрузки без запуска. |
/n |
Тихий режим: нет окна Информация о загружаемом файле, загрузка начинается (или ставится в очередь, с /a) сразу. |
/s |
Запустить основную очередь загрузки. |
/exit |
Сохранить и закрыть запущенное приложение (установщик использует это перед обновлением). |
/startup |
Start in the notification area, the window hidden: what Launch Matt Download Manager on startup starts MDM with when you sign in. Where no notification area shows MDM's icon (some Linux desktops), MDM starts minimized. A running MDM stays as it is. |
файл .torrent или ссылка magnet: |
Открыть в Добавить торрент (что Windows передает, когда MDM открывает торренты). |
Параметры могут начинаться с / или -, в любом регистре. Если MDM запущен, команда передается ему; если нет, MDM запускается и выполняет ее. Например:
mattdownloadmanager.exe /d https://example.com/files/report.pdf /p D:\Reports /n
mattdownloadmanager.exe /d https://example.com/big.iso /a
mattdownloadmanager.exe /s
mattdownloadmanager-cli
Он поставляется с каждой загрузкой MDM, рядом с приложением (установщик помещает его в папку MDM). Он работает самостоятельно: приложение не обязательно должно быть запущено, за исключением 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] [--adapter name] |
Загружает изображения из галереи (категории Wikimedia Commons, альбома Flickr и т. д.) в папку с её названием внутри -o; --limit принимает не более указанного количества, первые из перечисленных на сайте. При повторном запуске загружаются только новые. Собственный загрузчик MDM получает изображения, перечисленные gallery-dl, по 4 за раз. --adapter отправляет соединения MDM и 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: собственный загрузчик MDM загружает каждый поток, найденный yt-dlp, через указанное количество соединений (по умолчанию 8, от 1 до 128), а поток, состоящий из частей (HLS, DASH), — по столько же частей одновременно. --subs сохраняет субтитры рядом: коды языков из video-info (en,fr) или all для всех, предоставленных загрузчиком; --auto-subs вместо этого использует автоматические субтитры сайта; --embed-subs встраивает их в видео (требуется ffmpeg, MP4 или MKV). С ffmpeg главы видео также встраиваются в файл, как это делает Встроить главы в диалоге «Скачать видео». --adapter отправляет соединения для загрузок, а также yt-dlp (и ffmpeg), через один сетевой адаптер, как для get; если он не подключен, ничего не запускается. |
install-ytdlp, install-ffmpeg |
Install or update the helpers videos need: yt-dlp (checked against its signing key) and ffmpeg (x64 and ARM64 Windows; on macOS and Linux MDM uses the system's, and on 32-bit Windows one you choose in Helpers). |
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 автоматизации запущенного приложения. |
mattdownloadmanager-cli help <command>показывает все параметры. Команда, которая завершается неудачей (приложение не запущено, оно отвечает ошибкой, загрузка прерывается), завершается с кодом 1. Например:
mattdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
mattdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
mattdownloadmanager-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", "approx", "height", "fps", "codec", "range"}], "subtitles": [{"code", "name", "automatic"}], "declared"}; declared is the address of the video the page says it is about, when that one was looked up instead of the first player in its HTML (on a site yt-dlp has no reader of its own for), else null; a choice's format is what video-get -f takes (the very formats it was sized from, as 401+251, then the nearest should those be gone), approx says its size is an estimate, codec is AV1, VP9, H.264…, range is HDR (or SDR beside an HDR choice); a subtitle's code is what --subs takes. |
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. Например:
mattdownloadmanager-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 по умолчанию отключен; включите его с помощью mattdownloadmanager-cli api on (и выключите с помощью api off).
Как программа взаимодействует с MDM
- Во время работы MDM прослушивает порт
127.0.0.1(только этот компьютер) и записывает порт и секретный токен вipc.jsonв своей папке данных: – Windows:%APPDATA%\mattdownloadmanager\ipc.json– macOS:~/Library/Application Support/mattdownloadmanager/ipc.json– Linux:~/.local/share/mattdownloadmanager/ipc.json– Портативная копия:data\ipc.jsonрядом с программой.
Токен меняется при каждом запуске; использовать его могут только программы, которые могут читать вашу папку данных (вашу). 2. Подключитесь к этому порту и отправьте одну строку JSON: токен и поля команды, например {"token": "<token>", "query": "list"}. 3. MDM отвечает одной строкой: 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]} |
Действует на загрузки по id: "pause", "start", "remove" (файл сохранен) или "delete" (файл также удален). Отвечает {"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.
Каждый запрос и ответ описывается, поле за полем, в JSON Schema: automation-api.schema.json (также по адресу https://idm.teachermatt.com/automation-api.schema.json). Он создается из кода, которым отвечает приложение, поэтому остается точным; программы могут проверять то, что они отправляют и читают, или генерировать свои типы из него.
Примеры
PowerShell (Windows):
$ep = Get-Content "$env:APPDATA\mattdownloadmanager\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"], "mattdownloadmanager", "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}.
Бесплатно, с открытым исходным кодом, без рекламы, без пробного периода.
Загрузить Matt Download Manager