명령줄 및 자동화

MDM은 창 없이 다음 세 가지 방법으로 실행할 수 있습니다.

• 앱 자체의 명령줄(IDM과 동일한 스위치 사용): 스크립트, 배치 파일 또는 다른 프로그램에서 실행 중인 앱으로 다운로드를 전달합니다.
• misterdownloadmanager-cli(별도의 명령줄 도구): 앱 없이 터미널에서 진행 상황을 확인하며 파일, 비디오 및 토렌트를 다운로드합니다.
• 자동화 API: 다른 프로그램이 실행 중인 앱의 다운로드 목록을 (JSON 형식으로) 가져오고 로컬의 토큰으로 보호된 채널을 통해 다운로드를 일시 중지, 시작, 제거 또는 삭제합니다. AI 비서들은 MDM의 MCP 서버를 통해 이를 사용합니다. AI 비서를 참조하십시오.

예시에서는 Windows 경로를 사용합니다. macOS 및 Linux에서는 프로그램 이름이 .exe 없이 동일합니다.

앱의 명령줄

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

스위치는 / 또는 -로 시작할 수 있으며, 대소문자를 구분하지 않습니다. MDM이 실행 중이면 명령이 MDM으로 전달되고, 실행 중이 아니면 MDM이 시작되어 명령을 수행합니다. 예시:

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의 모든 다운로드와 함께 앱 옆에 제공됩니다 (설치 프로그램이 MDM 폴더에 넣습니다). status 및 api를 제외하고는 앱이 실행될 필요 없이 자체적으로 작동합니다.

misterdownloadmanager-cli help <command>모든 옵션을 보여줍니다. 명령이 실패하면(앱이 실행 중이 아니거나, 오류로 응답하거나, 다운로드가 중단되는 경우) 코드 1로 종료됩니다. 예를 들어:

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

스크립트 및 프로그램을 위한 JSON

--json (명령 전 또는 후)를 사용하면 모든 명령은 텍스트 대신 JSON을 출력하며, 스크립트 및 AI 에이전트가 읽을 수 있도록 한 줄에 하나의 객체를 출력합니다.

크기는 바이트(null는 알 수 없음), 속도는 초당 바이트입니다. 실패하면 {"error": "…"}를 출력하고 코드 1로 종료됩니다. 예를 들어:

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}

자동화 API

다른 프로그램은 실행 중인 앱이 무엇을 다운로드하고 있는지 묻고, 다운로드를 일시 중지, 시작, 제거 또는 삭제할 수 있습니다. API는 기본적으로 꺼져 있습니다. misterdownloadmanager-cli api on로 켜고(api off로 끕니다).

프로그램이 MDM과 통신하는 방법

1. MDM은 실행되는 동안 127.0.0.1의 포트(이 컴퓨터만 해당)에서 수신 대기하며, 해당 포트와 비밀 토큰을 데이터 폴더의 ipc.json에 기록합니다. - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - 휴대용 복사본: 프로그램 옆의 data\ipc.json.

토큰은 시작할 때마다 변경됩니다. 데이터 폴더를 읽을 수 있는 프로그램(사용자 프로그램)만 사용할 수 있습니다. 2. 해당 포트에 연결하여 한 줄의 JSON을 보냅니다. 토큰과 명령 필드(예: {"token": "<token>", "query": "list"}). 3. MDM은 한 줄로 응답합니다. 명령의 경우 ok, 질문의 경우 JSON 객체입니다.

이해하는 내용

알 수 없는 질문이나 작업은 {"error": "…"}로 응답하며, API가 꺼져 있는 동안의 질문도 마찬가지입니다(이 경우 프로그램이 확인할 수 있도록 "code": "api-off"로 응답합니다. 오류 텍스트는 변경될 수 있습니다). 잘못된 토큰은 denied로 응답합니다.

모든 요청과 응답은 JSON 스키마인 automation-api.schema.json(https://misterdownloadmanager.com/automation-api.schema.json에서도 확인 가능)에 필드별로 설명되어 있습니다. 이는 앱이 응답하는 코드로부터 만들어지므로 정확하게 유지됩니다. 프로그램은 이를 기준으로 보내고 읽는 내용을 확인하거나, 이를 통해 유형을 생성할 수 있습니다.

예시

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

대신 다운로드를 추가하려면 {"token": "…", "url": "https://example.com/a.zip", "silent": true}를 보내세요.