Chuyển đến nội dung

mikf / gallery-dl

gallery-dl

Công cụ dòng lệnh tải hàng loạt ảnh và bộ sưu tập từ rất nhiều trang chia sẻ ảnh về máy

gallery-dl là chương trình dòng lệnh viết bằng Python, dán link của một album, tài khoản hoặc kết quả tìm kiếm vào là nó tải toàn bộ ảnh về máy. Hỗ trợ rất nhiều trang chia sẻ ảnh và có hệ thống cấu hình, đặt tên file khá mạnh. Lưu ý quan trọng: README cho biết dự án đã chuyển nơi phát triển chính sang Codeberg.

  • 20.535 sao
  • 1.533 fork
  • Python
  • Cập nhật 2 ngày trước
  • GPL 2.0 (sửa đổi phải công bố mã)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Dòng lệnh (CLI)
Chạy trên
Windows, macOS, Linux, Python, Docker
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng gallery-dl

Bạn cài gallery-dl, mở Terminal (cửa sổ gõ lệnh) rồi gõ tên chương trình kèm đường link của một album hay một trang cá nhân trên trang chia sẻ ảnh được hỗ trợ. Chương trình tự nhận ra trang nào, liệt kê các ảnh trong đó và tải về thư mục hiện tại, thường sắp theo thư mục con đặt theo tên trang hoặc tên bộ ảnh.

Muốn kiểm soát hơn, bạn thêm các tuỳ chọn như lọc theo số chương của truyện tranh, chọn ngôn ngữ, chỉ lấy đường link ảnh thay vì tải, hoặc đăng nhập bằng tài khoản của chính mình với các trang yêu cầu. Cách đặt tên file và thư mục có thể tuỳ biến bằng mẫu, và cấu hình lưu trong một file JSON.

Vì là công cụ dòng lệnh nên phù hợp người chịu khó đọc tài liệu. Khi đã thiết lập xong, bạn có thể chạy theo lịch hoặc theo danh sách link để sưu tầm ảnh một cách có tổ chức.

Tính năng nổi bật

Hỗ trợ nhiều trang ảnh

Mỗi trang có một bộ trích xuất riêng, bạn chỉ cần dán link và công cụ biết phải lấy gì.

Đặt tên và sắp xếp file linh hoạt

Dùng mẫu đặt tên để tự chia thư mục theo tác giả, album, ngày đăng hoặc số chương.

Lọc nội dung trước khi tải

Có tuỳ chọn lọc theo điều kiện như số chương hay ngôn ngữ, đỡ tải thừa.

Đăng nhập và dùng cookie

Hỗ trợ tài khoản, và cookie lấy từ trình duyệt cho những trang cần đăng nhập mới xem được nội dung.

Kết hợp yt-dlp, FFmpeg

Có thể dùng thêm yt-dlp cho video, FFmpeg để chuyển ảnh động Ugoira của Pixiv thành video.

Nhiều cách cài

Cài bằng pip, bản chạy sẵn cho Windows và Linux, hoặc qua Chocolatey, Scoop, Homebrew, Snap, Docker.

Tận dụng gallery-dl vào việc gì?

Nhiếp ảnh gia, hoạ sĩ

Lưu bản sao ảnh của chính mình trên các trang chia sẻ

Tải lại toàn bộ album bạn đã đăng trên các nền tảng để có bản sao lưu ngoài dịch vụ.

Người làm thiết kế, nội dung

Thu thập tư liệu hình ảnh cho dự án

Tải bộ ảnh tham khảo mà tác giả cho phép dùng, để làm moodboard hoặc nghiên cứu. Luôn kiểm tra giấy phép từng ảnh.

Người đọc truyện

Đọc truyện tranh offline

Tải các chương truyện hợp pháp về máy rồi đọc khi không có mạng, với điều kiện nguồn cho phép tải.

Lập trình viên, người thích script

Tự động hoá việc sưu tầm

Gọi gallery-dl trong script, kết hợp lịch chạy để cập nhật bộ sưu tập định kỳ.

