~ / mazze

cat mazze/README

Mazze

A comic reader for the library you already own.

Get Mazze on the App Store
platform   iOS 18.0+ · iPhone + iPad
formats    cbz · cbr · cb7 · cbt · pdf · comic epub
servers    komga · kavita · codex · ubooquity · opds 1.2
folders    nas · drive · dropbox · icloud
offline    yes
account    none
analytics  none
price      free · optional one-time Mazze Complete purchase

what you open the app to

The Reading tab: two comics in progress — Planet Comics #3 at page 24 of 68 and Planet Comics #5 at page 52 of 69, each with a progress bar and a resume button — beside an Up Next list offering the next issue in two other series.
Resume, and what's next
The Library tab as a grid of fifteen issues, with progress captions, on-device badges and completion ticks, and a resume bar along the bottom.
Every issue at once
A series screen listing its issues, each cover badged with its issue number.
One series

shelves that fill themselves

The Shelves screen listing five built-in shelves — Unread, In Progress, Recently Added, Downloaded, Completed — and two the reader wrote rules for: Golden Age Sci-Fi and Half Finished, each with its count.
Built-in and your own
Inside the Golden Age Sci-Fi shelf: five unread Planet Comics issues, selected by a rule rather than added by hand.
A rule, not a folder

in the reader

The reader with its controls shown: the issue title and page position, a thumbnail strip of every page in the book, and how long is left to read.
Scrub the whole issue

your library, online or off

The Offline tab, showing comics saved on the device grouped by series.
Ready offline
Settings showing local files, watched folders, and buttons to add a server or sync now.
Connect your own servers

on ipad

Mazze on iPad: In Progress and Up Next as two columns, with Recently Added and the shelves in two more below.
Both queues, side by side
Mazze on iPad: a grid of fifteen imported Golden Age issues across three series.
Your library on iPad
Planet Comics on iPad with the page controls and the thumbnail strip over a full-height page.
More room to read
The Shelves screen on iPad, with the built-in shelves and two custom ones.
Shelves on iPad

Screenshots show public domain Golden Age comics — Planet, Jungle and Fight Comics (Fiction House, 1940–1941) — scanned by the Digital Comic Museum community. Mazze ships with no comics of its own.

Mazze reads comics from a server you run yourself — Komga, Kavita, or any OPDS 1.2 catalogue — from a folder it watches on your NAS or cloud drive, 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. Optional iCloud sync uses Apple CloudKit, and in-app purchases use Apple StoreKit. Your servers and file providers handle the libraries you connect.

Features

Mazze Complete

Reading is free, and stays free — every format, every server, every watched folder, the Home Screen and Lock Screen widgets, iCloud sync and local backups. No limits and no trial. Mazze Complete is a one-time purchase that adds the parts which work while you are not looking:

One purchase, not a subscription. Every future version is included. The price is shown in the app before purchase.

An optional tip jar lets you support development through Apple in-app purchases. Tips unlock no features and are separate from Mazze Complete.

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, Codex, Ubooquity, Calibre-Web, and generic OPDS 1.2 catalogues. Where a server supports page streaming, Mazze reads without downloading the whole file first. Komga and Kavita also take your reading position back, so finishing an issue here marks it finished there.

Can Mazze read a folder on my NAS or Google Drive?

Yes. Pick the folder once in the Files app — including anything reached through Connect to Server, Google Drive, Dropbox, OneDrive or iCloud Drive — and Mazze imports new issues from it when you refresh. It never moves, renames or deletes anything in a folder you point it at.

What does Mazze Complete add?

Automatic downloads, Reading Insights and custom shelves. Every other part of the app — reading, all formats, every server, watched folders, downloads, the widgets, iCloud sync and backup — is free and has no trial.

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 it sync my comic files?

No. Optional iCloud sync carries reading data and settings. Connect the same library or import the same files on each device separately. Enable sync in Settings → Backup & Sync. Turning it off stops syncing on that device and does not delete existing iCloud data.

Which EPUB files work?

Fixed-layout comic EPUBs. Reflowable prose ebooks are not supported.

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

No analytics or tracking. Read how local storage, optional iCloud sync, connected servers and purchases work on the privacy policy page.