gallery dl

معرض-دل

Gallery-dl هو برنامج سطر أوامر لتنزيل معارض الصور ومجموعاتها من عدة مواقع لاستضافة الصور (راجع المواقع المدعومة). إنها أداة مشتركة بين الأنظمة الأساسية مع العديد من خيارات التكوين وإمكانيات تسمية الملفات القوية.

محتويات

• التبعيات

• خياري

• تثبيت

• نقطة

• مستقل قابل للتنفيذ

• يبني ليلا

• فرقعة

• شوكولاتة

• مغرفة

• البيرة المنزلية

• ماكبورتس

• عامل ميناء

• الاستخدام

• أمثلة

• إعدادات

• التوثيق

• المواقع

• المصادقة

• اسم المستخدم وكلمة المرور

• ملفات تعريف الارتباط

• OAuth

التبعيات

• بايثون 3.4+

• الطلبات

خياري

• yt-dlp أو youtube-dl: تنزيلات فيديو HLS/DASH، وتكامل ytdl

• FFmpeg: تحويل Pixiv Ugoira

• mkvmerge: رموز زمنية دقيقة لإطار Ugoira

• PySocks: دعم وكيل SOCKS

• brotli أو brotlicffi: دعم ضغط Brotli

• zstandard: دعم الضغط Zstandard

• PyYAML: دعم ملف تكوين YAML

• toml: دعم ملف تكوين TOML لـ Python<3.11

• SecretStorage: كلمات مرور حلقة مفاتيح GNOME لـ --cookies-from-browser

تثبيت

نقطة

يتم توزيع الإصدارات الثابتة من Gallery-dl على PyPI ويمكن تثبيتها أو ترقيتها بسهولة باستخدام النقطة:

 python3 -m pip install -U Gallery-dl

يمكن تثبيت أحدث إصدار من dev مباشرة من GitHub باستخدام النقطة أيضًا:

 python3 -m تثبيت النقطة -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz

ملاحظة: يجب على مستخدمي Windows استخدام py -3 بدلاً من python3 .

يُنصح باستخدام أحدث إصدار من pip، بما في ذلك الحزم الأساسية setuptools و wheel . للتأكد من أن هذه الحزم محدثة، قم بتشغيل

 python3 -m تثبيت النقطة - ترقية عجلة أدوات إعداد النقطة

مستقل قابل للتنفيذ

تتوفر ملفات قابلة للتنفيذ تم إنشاؤها مسبقًا مع مترجم Python وحزم Python المطلوبة المضمنة

• Windows (يتطلب حزمة Microsoft Visual C++ القابلة لإعادة التوزيع (x86))

• لينكس

يبني ليلا

يمكن العثور على الملفات التنفيذية التي تم إنشاؤها من أحدث الالتزام في

https://github.com/gdl-org/builds/releases

فرقعة

يمكن لمستخدمي Linux الذين يستخدمون توزيعة مدعومة بواسطة Snapd تثبيت Gallery-dl من متجر Snap Store:

 المفاجئة تثبيت معرض-dl

شوكولاتة

يمكن لمستخدمي Windows الذين قاموا بتثبيت Chocolatey تثبيت Gallery-dl من مستودع Chocolatey Community Packages:

 choco install Gallery-dl

مغرفة

Gallery-dl متاح أيضًا في مجموعة Scoop "الرئيسية" لمستخدمي Windows:

 مغرفة تثبيت معرض-DL

البيرة المنزلية

لمستخدمي macOS أو Linux الذين يستخدمون Homebrew:

 الشراب تثبيت معرض-DL

ماكبورتس

لمستخدمي macOS مع MacPorts:

 منفذ Sudo تثبيت Gallery-dl

عامل ميناء

استخدام ملف Dockerfile في المستودع:

 استنساخ بوابة https://github.com/mikf/gallery-dl.gitcdgallery-dl/
docker build -t Gallery-dl:latest .

سحب الصورة من Docker Hub:

 عامل ميناء سحب mikf123/gallery-dl
علامة عامل الميناء mikf123/gallery-dl Gallery-dl

سحب الصورة من سجل حاوية GitHub:

 عامل ميناء سحب ghcr.io/mikf/gallery-dl
علامة عامل الإرساء ghcr.io/mikf/gallery-dl Gallery-dl

لتشغيل الحاوية، قد ترغب في إرفاق بعض الأدلة على المضيف بحيث يستمر ملف التكوين والتنزيلات عبر عمليات التشغيل.

