1.2.0

Sep 7, 2026

A manga and webtoon reader for your Suwayomi server.

✨ New Features

Added Custom HTTP headers for servers behind an authentication gateway, Zero Trust guard, or reverse proxy (@Yukaii)
Added an optional Internal / LAN URL alongside your Server URL, with an Active connection row showing whether you are Using LAN or Using remote (@SuperMario22922)
Tapping a series in On device now opens Downloaded chapters, with Retry and Remove from device on each row (@ariqpradipa)
Stalled downloads now show a banner saying why, with a Retry button (@aaronbamblett)
Added Chapter grouping to the Updates filters, with Collapsed and Expanded modes (@yohanim)
Added Download files in the background, so background checks can fetch chapters instead of only queueing them (@yohanim)
Added Keep recently-read chapters downloaded, which re-downloads keep-window chapters if they go missing (@yohanim)
Extensions can now be repaired with Reinstall (@aaronbamblett)

⚙️ Changes

The Server downloads tab is now the same list as On device, with a Queue header and a page count on the active download (@aaronbamblett)
The server queue now reorders by long press or the drag handle, and each row has Retry, Cancel, Move to top and Move to bottom (@aaronbamblett)
Continuous horizontal reading modes now scroll continuously instead of a page at a time (@yohanim)

🚀 Improvements

Queued downloads that Android refuses to start now stay visible and recoverable instead of disappearing (@aaronbamblett)
Background downloads can now resume on their own without you reopening the app (@aaronbamblett)
Pause and Wi-Fi only preferences are kept when downloads recover (@aaronbamblett)
Switching server or account no longer lets downloads carry on with old credentials (@aaronbamblett)
Chapters your server cannot produce are now given up on after a few attempts instead of asked for forever (@yohanim)
Background downloads no longer hang on a dead connection (@yohanim)
Background warnings and errors now reach the in-app debug log (@yohanim)
Applying a Keep offline rule to several series now shows one continuous progress count (@yohanim)
Chapters found by a library update now finish downloading without opening the series (@yohanim)
When a chapter in your Keep offline rule cannot be downloaded, the next unread chapter takes its place (@yohanim)
Library search stays responsive on large libraries (@yohanim)
Long strips with page cropping on now scroll more smoothly and use less memory (@yohanim)
The On device list no longer stutters while a download is running (@yohanim)
The library's On device badge and filter now update as downloads finish (@yohanim)
Offline download indicators now appear before the server connection is established (@ariqpradipa)
Extension errors now show a readable message instead of a wall of code (@aaronbamblett)
The login and Basic Auth dialogs now submit when you press Enter (@aaronbamblett)

🧩 Fixes

Fixed logins on macOS not surviving a restart (@aaronbamblett)
Fixed Simple Login rejecting valid credentials on Android, iOS and desktop (@aaronbamblett)
Fixed Browse source filters resetting each time you reopened them (@aaronbamblett)
Fixed Reset in the source filters leaving the old results on screen (@aaronbamblett)
Fixed pinch zoom drifting away from the point between your fingers (@yohanim)
Fixed zooming near the top or bottom of a page pushing it out of view (@yohanim)
Fixed the webtoon reader jumping to the previous chapter on a small scroll near the top (@yohanim)
Fixed the webtoon reader loading the next chapter too early on long chapters (@yohanim)
Fixed returning to the previous chapter landing at the top of a tall page (@yohanim)
Fixed date headers on Updates repeating as you scrolled (@yohanim)
Fixed chapters read on another device ignoring your delete-while-reading settings (@yohanim)
Fixed a chapter with no pages spinning as downloading forever (@yohanim)
Fixed the download notification flashing in a loop for a chapter that fails immediately (@yohanim)
Fixed the tracker using the wrong setting for chapters you marked read while offline (@yohanim)
Fixed switching servers leaving the app retrying a sign-in against the old one (@yohanim)
Fixed a crash when marking several chapters read at once (@yohanim)
Fixed crashes when deleting a chapter from the server after leaving the screen (@yohanim)
Fixed a crash loop in the library category tabs (@yohanim)
Fixed installing an extension from an empty file appearing to succeed on web (@yohanim)
Fixed the app asking your server for the same chapters twice while catching up on new ones (@aaronbamblett)
Fixed Download to server queueing chapters your server already had (@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.

Which sideloading tool should I use?

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.

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.