Dannex Download Manager
  1. خانه
  2. راهنما
  3. خط فرمان و اتوماسیون

خط فرمان و اتوماسیون

DDM را می‌توان بدون پنجره‌اش به سه روش کنترل کرد:

  • خط فرمان خود برنامه، همان سوئیچ‌های IDM: یک بارگیری را از یک اسکریپت، یک فایل دسته‌ای یا برنامه دیگر به برنامه در حال اجرا بسپارید.
  • dannexdownloadmanager-cli، یک ابزار خط فرمان جداگانه: فایل‌ها، ویدیوها و تورنت‌ها را در یک ترمینال، با نمایش پیشرفت، بدون نیاز به برنامه بارگیری کنید.
  • رابط برنامه‌نویسی کاربردی (API) خودکارسازی: برنامه‌های دیگر، بارگیری‌های برنامه در حال اجرا را (به صورت JSON) فهرست می‌کنند و آن‌ها را از طریق یک کانال محلی و محافظت‌شده با توکن، متوقف، شروع، حذف یا پاک می‌کنند. دستیاران هوش مصنوعی از طریق سرور MCP برنامه DDM از آن استفاده می‌کنند: به دستیاران هوش مصنوعی مراجعه کنید.

برای اجرای کل برنامه بدون پنجره، روی سرور خانگی یا NAS، به اجرای 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 شروع در ناحیه اعلان، با پنجره پنهان: این گزینه اجرای Dannex Download Manager هنگام راه‌اندازی، DDM را هنگام ورود شما به سیستم با این حالت اجرا می‌کند. در جاهایی که آیکون 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) یا یکی از آدرس‌های آن ارسال می‌کند؛ وقتی متصل نباشد، چیزی ارسال نمی‌شود و بارگیری با شکست مواجه می‌شود. پیوندی از یک میزبان فایل که یکی از حساب‌های debrid شما (Options → Accounts) پشتیبانی می‌کند، مانند برنامه، از طریق آن حساب می‌رود و get می‌گوید through Real-Debrid؛ --direct خود آدرس را بارگیری می‌کند (Debrid service accounts).
resume file.mdm.json [-c connections] [-H ...] [--direct] یک بارگیری متوقف شده یا خراب را از فایل .mdm.json کنار آن ادامه می‌دهد. از طریق یک حساب debrid، مانند 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 پیوند مگنت یا فایل .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"}ابتدا وقتی بارگیری از طریق حساب debrid انجام می‌شود، سپس هر نیم‌ثانیه یک خط {"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"} یا {"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). این از کدی ساخته شده است که برنامه با آن پاسخ می‌دهد، بنابراین دقیق می‌ماند؛ برنامه‌ها می‌توانند آنچه را که ارسال می‌کنند و می‌خوانند در برابر آن بررسی کنند، یا انواع خود را از آن تولید کنند.

مثال‌ها

پاورشل (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()

پایتون:

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