A web-based GUI application for managing and downloading webtoons using webtoon-downloader CLI! Track your favorite series, automatically check for new episodes, and download them in your preferred format (PDF, images, or CBZ).
- π Series Management: Add and manage webtoon subscriptions
- π Auto-Updates: Automatically check for new episodes at configurable intervals
- π₯ Download Management: Download episodes individually or in bulk
- πΌοΈ Thumbnail Caching: Cached episode thumbnails for faster browsing
- π Flexible Organization: Customize download paths and file naming
- π¨ Modern UI: Clean, responsive web interface
- π³ Docker Support: Easy deployment with Docker and Docker Compose
- Python 3.11+ (for local development)
- Docker and Docker Compose (for containerized deployment)
- Internet connection for scraping and downloading webtoons
The fastest way to get started is using Docker Compose:
# Clone the repository
git clone https://github.com/AKASGaming/webtoon-manager.git
cd webtoonhub
# Start the application
docker-compose up -d
# View logs (optional)
docker-compose logs -f
# Stop the application
docker-compose downAccess the web interface at http://localhost:8128
-
Clone this repository:
git clone https://github.com/AKASGaming/webtoon-manager.git cd webtoonhub -
Start the application:
docker-compose up -d
-
Access the web interface at
http://localhost:8128
The docker-compose.yml file is included in the repository:
services:
webtoon-manager:
build: .
container_name: webtoon_manager
ports:
- "8128:8128"
volumes:
- ./downloads:/app/downloads
- ./db:/app/db # Persist the SQLite database
- ./cache/thumbnails:/app/cache/thumbnails
restart: unless-stoppedVolume Mounts:
./downloads- Stores all downloaded webtoon files./db- Persists the SQLite database./cache/thumbnails- Caches episode thumbnails for faster loading
Ports:
8128- Web interface port (change if needed)
-
Clone this repository:
git clone https://github.com/AKASGaming/webtoon-manager.git cd webtoonhub -
Create a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
-
Run the application:
python app.py
-
Access the web interface at
http://localhost:8128
- Add a Series: Enter a webtoon series URL to subscribe to it
- Configure Settings: Set your preferred download format, path template, and auto-check interval
- Download Episodes: Download individual episodes or use bulk download options
- Monitor Progress: Track download progress and job status in real-time
webtoonhub/
βββ app.py # Main Flask application
βββ requirements.txt # Python dependencies
βββ Dockerfile # Docker image configuration
βββ docker-compose.yml # Docker Compose configuration
βββ templates/
β βββ index.html # Web interface
βββ db/ # SQLite database (created at runtime)
βββ downloads/ # Downloaded files (created at runtime)
βββ cache/ # Cached thumbnails (created at runtime)
The application uses a SQLite database to store:
- Subscriptions (series you're tracking)
- Episodes (individual episodes for each series)
- Jobs (download job history)
- Settings (global and per-series preferences)
This project uses the following open-source libraries and tools:
- webtoon-downloader - Core webtoon downloading functionality
- Flask - Web framework for the application interface
- Beautiful Soup - HTML parsing and web scraping
- Requests - HTTP library for making web requests
- lxml - XML and HTML parser
Special thanks to the developers and maintainers of these projects for making this application possible.
This tool is for personal use only. Please respect the terms of service of webtoon platforms and copyright holders. Only download content you have the right to access.