يمكن تشغيل DDM بدون نافذته بثلاث طرق:
- سطر أوامر التطبيق نفسه، ويستخدم مفاتيح التبديل نفسها التي يستخدمها IDM: أرسل عملية تنزيل إلى التطبيق قيد التشغيل من نص برمجي أو ملف دفعي أو برنامج آخر.
dannexdownloadmanager-cli، أداة سطر أوامر منفصلة: تنزيل الملفات ومقاطع الفيديو والتورنت في طرفية، مع إظهار التقدم، بدون التطبيق.- واجهة برمجة التطبيقات للأتمتة: تدرج البرامج الأخرى تنزيلات التطبيق قيد التشغيل (بصيغة 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 |
يبدأ في منطقة الإشعارات، مع إخفاء النافذة: هذا ما يبدأ به DDM عند تسجيل الدخول، إذا اخترت تشغيل Dannex Download Manager عند بدء التشغيل. إذا لم تظهر أيقونة 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 الخاصة بك (الخيارات ← الحسابات) يمر عبر هذا الحساب، كما هو الحال في التطبيق، وget يقول through Real-Debrid؛ --direct يقوم بتنزيل العنوان نفسه (حسابات خدمة Debrid). |
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، مع معرفاتها (يجب تشغيل واجهة برمجة تطبيقات الأتمتة). |
pause ID..., start ID... |
إيقاف مؤقت للتنزيلات الجارية، أو بدء (استئناف) التنزيلات المتوقفة أو الموجودة في قائمة الانتظار أو الفاشلة، في التطبيق قيد التشغيل. |
remove ID..., delete ID... |
إزالة التنزيلات من قائمة التطبيق قيد التشغيل: remove يحتفظ بملفاتها، delete يحذفها أيضا. يتم إيقاف التنزيل الجاري مؤقتا أولا (pause). |
api on, api off |
تشغيل أو إيقاف واجهة برمجة تطبيقات الأتمتة للتطبيق قيد التشغيل. |
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"}، أو {"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"}], "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}
واجهة برمجة تطبيقات الأتمتة
يمكن للبرامج الأخرى أن تسأل التطبيق قيد التشغيل عما يقوم بتنزيله، وإيقاف التنزيلات مؤقتا أو بدءها أو إزالتها أو حذفها. واجهة برمجة التطبيقات معطلة افتراضيا؛ قم بتشغيلها باستخدام dannexdownloadmanager-cli api on (وإيقافها باستخدام api off).
كيف يتحدث البرنامج إلى DDM
- أثناء تشغيله، يستمع 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": 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 كل طلب وإجابة، حقلا بحقل: 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