Cần chuẩn bị gì?

  • Python 3.8 trở lên nếu cài bằng pip; hoặc dùng bản chạy sẵn cho Windows và Linux.
  • Trên Windows, bản chạy sẵn cần Microsoft Visual C++ Redistributable theo README.
  • Tuỳ chọn: yt-dlp hoặc youtube-dl cho video, FFmpeg cho Pixiv Ugoira, và một số gói phụ khác cho proxy hoặc cấu hình.
  • Tài khoản hoặc cookie trình duyệt nếu trang bạn muốn tải yêu cầu đăng nhập.

Hướng dẫn cài đặt chi tiết

Cài trên pip

  1. Cách chung cho mọi hệ điều hành đã cài Python. Mở Terminal hoặc PowerShell và chạy lệnh dưới. README lưu ý người dùng Windows có thể dùng lệnh py thay cho python.

    Terminal
    python -m pip install -U gallery-dl
  2. Kiểm tra cài thành công bằng lệnh xem trợ giúp.

    Terminal
    gallery-dl --help

Cài trên Windows

  1. Cách dễ cho người không dùng Python: tải bản chạy sẵn (file .exe) từ trang Releases của dự án và đặt vào một thư mục. Cần cài thêm Microsoft Visual C++ Redistributable theo hướng dẫn trong README.

    Văn bản
    https://github.com/mikf/gallery-dl/releases
  2. Nếu đã có trình quản lý gói, README cũng liệt kê cách cài bằng Chocolatey hoặc Scoop.

    PowerShell
    scoop install gallery-dl
  3. Hoặc dùng Chocolatey.

    PowerShell
    choco install gallery-dl

Cài trên macOS và Linux

  1. Trên macOS hoặc Linux có Homebrew, cài bằng một lệnh.

    Terminal
    brew install gallery-dl
  2. Trên Linux có Snap, README cũng hỗ trợ cài từ Snap Store.

    Terminal
    snap install gallery-dl
  3. Người dùng macOS có MacPorts có thể cài bằng lệnh sau.

    Terminal
    sudo port install gallery-dl

Cài trên Docker

  1. Kéo image về và đặt tên ngắn gọn để dùng. Image có trên Docker Hub và GitHub Container Registry.

    Terminal
    docker pull mikf123/gallery-dl
    docker tag mikf123/gallery-dl gallery-dl
  2. Chạy container, gắn thư mục tải xuống và file cấu hình của bạn để dữ liệu không mất sau mỗi lần chạy. Đây là mẫu trong README, hãy đổi đường dẫn cho đúng máy của bạn.

    Terminal
    docker run --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it gallery-dl:latest

Dùng thử lần đầu

  1. Mở Terminal hoặc PowerShell và chuyển vào thư mục bạn muốn lưu ảnh, ví dụ một thư mục thử nghiệm trống.

  2. Chạy gallery-dl với link của một album hoặc trang bạn có quyền tải. Thay đường link cho đúng.

    Terminal
    gallery-dl "https://example.com/link-album-cua-ban"
  3. Muốn chỉ xem đường link trực tiếp của ảnh mà không tải, thêm tuỳ chọn -g.

    Terminal
    gallery-dl -g "https://example.com/link-album-cua-ban"
  4. Với trang cần đăng nhập, bạn thêm tài khoản của chính mình bằng -u và -p, hoặc dùng cookie trình duyệt theo hướng dẫn của tài liệu cấu hình.

  5. Xem toàn bộ tuỳ chọn và các trang được hỗ trợ khi cần.

    Terminal
    gallery-dl --help

Mẹo dùng hay

  • Đọc tài liệu cấu hình để đặt thư mục gốc và mẫu tên file ngay từ đầu, đỡ phải sắp xếp lại ảnh sau này.
  • Trước khi tải cả một tài khoản lớn, thử với một album nhỏ để kiểm tra kết quả.
  • Dùng tuỳ chọn lọc chương hoặc ngôn ngữ khi tải truyện tranh để không tải thừa.
  • Cập nhật gallery-dl thường xuyên vì các trang web hay đổi cách hoạt động và công cụ phải cập nhật theo.

