gallery dl
1.27.7
gallery-dl adalah program baris perintah untuk mengunduh galeri dan koleksi gambar dari beberapa situs hosting gambar (lihat Situs yang Didukung). Ini adalah alat lintas platform dengan banyak opsi konfigurasi dan kemampuan penamaan file yang kuat.
Isi
Ketergantungan
Opsional
Instalasi
pip
Dapat Dieksekusi Mandiri
Pembangunan Malam Hari
Patah
coklat
Sendok
minuman rumahan
MacPort
Buruh pelabuhan
Penggunaan
Contoh
Konfigurasi
Dokumentasi
Lokasi
Otentikasi
Nama Pengguna & Kata Sandi
kue
OAuth
Python 3.4+
Permintaan
yt-dlp atau youtube-dl: pengunduhan video HLS/DASH, integrasi ytdl
FFmpeg: Konversi Pixiv Ugoira
mkvmerge: Kode waktu bingkai Ugoira yang akurat
PySocks: dukungan proksi SOCKS
brotli atau brotlicffi: Dukungan kompresi Brotli
zstandar: Dukungan kompresi Zstandar
PyYAML: dukungan file konfigurasi YAML
toml: dukungan file konfigurasi TOML untuk Python<3.11
SecretStorage: Kata sandi keyring GNOME untuk --cookies-from-browser
Rilis stabil gallery-dl didistribusikan di PyPI dan dapat dengan mudah diinstal atau ditingkatkan menggunakan pip:
python3 -m pip install -U galeri-dl
Menginstal versi dev terbaru langsung dari GitHub juga dapat dilakukan dengan pip:
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz
Catatan: Pengguna Windows harus menggunakan py -3 dari pada python3 .
Disarankan untuk menggunakan pip versi terbaru, termasuk paket penting setuptools dan wheel . Untuk memastikan paket-paket ini mutakhir, jalankan
python3 -m pip install --upgrade pip setuptools roda
File yang dapat dieksekusi yang telah dibuat sebelumnya dengan juru bahasa Python dan paket Python yang diperlukan disertakan tersedia untuk
Windows (Memerlukan Paket Microsoft Visual C++ Redistributable (x86))
Linux
Executable yang dibuat dari komit terbaru dapat ditemukan di
https://github.com/gdl-org/builds/releases
Pengguna Linux yang menggunakan distro yang didukung oleh Snapd dapat menginstal gallery-dl dari Snap Store:
jepret instal galeri-dl
Pengguna Windows yang menginstal Chocolatey dapat menginstal gallery-dl dari repositori Paket Komunitas Chocolatey:
choco instal galeri-dl
gallery-dl juga tersedia di ember Scoop "utama" untuk pengguna Windows:
sendok instal galeri-dl
Untuk pengguna macOS atau Linux yang menggunakan Homebrew:
pembuatan bir instal galeri-dl
Untuk pengguna macOS dengan MacPorts:
sudo port instal galeri-dl
Menggunakan Dockerfile di repositori:
git clone https://github.com/mikf/gallery-dl.gitcd gallery-dl/ buruh pelabuhan membangun -t galeri-dl:terbaru .
Menarik gambar dari Docker Hub:
buruh pelabuhan menarik mikf123/gallery-dl tag buruh pelabuhan mikf123/gallery-dl gallery-dl
Menarik gambar dari GitHub Container Registry:
buruh pelabuhan menarik ghcr.io/mikf/gallery-dl tag buruh pelabuhan ghcr.io/mikf/gallery-dl gallery-dl
Untuk menjalankan container, Anda mungkin ingin melampirkan beberapa direktori pada host sehingga file konfigurasi dan unduhan dapat bertahan selama proses berjalan.
Pastikan untuk mengunduh contoh referensi file konfigurasi di repo dan letakkan di lokasi volume terpasang atau sentuh file kosong di sana.
Jika Anda memberi tag berbeda pada penampung atau menggunakan podman, pastikan Anda menyesuaikannya. Jalankan docker image ls untuk memeriksa namanya jika Anda tidak yakin.
Ini akan menghapus wadah setelah digunakan sehingga Anda akan selalu memiliki lingkungan segar untuk menjalankannya. Jika Anda menyiapkan pipeline ci-cd untuk membuat container secara otomatis, Anda juga dapat menambahkan flag --pull=newer sehingga saat Anda menjalankannya, buruh pelabuhan akan memeriksa apakah ada container yang lebih baru dan mendownloadnya sebelum dijalankan.
menjalankan buruh pelabuhan --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it gallery-dl: terbaru
Anda juga dapat menambahkan alias ke shell Anda untuk "gallery-dl" atau membuat skrip bash sederhana dan meletakkannya di suatu tempat di $PATH Anda untuk bertindak sebagai shim untuk perintah ini.
Untuk menggunakan gallery-dl cukup panggil dengan URL tempat Anda ingin mengunduh gambar:
galeri-dl [PILIHAN]... URL...
Gunakan gallery-dl --help atau lihat docs/options.md untuk daftar lengkap semua opsi baris perintah.
Unduh gambar; dalam hal ini dari danbooru melalui pencarian tag untuk 'bonocho':
galeri-dl "https://danbooru.donmai.us/posts?tags=bonocho"
Dapatkan URL langsung gambar dari situs yang mendukung otentikasi dengan nama pengguna & kata sandi:
galeri-dl -g -u "<nama pengguna>" -p "<kata sandi>" "https://twitter.com/i/web/status/604341487988576256"
Filter bab manga berdasarkan nomor bab dan bahasa:
galeri-dl --chapter-filter "10 <= bab <20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"
Cari URL di sumber daya jarak jauh dan unduh gambar dari URL tersebut:
(URL yang ekstraktornya tidak dapat ditemukan akan diabaikan secara diam-diam)
galeri-dl "r:https://pastebin.com/raw/FLwrCYsT"
Jika alamat situs tidak standar untuk ekstraktornya, Anda dapat mengawali URL dengan nama ekstraktor untuk memaksa penggunaan ekstraktor tertentu:
galeri-dl "tumblr:https://sometumblrblog.example"
File konfigurasi untuk gallery-dl menggunakan format file berbasis JSON.
Daftar semua opsi konfigurasi yang tersedia dan deskripsinya dapat ditemukan di https://gdl-org.github.io/docs/configuration.html.
Untuk file konfigurasi default dengan opsi yang tersedia diatur ke nilai defaultnya, lihat docs/gallery-dl.conf.
Untuk contoh yang diberi komentar dengan pengaturan dan penggunaan opsi yang lebih terlibat, lihat docs/gallery-dl-example.conf.
gallery-dl mencari file konfigurasi di tempat berikut:
jendela:
( %USERPROFILE% biasanya mengacu pada direktori home pengguna, yaitu C:Users<username> )
%APPDATA%gallery-dlconfig.json
%USERPROFILE%gallery-dlconfig.json
%USERPROFILE%gallery-dl.conf
Linux, macOS, dll.:
/etc/gallery-dl.conf
${XDG_CONFIG_HOME}/gallery-dl/config.json
${HOME}/.config/gallery-dl/config.json
${HOME}/.gallery-dl.conf
Ketika dijalankan sebagai executable, gallery-dl juga akan mencari file gallery-dl.conf di direktori yang sama dengan executable tersebut.
Dimungkinkan untuk menggunakan lebih dari satu file konfigurasi sekaligus. Dalam hal ini, nilai apa pun dari file setelah yang pertama akan digabungkan ke dalam pengaturan yang sudah dimuat dan berpotensi menimpa pengaturan sebelumnya.
Beberapa ekstraktor mengharuskan Anda memberikan kredensial login yang valid dalam bentuk pasangan nama pengguna & kata sandi. Ini diperlukan untuk nijie dan opsional untuk aryion , danbooru , e621 , exhentai , idolcomplex , imgbb , inkbunny , mangadex , mangoxo , pillowfort , sankaku , subscribestar , tapas , tsumino , twitter , dan zerochan .
Anda dapat mengatur informasi yang diperlukan dalam file konfigurasi Anda
{ "extractor": { "twitter": { "nama pengguna": "<nama pengguna>", "kata sandi": "<kata sandi>"
}
}
} atau Anda dapat memberikannya secara langsung melalui -u/--username dan -p/--password atau melalui opsi baris perintah -o/--option
galeri-dl -u "<nama pengguna>" -p "<kata sandi>" "URL"galeri-dl -o "nama pengguna=<nama pengguna>" -o "kata sandi=<kata sandi>" "URL"
Untuk situs yang login dengan nama pengguna & kata sandi tidak dimungkinkan karena CAPTCHA atau sejenisnya, atau belum diterapkan, Anda dapat menggunakan cookie dari sesi login browser dan memasukkannya ke gallery-dl .
Ini dapat dilakukan melalui opsi cookie di file konfigurasi Anda dengan menentukan
jalur ke file cookies.txt berformat Mozilla/Netscape yang diekspor oleh add-on browser
(misalnya Dapatkan cookies.txt SECARA LOKAL untuk Chrome, Ekspor Cookie untuk Firefox)
daftar pasangan nama-nilai yang dikumpulkan dari alat pengembang web browser Anda
(di Chrome, di Firefox)
nama browser tempat mengekstrak cookie
(browser yang didukung adalah browser berbasis Chromium, Firefox, dan Safari)
Misalnya:
{ "extractor": { "instagram": { "cookies": "$HOME/path/to/cookies.txt"
}, "patreon": { "cookies": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
}
}, "twitter": { "cookie": ["firefox"]
}
}
} Anda juga dapat menentukan file cookies.txt dengan opsi baris perintah --cookies
atau browser untuk mengekstrak cookie dengan --cookies-from-browser :
galeri-dl --cookies "$HOME/path/ke/cookies.txt" "URL"gallery-dl --cookies-dari-browser firefox "URL"
gallery-dl mendukung otentikasi pengguna melalui OAuth untuk beberapa ekstraktor. Ini diperlukan untuk pixiv dan opsional untuk instance deviantart , flickr , reddit , smugmug , tumblr , dan mastodon .
Menautkan akun Anda ke gallery-dl memberinya kemampuan untuk mengeluarkan permintaan atas nama akun Anda dan memungkinkannya mengakses sumber daya yang tidak tersedia untuk pengguna publik.
Untuk melakukannya, mulailah dengan menjalankannya dengan oauth:<sitename> sebagai argumen. Misalnya:
galeri-dl oauth:flickr
Anda akan diarahkan ke halaman otorisasi situs dan diminta untuk memberikan akses baca ke gallery-dl . Otorisasi dan Anda akan diperlihatkan satu atau lebih "token", yang harus ditambahkan ke file konfigurasi Anda.
Untuk mengautentikasi dengan instance mastodon , jalankan gallery-dl dengan oauth:mastodon:<instance> sebagai argumen. Misalnya:
galeri-dl oauth:mastodon:pawoo.net galeri-dl oauth:mastodon:https://mastodon.social/