تأكد من تنزيل مرجع ملف التكوين النموذجي في الريبو ووضعه في موقع المجلد المثبت أو لمس ملف فارغ هناك.

إذا أعطيت الحاوية علامة مختلفة أو كنت تستخدم podman، فتأكد من ضبطها. قم بتشغيل docker image ls للتحقق من الاسم إذا لم تكن متأكدًا.

سيؤدي هذا إلى إزالة الحاوية بعد كل استخدام بحيث يكون لديك دائمًا بيئة جديدة لتشغيلها. إذا قمت بإعداد خط أنابيب ci-cd لبناء الحاوية تلقائيًا، فيمكنك أيضًا إضافة علامة --pull=newer بحيث تتحقق شركة docker عند تشغيلها لمعرفة ما إذا كانت هناك حاوية أحدث وتنزيلها قبل التشغيل.

 تشغيل عامل الميناء --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it Gallery-dl: أحدث

يمكنك أيضًا إضافة اسم مستعار إلى Shell الخاص بك لـ "gallery-dl" أو إنشاء برنامج نصي bash بسيط وإفلاته في مكان ما في $PATH ليكون بمثابة شريط لهذا الأمر.

الاستخدام

لاستخدام Gallery-dl، ما عليك سوى الاتصال به باستخدام عناوين URL التي ترغب في تنزيل الصور منها:

 Gallery-dl [خيارات]...عناوين URL...

استخدم gallery-dl --help أو راجع docs/options.md للحصول على قائمة كاملة بجميع خيارات سطر الأوامر.

أمثلة

تحميل الصور. في هذه الحالة من danbooru عبر علامة البحث عن "bonocho":

 معرض-dl "https://danbooru.donmai.us/posts?tags=bonocho"

احصل على عنوان URL المباشر لصورة من موقع يدعم المصادقة باستخدام اسم المستخدم وكلمة المرور:

 Gallery-dl -g -u "<اسم المستخدم>" -p "<password>" "https://twitter.com/i/web/status/604341487988576256"

تصفية فصول المانجا حسب رقم الفصل واللغة:

 Gallery-dl --chapter-filter "10 <= Chapter < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"

ابحث في مورد بعيد عن عناوين URL وقم بتنزيل الصور منها:

(سيتم تجاهل عناوين URL التي لا يمكن العثور على مستخرج لها بصمت)

 Gallery-dl "r:https://pastebin.com/raw/FLwrCYsT"

إذا كان عنوان الموقع غير قياسي بالنسبة لمستخرجه، فيمكنك إضافة بادئة لعنوان URL باسم المستخرج لفرض استخدام مستخرج معين:

 Gallery-dl "tumblr:https://sometumblrblog.example"

إعدادات

تستخدم ملفات التكوين لـ Gallery-dl تنسيق ملف يستند إلى JSON.

التوثيق

يمكن العثور على قائمة بجميع خيارات التكوين المتاحة وأوصافها على https://gdl-org.github.io/docs/configuration.html.

للحصول على ملف تكوين افتراضي مع تعيين الخيارات المتاحة على قيمها الافتراضية، راجع docs/gallery-dl.conf.

للحصول على مثال تم التعليق عليه يحتوي على المزيد من الإعدادات المعنية واستخدام الخيارات، راجع docs/gallery-dl-example.conf.

المواقع

يبحث Gallery-dl عن ملفات التكوين في الأماكن التالية:

• ويندوز:

• ( يشير %USERPROFILE% عادة إلى الدليل الرئيسي للمستخدم، على سبيل المثال C:Users<username> )

• %APPDATA%gallery-dlconfig.json

• %USERPROFILE%gallery-dlconfig.json

• %USERPROFILE%gallery-dl.conf

• لينكس، ماك، وما إلى ذلك:

• 
  

• /etc/gallery-dl.conf

• ${XDG_CONFIG_HOME}/gallery-dl/config.json

• ${HOME}/.config/gallery-dl/config.json

• ${HOME}/.gallery-dl.conf

عند تشغيله كملف قابل للتنفيذ، سيبحث Gallery-dl أيضًا عن ملف gallery-dl.conf في نفس الدليل الذي يحتوي على الملف القابل للتنفيذ المذكور.

