1. Beranda
  2. Bantuan
  3. Baris perintah dan otomatisasi

Baris perintah dan otomatisasi

MDM dapat dikendalikan tanpa membuka jendelanya dengan tiga cara:

  • Baris perintah bawaan aplikasi, dengan opsi yang sama seperti IDM: teruskan unduhan ke aplikasi yang sedang berjalan dari skrip, file batch, atau program lain.
  • mattdownloadmanager-cli, alat baris perintah terpisah: mengunduh file, video, dan torrent di terminal, dengan progres, tanpa aplikasi.
  • API otomatisasi: program lain dapat melihat daftar unduhan di aplikasi yang sedang berjalan (dalam format JSON), lalu menjeda, memulai, menghapus dari daftar, atau menghapus unduhan melalui koneksi lokal yang dilindungi token. Asisten AI menggunakannya melalui server MCP MDM: lihat Asisten AI.

Untuk menjalankan seluruh aplikasi tanpa jendela, di server rumah atau NAS, lihat Menjalankan MDM di server (mattdownloadmanager --headless); untuk mengontrolnya dari ponsel, Mengontrol MDM dari ponsel Anda.

Contoh menggunakan jalur Windows. Di macOS dan Linux, nama programnya sama tanpa .exe.

Baris perintah aplikasi

mattdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
Opsi Apa yang dilakukannya
/d URL Alamat yang akan diunduh.
/p folder Simpan di folder ini (jika tidak, gunakan folder kategori dari Opsi → Simpan ke).
/f name Simpan dengan nama ini.
/a Tambahkan ke antrean unduhan utama tanpa memulainya.
/n Tanpa jendela Info file unduhan, unduhan langsung dimulai (atau masuk antrean jika menggunakan /a).
/s Mulai antrean unduhan utama.
/exit Simpan dan tutup aplikasi yang sedang berjalan (penginstal menggunakannya sebelum pembaruan).
/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.
file .torrent atau tautan magnet: Buka di Tambahkan torrent (apa yang diteruskan Windows saat MDM membuka torrent).

Opsi dapat diawali dengan / atau -, dengan huruf besar atau kecil. Jika MDM sedang berjalan, perintah akan diteruskan ke aplikasi; jika tidak, MDM akan dijalankan dan perintah dilaksanakan. Contoh:

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

Alat ini disertakan setiap kali MDM diunduh, di samping aplikasi (penginstal menempatkannya di folder MDM). Alat ini dapat berfungsi sendiri: aplikasi tidak perlu berjalan, kecuali untuk status dan api.