Lưu ý và hạn chế

  • Nội dung bạn tải thường có bản quyền của tác giả. Chỉ tải về dùng cá nhân khi được phép, đừng đăng lại hay bán, và tuân thủ điều khoản của từng trang.
  • Tải hàng loạt có thể bị trang web hạn chế hoặc chặn IP, hoặc vi phạm điều khoản sử dụng. Hãy tải ở tốc độ hợp lý.
  • Dự án đã chuyển nơi phát triển chính sang Codeberg theo README, nên repo GitHub có thể không phải nơi cập nhật mới nhất. Kiểm tra trang Codeberg khi cần bản mới.
  • Đây là công cụ dòng lệnh, chưa có giao diện đồ hoạ, người mới sẽ cần thời gian làm quen.

Câu hỏi thường gặp

gallery-dl có miễn phí không?

Có, mã nguồn mở theo giấy phép GPL-2.0 và không cần trả tiền. Bạn chỉ cần Python hoặc bản chạy sẵn.

Khác gì với yt-dlp?

yt-dlp chủ yếu tải video và âm thanh, còn gallery-dl tập trung vào ảnh và bộ sưu tập. Hai công cụ có thể dùng chung, README cũng nhắc gallery-dl có thể dùng yt-dlp để tải video.

Dùng có hợp pháp không?

Bản thân công cụ hợp pháp, nhưng việc tải nội dung có hợp pháp hay không phụ thuộc vào bản quyền, điều khoản của trang và luật nơi bạn ở. Bạn nên chỉ tải nội dung mình có quyền sử dụng.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/mikf/gallery-dl.git

Repo tương tự nên xem

Video, nhạc & tải xuống208K

yt-dlp

yt-dlp / yt-dlp

Công cụ dòng lệnh tải video và âm thanh từ YouTube cùng hàng nghìn trang web khác

VừaWindowsmacOSLinuxPython
Video, nhạc & tải xuống46,3K

cobalt

imputnet / cobalt

Dán link, nhận file: công cụ tải video và âm thanh không quảng cáo, không theo dõi

VừaWebDockerNode.js
Video, nhạc & tải xuống31,8K

Lux

iawia002 / lux

Công cụ dòng lệnh viết bằng Go để tải video từ nhiều trang, mạnh ở các trang Trung Quốc

VừaWindowsmacOSLinux

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Video, nhạc & tải xuống

Video, nhạc & tải xuống119K

Immich

immich-app / immich

Kho ảnh và video riêng của gia đình bạn: tự động sao lưu từ điện thoại, tìm theo khuôn mặt và nội dung

VừaDockerWebAndroidiOS+1
Video, nhạc & tải xuống67,4K

FFmpeg

FFmpeg / FFmpeg

Bộ công cụ dòng lệnh để chuyển đổi, cắt, ghép và xử lý video, âm thanh mọi định dạng

VừaWindowsmacOSLinux
Video, nhạc & tải xuống59,4K

Jellyfin

jellyfin / jellyfin

Tự lập thư viện phim, nhạc, ảnh của riêng bạn để xem trên TV, điện thoại và trình duyệt

VừaWindowsmacOSLinuxDocker
Video, nhạc & tải xuống58,4K

Motrix

agalwood / Motrix

Trình quản lý tải file gọn đẹp: link thường, torrent và magnet trong một giao diện

DễWindowsmacOSLinuxDocker
Video, nhạc & tải xuống50,8K

Spotube

team-spotube / spotube

Ứng dụng nghe nhạc mã nguồn mở chạy bằng plugin, có trên máy tính và điện thoại

VừaWindowsmacOSLinuxAndroid
Video, nhạc & tải xuống46,1K

LosslessCut

mifi / lossless-cut

Cắt, ghép video và âm thanh trong tích tắc mà không nén lại, không mất chất lượng

DễWindowsmacOSLinux

Xem cả 20 repo Video, nhạc & tải xuống Về Kho Repo