A powerful, Python wrapper for scraping manga data from weebcentral.com. This library provides a clean, object-oriented interface to search for manga, retrieve metadata, and download chapters as either individual images or compiled PDFs.

• Advanced Search: Filter manga by title, genre, status, type, and more.
• Detailed Metadata: Fetch all details for a manga series, including description, author, artist, aliases, and related series.
• Chapter & Page Retrieval: Easily get lists of all chapters for a manga and all pages for a chapter.
• Powerful Downloader:
  • Download a range of chapters for a specific manga.
  • Download chapters as neatly compiled PDF files.
  • Download chapters as raw image files organized in folders.
• Efficient & Resilient: Built-in caching, request retries, and threading for fast and reliable performance.
• Type-Hinted & Easy to Use: A clean, modern, and fully type-hinted codebase for deeper understanding

To install the library and its dependencies, run the following command:

pip install requests beautifulsoup4 Pillow fpdf2 ua-generator

You will also need the enums.py file in the same directory as weeb.py to import the necessary filter criteria.

Here's a simple example to search for a manga and download the first five chapters as PDFs.

from weeb_central import Weeb, Manga, Chapter, NetworkError, ParsingError # 1. Initialize the main client weeb = Weeb() try: # 2. Search for a manga print("Searching for 'Solo Leveling'...") search_results = weeb.search(query="Solo Leveling") if not search_results: print("No manga found.") else: # 3. Select the first result my_manga = search_results[0] print(f"Found: {my_manga.title}") # 4. Fetch the list of all chapters print("Fetching chapter list...") all_chapters = my_manga.get_chapters() print(f"Total chapters found: {len(all_chapters)}") # 5. Filter for chapters 1 through 5 chapters_to_download = my_manga.filter_chapters(all_chapters, start=1, end=5) print(f"Preparing to download {len(chapters_to_download)} chapters...") # 6. Download the filtered chapters # This will create a folder named 'Solo-Leveling' and save PDFs inside. my_manga.download(chapters_to_download) print("Download complete!") except (NetworkError, ParsingError) as e: print(f"An error occurred: {e}")

The library is structured around several core classes: Weeb, Manga, and Chapter.

This is the main entry point for the library. It handles high-level actions like searching and discovering manga.

Initializes the client.

from weeb_central import Weeb weeb = Weeb()

Performs a comprehensive search for manga with advanced filtering.

Parameters:

• query: str: The title or keyword to search for.
• sort: Sort: How to sort the results. (e.g., Sort.BEST_MATCH).
• order: Order: Order.ASCENDING or Order.DESCENDING.
• official: OfficialTranslation: Filter by translation status.
• anime: AnimeAdaptation: Filter by anime adaptation status.
• adult: AdultContent: Filter by adult content.
• status: List[SeriesStatus]: A list of statuses to include (e.g., [SeriesStatus.ONGOING]).
• type: List[SeriesType]: A list of types to include (e.g., [SeriesType.MANHWA]).
• genre: List[Genre]: A list of genres to include (e.g., [Genre.ACTION, Genre.FANTASY]).

Returns: List[Manga]

Example:

from enums import Genre, SeriesStatus, Sort # Search for ongoing action/fantasy manga, sorted by popularity results = weeb.search( sort=Sort.POPULARITY, status=[SeriesStatus.ONGOING], genre=[Genre.ACTION, Genre.FANTASY] ) for manga in results: print(manga.title)

Retrieves a list of the most recently added manga series.

Returns: List[Manga]

Example:

# Get the second page of recently added manga new_manga_list = weeb.recently_added(page=2) for manga in new_manga_list: print(manga.title)

Retrieves the most recent chapter updates across all manga.

Returns: Dict[Manga, Chapter]

Example:

latest = weeb.latest_updates() for manga, chapter in latest.items(): print(f"'{manga.title}' was updated to Chapter {chapter.index}")

Retrieves a list of trending ("hot") series for a given period.

Parameters:

• sort: HotSeries: The time frame (HotSeries.WEEKLY, HotSeries.MONTHLY, HotSeries.ALL_TIME).

Returns: List[Manga]

Example:

from enums import HotSeries # Get the hottest series of the month hot_list = weeb.hot_series(sort=HotSeries.MONTHLY) for manga in hot_list: print(manga.title)

Gets the current "hot" chapter updates that are being read the most.

Returns: Dict[Manga, Chapter]

Example:

hot_updates = weeb.hot_updates() for manga, chapter in hot_updates.items(): print(f"Trending Update: '{manga.title}' - Chapter {chapter.index}")