Perintah Apa yang dilakukannya
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] Unduh file dengan hingga 8 koneksi (-c, 1 hingga 128) dan tampilkan progres. Ctrl+C menjeda unduhan; resume melanjutkannya. --checksum memeriksa file yang selesai diunduh: MD5, SHA-1, SHA-256, SHA-512, atau CRC32 dalam format heksadesimal, dengan nama opsional (sha256:…). --dns memilih DNS: system (default); layanan dan cara meminta layanan tersebut, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; alamat server DNS, 9.9.9.9,149.112.112.112; atau alamat DNS-over-HTTPS. DNS sistem tidak akan digunakan sebagai alternatif. --adapter mengirim setiap koneksi melalui satu adaptor jaringan, berdasarkan nama (Ethernet, wg0) atau salah satu alamatnya. Jika adaptor tidak terhubung, tidak ada data yang dikirim dan unduhan gagal. Tautan dari host file yang didukung salah satu akun debrid Anda (Opsi → Akun) akan menggunakan akun tersebut, seperti di aplikasi. get menampilkan through Real-Debrid; --direct mengunduh alamat itu sendiri (Akun layanan debrid).
resume file.mdm.json [-c connections] [-H ...] [--direct] Lanjutkan unduhan yang dijeda atau gagal dari file .mdm.json di sebelahnya. Melalui akun debrid, seperti get: layanan memberikan tautan baru jika tautan lama kedaluwarsa; --direct melanjutkan unduhan dari alamat itu sendiri.
install-gallery-dl Instal atau perbarui gallery-dl untuk galeri gambar. Daftar checksum-nya diverifikasi dengan kunci penandatanganan pembuatnya, lalu programnya diverifikasi dengan daftar tersebut (Windows dan Linux x86-64; instal sendiri di sistem lain).
gallery-get URL [-o folder] [--limit N] [--adapter name] Mengunduh gambar galeri (kategori Wikimedia Commons, album Flickr, ...) ke dalam folder yang dinamai sesuai galeri tersebut di dalam -o; --limit mengambil paling banyak sejumlah itu, yang pertama dicantumkan situs. Jika dimulai lagi, hanya mengambil yang baru. Pengunduh MDM sendiri mengambil gambar yang dicantumkan gallery-dl, 4 sekaligus. --adapter mengirimkan koneksi, MDM dan gallery-dl, melalui satu adaptor jaringan, seperti untuk get.
video-info URL Video apa saja yang ada di halaman (YouTube, Vimeo, ...) dan pilihan kualitasnya.
playlist-info URL [--from N] [--count N] Video dari daftar putar atau saluran, satu video per baris sesuai urutan yang tercantum: nomor urut, durasi, judul, dan alamat.
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] Mengunduh video dari daftar putar atau saluran satu per satu, ke dalam folder bernama sesuai daftar di dalam -o. -f adalah satu kualitas untuk semua, seperti pada video-get (secara default yang terbaik dari setiap video; bv*[height<=720]+ba/b[height<=720] = hingga 720p; ba = suara asli; mp3:320, opus:, flac: seperti pada video-get). -c seperti pada video-get.
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] Mengunduh video; -f mengambil pemilih kualitas dari video-info (b = file tunggal terbaik; ba = hanya suara seperti yang ada di situs, tidak dikonversi; mp3:320, mp3:256, mp3:192 atau mp3:128 = suara sebagai MP3 pada bitrate tersebut, mp3:0 pada bitrate variabel terbaiknya; opus: = sebagai Opus; flac: = sebagai FLAC, lossless tetapi tidak lebih baik dari suara situs; konversi memerlukan ffmpeg). -c: pengunduh MDM sendiri membawa setiap aliran yang ditemukan yt-dlp melalui koneksi sebanyak ini (8 secara default, 1 hingga 128), aliran dalam potongan (HLS, DASH) sebanyak ini secara bersamaan. --subs menyimpan subtitle di sampingnya: kode bahasa dari video-info (en,fr), atau all untuk setiap subtitle yang diberikan pengunggah; --auto-subs mengambil teks otomatis situs sebagai gantinya; --embed-subs menempatkannya ke dalam video (memerlukan ffmpeg, MP4 atau MKV). Dengan ffmpeg, bab-bab video juga masuk ke dalam file, seperti yang dilakukan Sematkan bab pada Unduh video. --adapter mengirim koneksi unduhan, dan yt-dlp (dan ffmpeg), melalui satu adaptor jaringan, seperti untuk get; ketika tidak terhubung, tidak ada yang dimulai.
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 Nama torrent, file (bernomor) dan ukuran; SOURCE adalah tautan magnet atau file .torrent.
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] Mengunduh torrent, atau hanya beberapa file di dalamnya. Jika beberapa file sudah ada di folder, proses akan berhenti dan menampilkan namanya; --use-existing akan menggunakan file tersebut (file yang cocok dipertahankan, sisanya diunduh).
torrent-create PATH -o file.torrent Membuat .torrent dari file atau folder (peer dapat menemukannya melalui DHT).
status Unduhan aplikasi yang sedang berjalan, dalam format JSON, beserta ID-nya (API otomatisasi harus aktif).
pause ID..., start ID... Menjeda unduhan yang sedang berjalan, atau memulai (melanjutkan) unduhan yang berhenti, mengantre, atau gagal, di aplikasi yang sedang berjalan.
remove ID..., delete ID... Menghapus unduhan dari daftar aplikasi yang sedang berjalan: remove mempertahankan file unduhan, delete juga menghapusnya. Unduhan yang sedang berjalan dijeda terlebih dahulu (pause).
api on, api off Mengaktifkan atau menonaktifkan API otomatisasi aplikasi yang sedang berjalan.

mattdownloadmanager-cli help <command>menampilkan semua opsi. Perintah yang gagal (aplikasi tidak berjalan, aplikasi memberikan jawaban berupa kesalahan, unduhan gagal) keluar dengan kode 1. Contoh:

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 untuk skrip dan program

Dengan --json (sebelum atau sesudah perintah), setiap perintah mencetak JSON alih-alih teks, satu objek per baris, agar dapat dibaca oleh skrip dan agen AI:

