MDM은 창 없이 다음 세 가지 방법으로 실행할 수 있습니다.
- 앱의 명령줄은 IDM과 같은 스위치를 사용합니다. 스크립트, 배치 파일 또는 다른 프로그램에서 실행 중인 앱에 다운로드를 전달할 수 있습니다.
mattdownloadmanager-cli는 별도의 명령줄 도구입니다. 앱을 실행하지 않고 터미널에서 진행 상황을 확인하며 파일, 동영상, 토렌트를 다운로드할 수 있습니다.- 자동화 API: 다른 프로그램에서 실행 중인 앱의 다운로드 목록을 JSON 형식으로 가져오고, 로컬의 토큰 보호 채널을 통해 다운로드를 일시 중지하거나 시작하고, 목록에서 제거하거나 삭제할 수 있습니다. AI 비서는 MDM의 MCP 서버를 통해 API를 사용합니다. 자세한 내용은 AI 비서를 참조하세요.
창 없이 앱 전체를 홈 서버나 NAS에서 실행하려면 서버에서 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. |
a .torrent 파일 또는 magnet: 링크 |
토렌트 추가에서 엽니다 (MDM이 토렌트를 열 때 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 체크섬을 16진수로 확인합니다. 체크섬 이름은 선택 사항입니다(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] |
갤러리(위키미디어 공용 카테고리, 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는 get과 같이 다운로드 연결과 yt-dlp(및 ffmpeg) 연결을 하나의 네트워크 어댑터를 통해 보냅니다. 연결되지 않으면 아무것도 시작되지 않습니다. |
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은 마그넷 링크 또는 .torrent 파일입니다. |
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] |
토렌트 전체 또는 일부 파일을 다운로드합니다. 일부 파일이 폴더에 이미 있으면 다운로드를 중단하고 해당 파일 이름을 표시합니다. --use-existing를 사용하면 해당 파일을 대신 사용합니다(일치하는 파일은 유지하고 나머지는 다운로드). |
torrent-create PATH -o file.torrent |
파일 또는 폴더의 .torrent을 만듭니다 (피어는 DHT를 통해 찾습니다). |
status |
실행 중인 앱의 다운로드 목록과 ID를 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을 출력합니다. 스크립트와 AI 에이전트가 읽을 수 있도록 한 줄에 객체 하나씩 출력합니다.
| 명령 | 출력 내용 |
|---|---|
get, resume |
{"event": "through", "service"}다운로드가 디브리드 계정을 통해 진행되면 먼저, 0.5초마다 {"event": "progress", "downloaded", "size", "speed", "connections", "segments"} 줄을 출력한 다음 {"event": "done", "path", "size", "seconds"}를 출력합니다. 또는 Ctrl+C 후에 {"event": "paused", "state"}를 출력합니다(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"} 또는 --seconds가 포함된 {"event": "stopped", "downloaded", "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 스키마인 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 다운로드