README

Goader là công cụ dòng lệnh giúp tải nội dung (đặc biệt là truyện tranh/webtoon) từ nhiều host khác nhau, đồng thời cung cấp bộ tiện ích xử lý ảnh, đổi tên và xuất file phục vụ quá trình dịch hoặc lưu trữ.

Key features

Tải toàn bộ chương/ảnh từ các host được hỗ trợ (xem danh sách chi tiết trong tài liệu).
Tùy chọn --sequence, --prefix, --offset để kiểm soát tên file và thứ tự tải.
Hệ thống plugin linh hoạt: có thể mở rộng command, hook và downloader mà không sửa core.
Công cụ phụ trợ: đổi tên file hàng loạt, trích layer Photoshop, ghép ảnh bằng ImageMagick.
Hỗ trợ cấu hình tài khoản, cookie và token theo host thông qua goader config.

Requirements

PHP 7.4+ với Composer.
wget (dùng làm downloader mặc định) và ImageMagick convert cho các lệnh extract/merge.
Hệ điều hành bất kỳ có thể chạy PHP CLI (Windows, macOS, Linux).

Quick install

composer global require puleeno/goadher
# hoặc cài đặt trong dự án
composer require puleeno/goadher

Sau khi cài, bảo đảm thư mục vendor/bin nằm trong PATH rồi dùng lệnh goader --help để kiểm tra.

Basic usage

Tải chương từ URL: goader download https://example.com/comic/chapter-1
Tải theo danh sách URL (mỗi dòng một link): goader download file_list.txt
Cấu hình tài khoản/host: goader config account --host=lezhin.com user pass

Chi tiết từng command nằm trong tài liệu “Hướng dẫn sử dụng”.

Bundled tools

goader rename: đổi tên và đổi đuôi file hàng loạt, hỗ trợ slugify, sequence, prefix, jump.
goader extract: trích layer từ file PSD/PSB/TIFF hoặc chuyển đổi hàng loạt ảnh.
goader merge: ghép nhiều ảnh theo chiều ngang/dọc, chia nhóm tuỳ chỉnh.

Development & extension

Danh sách host hỗ trợ sẵn: xem “Máy chủ được hỗ trợ”.
Quy trình viết downloader cho host mới: “Phát triển host mới”.
Kiến trúc chi tiết, hệ thống hook và plugin: “Hướng dẫn developer”.

Để đóng góp, fork repository và tạo pull request. Vui lòng mô tả rõ host/command mới, cũng như cập nhật tài liệu liên quan.

License

Dự án phát hành theo giấy phép MIT.

puleeno / goader

Maintainers

Details