Dannex Download Manager
  1. होम
  2. सहायता
  3. कमांड लाइन और ऑटोमेशन

कमांड लाइन और ऑटोमेशन

DDM को उसकी विंडो खोले बिना 3 तरीकों से चलाया जा सकता है:

  • ऐप की अपनी कमांड लाइन, जिसमें IDM जैसे ही स्विच हैं: किसी स्क्रिप्ट, बैच फ़ाइल या दूसरे प्रोग्राम से चल रहे ऐप को डाउनलोड सौंपें।
  • dannexdownloadmanager-cli, एक अलग कमांड-लाइन टूल: ऐप के बिना टर्मिनल में प्रगति देखते हुए फ़ाइलें, वीडियो और टॉरेंट डाउनलोड करें।
  • ऑटोमेशन API: दूसरे प्रोग्राम चल रहे ऐप के डाउनलोड की सूची (JSON के रूप में) पा सकते हैं और स्थानीय, टोकन-सुरक्षित चैनल के ज़रिए उन्हें रोक सकते हैं, शुरू कर सकते हैं, हटा सकते हैं या मिटा सकते हैं। AI सहायक इसका उपयोग DDM के MCP सर्वर के ज़रिए करते हैं: AI सहायक देखें।

पूरे ऐप को बिना किसी विंडो के, होम सर्वर या 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: लिंक टॉरेंट जोड़ें में इसे खोलें (जब DDM टॉरेंट खोलता है तो Windows यही पास करता है)।

स्विच / या - से शुरू हो सकते हैं, चाहे अक्षर बड़े हों या छोटे। 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) या किसी पते से चुना जा सकता है; एडाप्टर कनेक्ट न हो, तो कुछ नहीं भेजा जाता और डाउनलोड विफल हो जाता है। अगर किसी फ़ाइल होस्ट का लिंक आपके डीब्रिड खातों में से किसी एक (विकल्प → खाते) से डाउनलोड किया जा सकता है, तो ऐप की तरह वह लिंक उस खाते से डाउनलोड होता है। 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] [-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 सिस्टम का ffmpeg इस्तेमाल करता है)।
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 प्रिंट करता है, प्रति पंक्ति एक ऑब्जेक्ट, स्क्रिप्ट और AI एजेंटों के पढ़ने के लिए:

कमांड प्रिंट करता है
get, resume {"event": "through", "service"}पहले जब डाउनलोड एक डीब्रिड खाते के माध्यम से जाता है, फिर हर आधे सेकंड में एक {"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}

ऑटोमेशन 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 दिया जाता है।

ब्राउज़र एक्सटेंशन का टूलबार बटन उसी list से DDM के डाउनलोड सूचीबद्ध करता है, और उन्हीं कार्रवाइयों से उन्हें रोकता, फिर शुरू करता और उनके फ़ोल्डर खोलता है, चाहे API का स्विच कुछ भी हो: उसका हेल्पर जो माँगता है उसे "browser": true से चिह्नित करता है। वह इस तरह और कुछ नहीं माँगता।

हर अनुरोध और जवाब का वर्णन, फ़ील्ड दर फ़ील्ड, एक JSON Schema में किया गया है: automation-api.schema.json (जो https://dannex.kavangi.co.ke/automation-api.schema.json पर भी है)। यह उस कोड से बना है जिसका ऐप जवाब देता है, इसलिए यह सटीक रहता है; प्रोग्राम इसके खिलाफ जो भेजते और पढ़ते हैं उसकी जाँच कर सकते हैं, या इससे अपने प्रकार उत्पन्न कर सकते हैं।

उदाहरण

PowerShell (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 डाउनलोड करें