~ / mazze

cat mazze/README

Mazze

A comic reader for the library you already own.

platform   iOS 18.0+ · iPhone + iPad
formats    cbz · cbr · cb7 · pdf
servers    komga · kavita · opds 1.2
offline    yes
account    none
analytics  none
price      free
The Reading tab: a Continue Reading card part-way through an issue,
                      an Up Next suggestion, and a Recently Added row.
Resume, and what's next
The Library tab grouped by series, each shown as a stack of covers
                      with its issue count.
Grouped by series
The Library tab as a grid of every issue, with progress bars,
                      completion ticks and on-device badges.
Or every issue at once
The reader with its controls shown: title, page count, a thumbnail
                      strip of every page, and time remaining.
Scrub the whole issue
Settings showing a connected Komga server, local files, and an
                      Add Server button.
Connect your own servers

Screenshots and clip show Pepper&Carrot by David Revoy (Creative Commons Attribution) and public domain Golden Age comics (Fiction House, 1940–1952) scanned by the Digital Comic Museum community.

Mazze reads comics from a server you run yourself — Komga, Kavita, or any OPDS 1.2 catalogue — and from files you import through the Files app. It is a native iOS app for iPhone and iPad.

There is no Mazze account, no analytics, no advertising and no Mazze backend. The app talks to the servers you add and to nothing else.

Features

Support

Email is the fastest route. Please include:

ios version    Settings → General → About
mazze version  Settings → Version
server kind    komga | kavita | opds | local files only

email

mazze@cwilson.app

Replies usually take a day or two.

FAQ

Do I need a server?

No. Import comics straight from the Files app and read them entirely on device. A server is for keeping a large library in one place and reading it from anywhere.

Which servers work?

Komga, Kavita, and generic OPDS 1.2 catalogues. Where a server supports page streaming, Mazze reads without downloading the whole file first.

Why can Mazze not see my server?

It depends on where the server is.

On your own network: the device is on a different network (mobile data rather than Wi-Fi is the usual one), iOS has not granted local network access (Settings → Mazze → Local Network), or the address is missing its port.

Over the internet: the phone is online but has no route to the server — if you reach it through a private network, that connection has to be up too. Or the address is plain http://, which iOS permits only for local and private addresses; a public one has to be https://. Or the server sits behind a reverse proxy on a path (https://host/komga) and the path was left off.

Mazze tells the two apart — your connection being down versus that server being unreachable — because they have different fixes. Being told your NAS is broken while you are sitting on a train sends you to look at the wrong thing.

Does Mazze come with any comics?

No. Mazze is a reader. It displays files you already have, from your own library or your own server. It does not host, sell, index or help you find comics.

Privacy

Mazze collects nothing. The full statement is on the privacy policy page.