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
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)
| File | Size | Uploaded | |
|---|---|---|---|
| mangaplus-2.1.2.tar.gz | 64.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|