Tsumiru

Appearance

Getting started ​

Tsumiru is a client for Suwayomi (also known as Tachidesk). Your sources, extensions, server downloads, and library live on your Suwayomi server. Tsumiru connects Android, desktop, iOS, and web clients to it.

1. Set up a Suwayomi server ​

If you don't already have one, you'll need a running Suwayomi-Server. It's free and open-source, and runs on Windows, macOS, Linux, Docker, or a NAS/home server.

You install and update extensions from Tsumiru itself: Browse → Extensions puts them on the server, and every connected client can then use them. See Browse: sources & extensions.

2. Download Tsumiru ​

Visit the download page and grab the build for your platform:

  • Android: install the .apk (use the universal APK if unsure).
  • Windows / macOS / Linux: download and extract the desktop build.
  • Web: host the web build, or open it from wherever you've deployed it.

3. Connect to your server ​

The first time you open Tsumiru, a short setup wizard walks you through it:

  1. Pick a theme. You can change it later, and pick from more themes, under Settings → Appearance.
  2. On Connect your server, enter your server address or use one of the connection helpers:
    • Search my network scans your local network and fills in a Suwayomi server automatically. On the same Wi-Fi this is the easiest path.
    • Test connection checks an address you type. You can enter just the host (192.168.1.10 or suwayomi.mydomain.com); Tsumiru tries the likely scheme and Suwayomi's default port, 4567. Include a custom port when needed, such as 192.168.1.10:4568. The result says whether Tsumiru connected, needs a login, could not reach the address, or reached something other than Suwayomi.
  3. If a gateway or reverse proxy requires extra headers, add them under Custom HTTP headers before testing the connection. Use Add header, then enter the Header name and Header value. See Reaching your server from anywhere if you want to read away from home.
  4. If your server needs a sign-in, Test connection reveals the login form. Enter your username and password. Tsumiru can select Basic, Simple, or UI login automatically, or you can choose the configured mode, then tap Sign in.
  5. Finish, and your library loads.

If you're in a hurry, Skip (top-right) lets you set things up later. You can change the address, sign-in, and headers any time under More → Connection.

Tip: A local-network address (192.168.x.x, default port 4567) is the simplest place to start. To read away from home too, put your server behind a reverse proxy with HTTPS and enter that domain as the Server URL, then add your LAN address as the Internal / LAN URL. Tsumiru uses whichever one can reach the server, so the same app works at home and away.

4. Browse sources and build your library ​

Because sources live on the server, anything you've enabled in Suwayomi shows up in Tsumiru automatically.

  1. Open the Browse tab to see the sources available on your server.
  2. Pick a source and use its Popular / Latest listings, or search for a title.
  3. Open a series and tap Add to Library. It appears on devices connected to your server.

Pin the sources you use most to keep them at the top of the Browse list. When you search across sources, you can filter that global search down to the sources you care about.

Trouble finding a specific series? ​

  • Check your spelling, and try the romanized title; some sources index by it.

    Example: Boku no Hero Academia instead of My Hero Academia.

  • Some sources use slightly different spellings.

    Example: 3-gatsu no Lion instead of Sangatsu no Lion.

5. Read ​

Open any series, tap a chapter, and you're reading. Tsumiru's continuous reader is built for long webtoon strips: vertical scrolling with pinch-to-zoom. See Reader settings to tailor it to how you read.