منصوبے کے بارے میں

gallery-dl ایک کمانڈ لائن پروگرام ہے جو مختلف امیج ہوسٹنگ سائٹس سے تصویری گیلریاں اور مجموعے ڈاؤن لوڈ کرنے کے لیے ڈیزائن کیا گیا ہے۔ یہ ایک کراس پلیٹ فارم ٹول ہے جو Windows، Linux اور macOS کو سپورٹ کرتا ہے، اور Python میں لکھا گیا ہے (جس کے لیے Python 3.8+ اور Requests لائبریری درکار ہے)۔ اہم خصوصیات میں شامل ہیں: - **ملٹی سائٹ سپورٹ**: متعدد امیج ہوسٹنگ پلیٹ فارمز کے لیے ایکسٹریکٹرز، بشمول danbooru، Twitter، Pixiv، MangaDex، Tumblr، Instagram، Patreon، Flickr، Reddit، DeviantArt اور مزید۔ معاون سائٹس کی مکمل فہرست پروجیکٹ کی دستاویزات میں موجود ہے۔ - **وسیع ترتیب**: JSON پر مبنی کنفیگریشن فائلیں جن میں ڈاؤن لوڈ رویے، فائل نام، تصدیق، کوکیز اور مزید کے لیے بڑی تعداد میں اختیارات ہوتے ہیں۔ ایک سے زیادہ کنفیگریشن فائلوں کو ضم کیا جا سکتا ہے، بعد والی فائلیں پہلے والیوں کو زیر کر دیتی ہیں۔ کنفیگریشن فائلیں پلیٹ فارم کے مخصوص مقامات پر تلاش کی جاتی ہیں (مثلاً Windows پر %APPDATA%، Linux/macOS پر ~/.config/gallery-dl/)۔ - **طاقتور فائل نام دینا**: حسب ضرورت نام دینے کے نمونوں کے ساتھ ڈاؤن لوڈ کردہ فائلوں کو منظم کرنے کے لیے لچکدار فارمیٹنگ صلاحیتیں۔ - **تصدیقی معاونت**: متعدد تصدیقی طریقے، بشمول یوزر نام/پاس ورڈ جوڑے، براؤزر کوکی نکالنا (Chromium پر مبنی براؤزرز، Firefox اور Safari سے)، اور Pixiv، Flickr، Reddit، DeviantArt اور Mastodon جیسی سائٹس کے لیے OAuth۔ - **فلٹرنگ اور اختیارات**: مواد کو فلٹر کرنے کے لیے کمانڈ لائن اختیارات (مثلاً باب نمبر اور زبان کے لحاظ سے)، مخصوص ایکسٹریکٹرز کو مجبور کرنا، اور URLs کے لیے ریموٹ وسائل تلاش کرنا۔ - **ویڈیو سپورٹ**: HLS/DASH ویڈیو ڈاؤن لوڈ کے لیے yt-dlp یا youtube-dl کے ساتھ اختیاری انضمام، اور Pixiv Ugoira کی تبدیلی کے لیے FFmpeg۔ - **متعدد تنصیب کے طریقے**: pip (PyPI)، Windows اور Linux کے لیے اسٹینڈ اسٹون ایگزیکیوٹیبلز، Snap، Chocolatey، Scoop، Homebrew، MacPorts، Docker (Docker Hub اور GitHub Container Registry)، اور Nix/Home Manager کے ذریعے دستیاب ہے۔ - **آرکائیو سپورٹ**: پہلے سے ڈاؤن لوڈ شدہ اشیاء کو ٹریک کرنے کے لیے Psycopg کے ذریعے اختیاری PostgreSQL آرکائیو سپورٹ۔ - **پروکسی اور کمپریشن**: PySocks کے ذریعے اختیاری SOCKS پروکسی سپورٹ، brotli/brotlicffi کے ذریعے Brotli کمپریشن، اور zstandard کے ذریعے Zstandard کمپریشن۔ ٹول کو URLs کو دلائل کے طور پر دیکر استعمال کیا جاتا ہے: `gallery-dl [OPTIONS]... URLS...`۔ یہ ریموٹ URL تلاش کا موڈ بھی سپورٹ کرتا ہے (`r:` کے ساتھ ابتدا) تاکہ کسی ریموٹ وسیلہ میں درج URLs سے تصاویر تلاش اور ڈاؤن لوڈ کی جا سکیں۔ جب سائٹ کا پتہ غیر معیاری ہو تو مخصوص ایکسٹریکٹر کو مجبور کرنے کے لیے URLs سے پہلے ایکسٹریکٹر کے نام لگائے جا سکتے ہیں۔ فعال ترقی Codeberg پر منتقل ہو گئی ہے، جس کا پروجیکٹ https://codeberg.org/mikf/gallery-dl پر میزبان ہے۔