mangaplus 1.23.1

Python client for MangaPlus to access manga content and interact with the API.

MangaPlus

A Python client for MangaPlus by Shueisha, allowing developers to access manga content and interact with the official API programmatically.

Features

• Access all MangaPlus titles: serializing, completed, one-shots.
• Fetch manga chapters and downloadable images in multiple qualities.
• Manage favorites, comments, and subscriptions.
• Track reading history and title rankings.
• Log user interactions, including banner taps, popup taps, and downloads.
• Supports multiple languages and viewer modes (vertical/horizontal).
• Provides device registration and secure subscription handling.

Installation

You can install via pip:

pip install mangaplus

Or install the latest version from GitHub:

pip install git+https://github.com/hyugogirubato/mangaplus.git

Usage

from mangaplus import MangaPlus
from mangaplus.constants import Language, Viewer, Quality, Ranking, TitleType, PageType

if __name__ == "__main__":
    # Initialize the client
    client = MangaPlus(lang=Language.ENGLISH, viewer=Viewer.VERTICAL)

    # Register a new device
    device_id = "your_device_id_here"
    client.register(device_id=device_id)

    # Fetch updates titles
    updates_content = client.getUpdates()

    # Fetch all serializing titles
    titles = client.getAllTitlesV3(title_type=TitleType.SERIALIZING)

    # Get chapter images
    chapter_data = client.getMangaData(chapter_id=1014090, quality=Quality.SUPER_HIGH)

    # Add a title to favorites
    client.addFavorited(title_id=100191)

    # Post a comment
    client.postComment(chapter_id=1014090, body="Great chapter!")

API Methods

Some of the key methods provided by this client:

Method	Description
getAllTitlesV3()	Get titles by type (serializing, completed, one-shots)
getMangaData()	Retrieve chapter images with optional quality and split options
getTitleDetail()	Get detailed title information
getFavoriteTitles()	List all favorite titles
addFavorited() / deleteFavorite()	Add or remove titles from favorites
postComment() / banComment() / likeComment()	Manage comments and likes
register()	Register a device and obtain a secret key
setSubscription() / setSubscriptionRestore()	Manage subscription data
getRankingV2()	Get ranking lists (hottest, trending, completed)
getHistory()	Retrieve user reading history
logBannerTap() / logPopupTap()	Log interactions with banners and popups

And many more methods for publisher news, downloadable images, language preferences, and event logging.

Disclaimer

MangaPlus Python Client is an unofficial library and is not affiliated with or endorsed by Shueisha. The library is provided "as-is" without any warranty, and usage is at your own risk. Please comply with the MangaPlus service terms and conditions while using this library.

Contributors

Licensing

This project is licensed under the terms of GNU License. You can find a copy of the license in the LICENSE file in the root folder.

---

© hyugogirubato 2025