Tsumiru

A manga and webtoon reader for your Suwayomi server.

🚀 Improvements

• Added visible progress while checking the server connection, searching the network and signing in during setup (@aaronbamblett)
• Collapsed Custom HTTP headers into an expandable row during setup, showing the number configured (@aaronbamblett)
• Removed unused packages and updated dependencies (@yohanim)

🧩 Fixes

• Fixed large libraries failing to load beyond the first page (@SuperMario22922)
• Fixed setup losing the entered server address and connection result (@aaronbamblett)
• Fixed Next doing nothing instead of checking the connection or signing in during setup (@aaronbamblett)
• Fixed the login form disappearing during sign-in (@aaronbamblett)

Install

You'll need a running Suwayomi server. See Getting started.

Mobile

Android: download the universal APK below and open it to install. Smaller APKs for specific chip types are also attached.

iOS: the …-ios.ipa below is unsigned and has to be sideloaded. Add https://tsumiru.app/apps.json as a source in SideStore or AltStore to install it and get later releases as updates.

<details>
<summary>Which sideloading tool should I use?</summary>

• SideStore signs and refreshes the app on the device itself, with no computer needed after setup. Best for most people.
• AltStore expires every 7 days and only refreshes while a computer running AltServer is switched on and on the same Wi-Fi as your phone.
• TrollStore installs permanently with no expiry, but only works on older iPhones and iOS versions with the required vulnerability.

With SideStore or AltStore the app is re-signed periodically, which those tools automate. There is no App Store build.
</details>

Desktop

Windows: download …-windows-x64.zip, extract it anywhere, and run tsumiru.exe.

macOS: download …-macos-x64.zip, extract it, and move the app to Applications. If macOS blocks the first launch, approve it under System Settings → Privacy & Security.

Linux: the Flatpak is recommended and auto-updates.

flatpak remote-add --if-not-exists tsumiru https://suwayomi.github.io/Suwayomi-Tsumiru/index.flatpakrepo
flatpak install tsumiru io.github.aaronbamblett.tsumiru

For a portable option, download …-linux-x86_64.AppImage, mark it executable with chmod +x, and run it.

Web

Download …-web.zip and serve its contents with any static web server.

Full documentation

Tsumiru is a native client for reading manga & manhwa from a Suwayomi-Server instance, built for long webtoon binges. Offline downloads with an on-device catalog, a rebuilt continuous-scroll webtoon reader, incognito mode, and 13 built-in themes.