Perintah Cetak
get, resume {"event": "through", "service"}pertama saat unduhan melalui akun debrid, lalu baris {"event": "progress", "downloaded", "size", "speed", "connections", "segments"} setiap setengah detik, kemudian {"event": "done", "path", "size", "seconds"}, atau {"event": "paused", "state"} setelah Ctrl+C (state adalah file yang diambil resume).
video-get {"event": "progress", "downloaded", "size", "speed"}baris, lalu {"event": "done", "path", "subtitles", "subtitle_problems"}: file subtitle yang disimpan di samping video dan bahasa yang ditolak situs ({"code", "name", "reason", "beside"}; beside: file tersebut berhasil diunduh pada percobaan kedua, di samping video, bukan di dalamnya).
torrent-get {"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}baris, lalu {"event": "done", "path", "size"}, atau {"event": "stopped", "downloaded", "seconds"} dengan --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 Jawaban aplikasi, yang sudah berupa JSON (lihat di bawah).

Ukuran dalam bita (null jika tidak diketahui), kecepatan dalam bita per detik. Jika terjadi kegagalan, akan dicetak {"error": "…"} dan proses keluar dengan kode 1. Contoh:

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 otomatisasi

Program lain dapat menanyakan apa yang sedang diunduh oleh aplikasi yang berjalan, serta menjeda, memulai, menghapus dari daftar, atau menghapus unduhan. API nonaktif secara default; aktifkan dengan mattdownloadmanager-cli api on (dan nonaktifkan dengan api off).

Cara program berkomunikasi dengan MDM

  1. Saat berjalan, MDM mendengarkan pada port 127.0.0.1 (hanya di komputer ini) dan menyimpan nomor port serta token rahasia di ipc.json dalam folder datanya: - Windows: %APPDATA%\mattdownloadmanager\ipc.json - macOS: ~/Library/Application Support/mattdownloadmanager/ipc.json - Linux: ~/.local/share/mattdownloadmanager/ipc.json - Salinan portabel: data\ipc.json di samping program.

Token berubah setiap kali aplikasi dimulai; hanya program yang dapat membaca folder data Anda (program Anda sendiri) yang dapat menggunakannya. 2. Sambungkan ke port tersebut dan kirim satu baris JSON berisi token dan kolom perintah, misalnya {"token": "<token>", "query": "list"}. 3. MDM menjawab dengan satu baris: ok untuk perintah, atau objek JSON untuk pertanyaan.

Perintah yang didukung

Kolom (selain token) Jawaban
{"query": "list"} Setiap unduhan dan kecepatan total: {"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 adalah Queued, Downloading, Stopped, Complete, atau Error; size adalah null saat tidak diketahui; error (mengapa gagal) hanya ada untuk unduhan di Error; category adalah key dari kategori; free adalah ruang kosong tempat unduhan disimpan (null saat tidak diketahui). Hanya saat API aktif.
{"action": "pause", "ids": [3, 4]} Menjalankan tindakan pada unduhan berdasarkan ID: "pause", "start", "remove" (file dipertahankan) atau "delete" (file juga dihapus). Jawabannya {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; unduhan yang sedang berjalan harus dijeda sebelum dihapus dari daftar atau dihapus. Hanya saat API aktif.
{"action": "start_queue", "queue": "Main download queue"} Memulai (atau dengan "stop_queue", menghentikan) antrean dengan nama tersebut (nama dari queues daftar). Menjawab {"done": [], "skipped": []}, atau {"error": …, "code": "unknown-queue"}. Hanya saat API aktif.
{"api": true} / {"api": false} Mengaktifkan atau menonaktifkan API: {"api": true}.
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} Menambahkan unduhan, seperti yang dilakukan /d /p /f /n pada baris perintah ("later": true adalah /a); ok. "category" (kunci dari categories daftar) menempatkannya di folder kategori tersebut alih-alih folder yang dipilih jenisnya; "queue" (nama antrean) adalah antrean tempat ia menunggu dengan "later". Juga dengan API mati, seperti baris perintah.
{"start_queue": true} Memulai antrean unduhan utama; ok.

Pertanyaan atau tindakan yang tidak diketahui dijawab {"error": "…"}, begitu juga pertanyaan saat API mati (kemudian dengan "code": "api-off", untuk program untuk memeriksa: teks kesalahan dapat berubah). Token yang salah dijawab denied.

Setiap permintaan dan jawaban dijelaskan, bidang demi bidang, dalam Skema JSON: automation-api.schema.json (juga di https://idm.teachermatt.com/automation-api.schema.json). Ini dibuat dari kode yang dijawab aplikasi, sehingga tetap akurat; program dapat memeriksa apa yang mereka kirim dan baca terhadapnya, atau menghasilkan jenisnya darinya.

Contoh

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

Untuk menambahkan unduhan, kirim {"token": "…", "url": "https://example.com/a.zip", "silent": true}.

Gratis, sumber terbuka, tanpa iklan, tanpa masa uji coba.

Unduh Matt Download Manager