Skip to main content

MangaPlus

License PyPI version
Python Version

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, TitleType

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=1000486, quality=Quality.SUPER_HIGH)

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

    # Post a comment
    client.postCommentRx(chapter_id=1000486, 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
getHome() Fetch home screen data
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

hyugogirubato gregoryn22

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 2026

Metadata

Release files for mangaplus 2.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mangaplus 2.1.2
File Size Uploaded
mangaplus-2.1.2.tar.gz 64.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mangaplus 2.1.2
File Interpreter ABI Platform
mangaplus-2.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 130.2 kB

Release files / mangaplus-2.1.2.tar.gz

Download URL mangaplus-2.1.2.tar.gz
Size 64.6 kB
Tags Source
SHA-256 checksum
How to use checksums
0bc541f18a6ae270a8665441b91f98c4ef0b2bdac508d5aeddff6840d543b46c
BLAKE2b-256 checksum
How to use checksums
cf0de4afdd7dae672c30160f994649060e21ebc983d930a4bd1c7fb98eb81a5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.5 CPython/3.8.10 Windows/10

Release files / mangaplus-2.1.2-py3-none-any.whl

Download URL mangaplus-2.1.2-py3-none-any.whl
Size 65.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c32bf136f086f9c184ba9b6901ee1b03b7edd58ec7c5f13e90011b540a9ccb01
BLAKE2b-256 checksum
How to use checksums
3cdb2ae45b8bf07ad5aa7a06951dc1197592c6d4899737d225725481fed732d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.5 CPython/3.8.10 Windows/10

Release history Release notifications | RSS feed

This release

2.1.2 This release

2 release files

1.23.2

2 release files

1.23.1

2 release files

1.9.19

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page