Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lysagxra/mangaworlddownloader
Downloader for MangaWorld
https://github.com/lysagxra/mangaworlddownloader
bulk bulk-downloader concurrent-processing downloader manga manga-downloader parallel-processing pdf pdf-generation python python3
Last synced: 4 days ago
JSON representation
Downloader for MangaWorld
- Host: GitHub
- URL: https://github.com/lysagxra/mangaworlddownloader
- Owner: Lysagxra
- License: gpl-3.0
- Created: 2024-11-12T22:08:00.000Z (7 days ago)
- Default Branch: main
- Last Pushed: 2024-11-12T22:44:14.000Z (7 days ago)
- Last Synced: 2024-11-12T23:19:48.238Z (7 days ago)
- Topics: bulk, bulk-downloader, concurrent-processing, downloader, manga, manga-downloader, parallel-processing, pdf, pdf-generation, python, python3
- Language: Python
- Homepage:
- Size: 366 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MangaWorld Downloader
> A Python-based tool for downloading and organizing manga content from MangaWorld.
![Demo](https://github.com/Lysagxra/MangaWorldDownloader/blob/8d3a28187c1b16f541ac6df1f6c82aa0b36e9725/misc/Demo.gif)
## Features
- Downloads multiple chapters concurrently.
- Supports batch downloading via a list of URLs.
- Convert downloaded chapters into PDFs.
- Track and display download progress.
- Organize and format manga chapters efficiently.## Dependencies
- Python 3
- `aiohttp` - for asynchronous HTTP requests
- `requests` - for HTTP requests
- `beautifulsoup4` (bs4) - for HTML parsing
- `Pillow` - for image processing
- `rich` - for progress display in terminal## Directory Structure
```
project-root/
├── helpers/
│ ├── download_utils.py # Utilities for managing the download process
│ ├── file_utils.py # Utilities for managing file operations
│ ├── format_utils.py # Functions for formatting manga data.
│ ├── general_utils.py # Miscellaneous utility functions
│ ├── pdf_generator.py # Tools for generating PDF files from manga chapters.
│ └── progress_utils.py # Utilities for tracking and displaying progress.
├── manga_downloader.py # Core functionality for managing manga downloads.
├── main.py # Main script to run the downloader.
└── URLs.txt # Text file containing manga URLs
```## Installation
1. Clone the repository:
```bash
git clone https://github.com/Lysagxra/MangaWorldDownloader.git
```
2. Navigate to the project directory:```bash
cd MangaWorldDownloader
```3. Install the required dependencies:
```bash
pip install -r requirements.txt
```## Single Manga Download
To download a single manga, you can use the `manga_downloader.py` script.
### Usage
Run the script followed by the manga URL you want to download:
```bash
python3 manga_downloader.py
```### Example
```bash
python3 manga_downloader.py https://www.mangaworld.ac/manga/2754/sayonara-eri
```## Batch Download
### Usage
1. Create a `URLs.txt` file in the project root and list the manga URLs you want to download.
2. Run the main script via the command line:
```bash
python3 main.py
```The downloaded files will be saved in the `Downloads` directory.
## PDF Generation
This tool includes a feature to generate PDFs from downloaded manga chapters. You can use the `-p` argument from the command line to enable this functionality.
### Usage
To generate PDFs for the downloaded manga, run the following command:
```bash
python3 main.py -p
```This will create PDF files for each chapter and save them in the specified output directory. The generated PDFs maintain the original quality of the downloaded images and are optimized for readability.