من الممكن استخدام أكثر من ملف تكوين واحد في نفس الوقت. في هذه الحالة، سيتم دمج أي قيم من الملفات بعد الأولى في الإعدادات المحملة بالفعل ومن المحتمل أن تتجاوز الإعدادات السابقة.

المصادقة

اسم المستخدم وكلمة المرور

تطلب منك بعض المستخرجات تقديم بيانات اعتماد تسجيل دخول صالحة في شكل زوج من اسم المستخدم وكلمة المرور. يعد هذا ضروريًا لـ nijie واختياري لـ aryion و danbooru و e621 و exhentai و idolcomplex و imgbb و inkbunny و mangadex و mangoxo و pillowfort و sankaku و subscribestar و tapas و tsumino و twitter و zerochan .

يمكنك تعيين المعلومات الضرورية في ملف التكوين الخاص بك

 { "المستخرج": { "تويتر": { "اسم المستخدم": "<اسم المستخدم>"، "كلمة المرور": "<كلمة المرور>"
        }
    }
}

أو يمكنك تقديمها مباشرةً عبر -u/--username و- -p/--password أو عبر -o/--option خيارات سطر الأوامر

 Gallery-dl -u "<username>" -p "<password>" "URL"gallery-dl -o "username=<username>" -o "password=<password>" "URL"

ملفات تعريف الارتباط

بالنسبة للمواقع التي لا يمكن فيها تسجيل الدخول باسم المستخدم وكلمة المرور بسبب اختبار CAPTCHA أو ما شابه، أو لم يتم تنفيذها بعد، يمكنك استخدام ملفات تعريف الارتباط من جلسة تسجيل الدخول بالمتصفح وإدخالها في Gallery-dl .

يمكن القيام بذلك عبر خيار ملفات تعريف الارتباط في ملف التكوين الخاص بك عن طريق تحديد

• المسار إلى ملف cookie.txt بتنسيق Mozilla/Netscape الذي تم تصديره بواسطة ملحق المتصفح

  (على سبيل المثال، احصل على ملف تعريف الارتباط ملف تعريف الارتباط محليًا لمتصفح Chrome، وقم بتصدير ملفات تعريف الارتباط لمتصفح فايرفوكس)

• قائمة بأزواج الاسم والقيمة التي تم جمعها من أدوات مطور الويب في متصفحك

  (في كروم، في فايرفوكس)

• اسم المتصفح الذي سيتم استخراج ملفات تعريف الارتباط منه

  (المتصفحات المدعومة هي تلك التي تعتمد على Chromium وFirefox وSafari)

على سبيل المثال:

 { "المستخرج": { "instagram": { "ملفات تعريف الارتباط": "$HOME/path/to/cookies.txt"
        }, "patreon": { "ملفات تعريف الارتباط": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
            }
        }, "twitter": { "ملفات تعريف الارتباط": ["فايرفوكس"]
        }
    }
}

يمكنك أيضًا تحديد ملف cookies.txt باستخدام خيار سطر الأوامر --cookies

أو متصفح لاستخراج ملفات تعريف الارتباط منه باستخدام --cookies-from-browser :

 Gallery-dl --cookies "$HOME/path/to/cookies.txt" "URL"gallery-dl --cookies-from-browser فايرفوكس "URL"

OAuth

يدعم Gallery-dl مصادقة المستخدم عبر OAuth لبعض المستخرجين. يعد هذا ضروريًا لـ pixiv واختياريًا لمثيلات deviantart و flickr و reddit و smugmug و tumblr و mastodon .

إن ربط حسابك بـ Gallery-dl يمنحه القدرة على إصدار الطلبات نيابة عن حسابك ويمكّنه من الوصول إلى الموارد التي قد تكون غير متاحة للمستخدم العام.

للقيام بذلك، ابدأ باستدعائه باستخدام oauth:<sitename> كوسيطة. على سبيل المثال:

 معرض-dl oauth: فليكر

سيتم إرسالك إلى صفحة الترخيص الخاصة بالموقع وسيُطلب منك منح حق الوصول للقراءة إلى Gallery-dl . قم بتخويله وسيظهر لك "رمز مميز" واحد أو أكثر، والذي يجب إضافته إلى ملف التكوين الخاص بك.

للمصادقة باستخدام مثيل mastodon ، قم بتشغيل Gallery-dl باستخدام oauth:mastodon:<instance> كوسيطة. على سبيل المثال:

 Gallery-dl oauth:mastodon:pawoo.net
Gallery-dl oauth:mastodon:https://mastodon.social/