This class represents a single manga series and is used to fetch its specific data and chapters.

You typically get a Manga object from a weeb.search() call or other Weeb methods.

Fetches and populates the manga's metadata attributes (.details, .description, .aliases, .related_series).

Example:

a_manga = weeb.search(query="one piece")[0] # Details are initially empty print(a_manga.description) #-> "" # Fetch details a_manga.get_details() # Now they are populated print(f"Title: {a_manga.title}") print(f"Author: {a_manga.details.get('Author')}") print(f"Description: {a_manga.description[:100]}...") # Print first 100 chars print(f"Aliases: {a_manga.aliases}")

Fetches a complete list of all Chapter objects for the manga, sorted chronologically.

Returns: List[Chapter]

Example:

all_chapters = a_manga.get_chapters() print(f"Total chapters: {len(all_chapters)}") print(f"Last chapter is: {all_chapters[-1].index}")

A utility to filter a list of chapters by number or season.

Parameters:

• chapters: List[Chapter]: The list of chapters to filter (usually from get_chapters()).
• start: float: The starting chapter number.
• end: float: The ending chapter number.
• season: int: The specific season to filter by.

Returns: List[Chapter]

Example:

# Get all chapters all_chapters = a_manga.get_chapters() # Filter for chapters 100 to 110 chapters_100_to_110 = a_manga.filter_chapters(all_chapters, start=100, end=110) # Filter for all chapters in Season 2 (Hypothetical splitted ranges if season not available) season_2_chapters = a_manga.filter_chapters(all_chapters, season=2)

Downloads a list of Chapter objects. It creates a directory named after the manga and saves each chapter inside.

Parameters:

• chapters: List[Chapter]: The list of chapters to download.

Example:

chapters_to_download = a_manga.filter_chapters(all_chapters, start=1, end=3) # This will create a folder like 'One-Piece' and save: # 1.pdf, 2.pdf, 3.pdf a_manga.download(chapters_to_download)

This class represents a single manga chapter.

Fetches a list of all Page objects for the chapter.

Returns: List[Page]

Example:

first_chapter = a_manga.get_chapters()[0] pages = first_chapter.get_pages() for page in pages: print(f"Page {page.index}: {page.url}")

Downloads the single chapter to a specified path.

Parameters:

• path: str: The directory where the file should be saved.
• download_type: DownloadType: The format (DownloadType.PDF or DownloadType.IMAGE).

Example:

import os from enums import DownloadType # Get the first chapter first_chapter = a_manga.get_chapters()[0] # Create a directory for our single chapter download output_dir = "single_chapter_download" os.makedirs(output_dir, exist_ok=True) # Download as a PDF first_chapter.download(path=output_dir, download_type=DownloadType.PDF) # Download as images # This will create a sub-folder inside `output_dir` named after the chapter index first_chapter.download(path=output_dir, download_type=DownloadType.IMAGE)

For all filtering and sorting operations, this library uses Enum classes for clarity and to prevent errors. You must import them from the enums.py file.

Available Enums:

• Sort: For sorting search results (BEST_MATCH, LATEST_UPDATE, POPULARITY, etc.).
• Order: For sort direction (ASCENDING, DESCENDING).
• OfficialTranslation: (ANY, YES, NO).
• AnimeAdaptation: (ANY, YES, NO).
• AdultContent: (ANY, YES, NO).
• SeriesStatus: (ONGOING, COMPLETED, HIATUS, CANCELED).
• SeriesType: (MANGA, MANHWA, MANHUA, OEL).
• Genre: A long list of all available genres (ACTION, ADVENTURE, FANTASY, etc.).
• HotSeries: (WEEKLY, MONTHLY, ALL_TIME).
• DownloadType: (PDF, IMAGE).

Import Example:

from enums import Sort, Order, Genre, SeriesStatus, DownloadType

The library raises custom exceptions for common issues. It's best practice to wrap your calls in a try...except block to handle them gracefully.

• NetworkError: Raised if there's a problem with the network connection, a timeout, or a server error (like HTTP 4xx or 5xx).
• ParsingError: Raised if the HTML structure of the site changes and the scraper cannot find the expected data. (open issues to let me know)

Example:

from weeb_central import NetworkError, ParsingError try: # Attempt to fetch something hot_manga = weeb.hot_series() for manga in hot_manga: manga.get_details() print(f"Fetched details for {manga.title}") except (NetworkError, ParsingError) as e: print(f"Could not complete the operation: {e}")