Rensaiō - Series Manager Powered by Mihon Extensions

Key Features

Everything you need to manage your manga & comic library automatically.

🧙‍♂️

Startup Wizard

Automatically imports your existing library on first run — no tedious setup.

🔁

Temporary vs Permanent Sources

Chapters are only downloaded from temporary sources when no permanent source is available. Auto-deleted when a permanent source provides them.

🔎

Multi-Search & Multi-Linking

Search and link one series to multiple sources / providers simultaneously.

📥

Automatic Downloads

Everything is automatic — retries, reschedules, with a dedicated download page.

🔄

Auto-Updates

Extensions are kept up to date automatically so you never miss a release.

👥

Multi-User System

Create separate accounts with different permission levels
Invite people and control who has access to what
Optionally enable authentication to restrict access to authorized users only

🩺

Status & Health Dashboard

A dedicated page that shows which series and providers need attention
Color-coded alerts (green / yellow / red) help you spot issues at a glance
See broken providers, stale series with no new chapters, and more

📡

OPDS Server

Read your library from any OPDS-compatible reader app
Browse by all series, what's new, what you're currently reading, categories, and tags
Reading progress syncs back automatically
Each user gets their own unique random OPDS path (e.g. door-pebble) for private access

🤖

MCP Server (AI Integration)

Expose your library to AI tools through the Model Context Protocol
Let LLMs search your series, check status, and more — all respecting user permissions
Just add /mcp to your OPDS path: https://rensaio.example.com/door-pebble/mcp

📖

Read State Tracking

Remembers where you left off reading each chapter, across all your devices
Backed in your series, not the database

🔗

External Scrobbler Sync

Sync your reading progress with external trackers
Supported providers: AniList, MyAnimeList, Kitsu, MangaDex
Each user controls their own connections and sync settings

🧹

Filename Normalization

Rebuild your library easily with consistent naming, that will help you reimport it back when needed.

🧾

ComicInfo.xml Injection

Chapters include rich metadata from the original source.

🖼️

Extras

Stores cover.jpg per series
Stores rensaio.json for full metadata mapping, and read-state stored with your series
External Domain Support for reverse proxy scenarios
Support for jxl, jp2, avif image formats, with real-time transcoding for clients not supporting them

Under the Hood

Rensaiō is composed of these core components working together.

🎨

Frontend

A beautiful Next.js UI forked from Kaizoku Next by OAE.

⚙️

Backend

A custom .NET engine managing schedules, downloads, metadata, OPDS / MCP servers, and scrobbler sync.

🔌

Mihon Bridge

Enables the use of Mihon Android extensions on .NET through IKVM and the Java Android compatibility layer.

Docker Quick Start

Available for both amd64 and arm64. Get up and running in minutes.

9833

Port (UI)

/config

Config Volume

/series

Series Volume

022

UMASK

One-Liner

docker run -d \ # detached

  --name Rensaio \

  --network host \

  -p 9833:9833 \

  -e UID=99 \

  -e PGID=100 \

  -e UMASK=022 \

  -v /path/to/config:/config \

  -v /path/to/series:/series \

  maxpiva/rensaio:latest

Docker Compose

# docker-compose.yml

services:

  rensaio:

    container_name: rensaio

    image: 'maxpiva/rensaio:latest'

    volumes:

      - /path/to/series:/series

      - /path/to/config:/config

    environment:

      - UMASK=022

      - PGID=100

      - UID=99

    ports:

      - '9833:9833'

Variable	Value	Description
`UID`	99	Host user ID
`PGID`	100	Host group ID
`UMASK`	022	File permission mask (default)

Variable

Value

Description

UID

Host user ID

PGID

100

Host group ID

UMASK

022

File permission mask (default)

Unraid Template

Ready-to-use XML template for Unraid users.

<Container>
  <Name>Rensaiō</Name>
  <Repository>maxpiva/rensaio:latest</Repository>
  <Registry>https://hub.docker.com/r/maxpiva/rensaio</Registry>
  <Network>host</Network>
  <MyID>rensaio</MyID>
  <Shell>sh</Shell>
  <Privileged>false</Privileged>
  <Support>https://github.com/maxpiva/rensaio/issues</Support>
  <Project>https://github.com/maxpiva/rensaio</Project>
  <Overview>Rensaiō – a feature-complete series manager powered by Mihon extensions. </Overview>
  <Category>MediaManager:Comics</Category>

  <Config Name="Config Folder" Target="/config" Default="/mnt/user/appdata/rensaio" Mode="rw" Description="Path to store configuration, database, and settings." Type="Path" />
  <Config Name="Series Folder" Target="/series" Default="/mnt/user/media/series" Mode="rw" Description="Path where series and chapters will be downloaded." Type="Path" />

  <Config Name="UID" Target="UID" Default="99" Mode="rw" Description="User ID to run the container as." Type="Variable" />
  <Config Name="PGID" Target="PGID" Default="100" Mode="rw" Description="Group ID to run the container as." Type="Variable" />
  <Config Name="UMASK" Target="UMASK" Default="022" Mode="rw" Description="UMASK for file permissions." Type="Variable" />

  <WebUI>http://[IP]:9833</WebUI>

  <TemplateURL>https://raw.githubusercontent.com/maxpiva/rensaio/main/unraid/rensaio.xml</TemplateURL>
  <Icon>https://raw.githubusercontent.com/maxpiva/rensaio/refs/heads/main/RensaioFrontend/public/rensaio.png</Icon>
</Container>

Contributing

🎨 Frontend Devs — You're Needed 🙏

Help clean up the mess left behind by our overenthusiastic friends, Copilot, Claude and ~~Fable~~ (banned).

⚙️ Backend Devs — PRs Welcome

PRs are welcome to improve stability and architecture.

Your Series, Automated