Skip to content

A web-based application for managing and downloading webtoons from various sources. Track your favorite series, automatically check for new episodes, and download them in your preferred format (PDF, images, or CBZ).

Notifications You must be signed in to change notification settings

AKASGaming/webtoon-manager

Repository files navigation

Webtoon Manager

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).

Features

  • πŸ“š 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

Pictures

Main Interface Views

Main subscriptions view displaying all tracked webtoon series

Features & Functionality

Add subscription modal for adding new webtoon series Series episodes list showing available episodes for download Filter and search toolbar for finding specific series Bulk download options for downloading multiple episodes Download progress display showing active download jobs Download jobs view with job history and status Jobs and logs view displaying detailed download logs Mobile responsive view showing the interface on smaller screens

Settings & Configuration

Global settings modal for configuring application preferences Series settings modal for configuring individual series preferences

Extras

Adding subscriptions Quick download menu Job and downloads

Prerequisites

  • Python 3.11+ (for local development)
  • Docker and Docker Compose (for containerized deployment)
  • Internet connection for scraping and downloading webtoons

Quick Start (Docker Compose)

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 down

Access the web interface at http://localhost:8128

Installation

Using Docker Compose (Recommended)

  1. Clone this repository:

    git clone https://github.com/AKASGaming/webtoon-manager.git
    cd webtoonhub
  2. Start the application:

    docker-compose up -d
  3. Access the web interface at http://localhost:8128

Docker Compose Configuration

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-stopped

Volume 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)

Local Development

  1. Clone this repository:

    git clone https://github.com/AKASGaming/webtoon-manager.git
    cd webtoonhub
  2. Create a virtual environment:

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
  3. Install dependencies:

    pip install -r requirements.txt
  4. Run the application:

    python app.py
  5. Access the web interface at http://localhost:8128

Usage

  1. Add a Series: Enter a webtoon series URL to subscribe to it
  2. Configure Settings: Set your preferred download format, path template, and auto-check interval
  3. Download Episodes: Download individual episodes or use bulk download options
  4. Monitor Progress: Track download progress and job status in real-time

Project Structure

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)

Configuration

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)

Credits

This project uses the following open-source libraries and tools:

Special thanks to the developers and maintainers of these projects for making this application possible.

Disclaimer

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.

About

A web-based application for managing and downloading webtoons from various sources. Track your favorite series, automatically check for new episodes, and download them in your preferred format (PDF, images, or CBZ).

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •