Features¶
Everything MangaPixer does today, by area. The README has the short version; the links lead to the guides with the details.
Library and browsing¶
- Browse the folder hierarchy in a card view (with a card-size slider) or a list view.
- Sort by name (ascending or descending), recently added, recently read, or recently updated. Recently updated ranks a folder by its newest archive, like a new chapter.
- Filter by read state (reading / read / unread) at any folder level. The filter also applies to series folders through their contents, and you can hide empty folders.
- New in 1.44.0: in a folder that holds linked series, filter them by Completion - Have it all, Finished, missing some, Everything so far, Missing some or Can't tell, each with its count (see Library layout).
- A jump rail in every folder and both name orders - letters with multilingual collation, or round number ranges for numbered chapters and volumes (new in 1.41.0) - infinite scroll in both directions after a jump, and read/reading rollup badges on folders. This means you can tell at a glance whether a folder contains only comics you've read, some you haven't read yet, or nothing you've started at all.
- New in 1.49.0: the jump rail stays under every filter (it covers the entries the filter keeps), doujin-style folders get chips by the letter inside their leading tag (
[A...[Z), folders and files each get their own letters, the date sorts get Today / This week / This month / This year / year chips, small folders show no rail, and on phones a long list gets a scrub strip on the right edge. - New in 1.50.0: after a time chip under Recently added or Recently updated the list scrolls up too. The Favorites page has the library view's controls: card or list, the card-size and list-columns sliders, five sorts (Recently favorited, Name A-Z / Z-A, Recently added, Recently updated) and filters for read state, folders or archives and one library - kept per device, separate from the library view (see The Favorites page).
- New in 1.51.0: the Favorites page sorts by Recently read, has a jump rail under the name sort (scrolling up after a jump too), and can Group your favorites by library with a header per library - kept per device (see The Favorites page).
- Multi-select, including shift/ctrl ranges and touch long-press, to mark items read or unread in bulk.
- New in 1.45.0: search results show read marks, filter by Reading / Read / Unread, and Load more; the search, tags and filter are part of the page address.
- Full-text search over titles and folder names (trigram search), with cover thumbnails and a folder-vs-archive badge. Series linked to MangaUpdates are also found by their alternative titles: a
Dungeon Meshifolder turns up when you search forDelicious in Dungeon. - New in 1.49.0: search by words - in any order, ignoring accents and punctuation, quotes for an exact phrase; close matches for a typo; one or two letters match the start of a word. Names come first: an archive found only through its folder is counted on the folder's card (+41 inside), the best matches are listed first, the count says N folders, M archives, and starred results move to the top of the whole list.
- New in 1.49.0: quick results while you type - a search box in the top bar on desktop and tablet (and a list under the field on the phone Search page) shows the best few series, folders, archives, creators and tags as you pause; a typed field such as
creator:uraortag:suggests its values. - New in 1.50.0: the words you type may be split between a file's name and its folders (
berserk 12findsBerserk/Vol 12.cbz, for files named without the series title),-wordleaves names out,6also finds006, and an archive found outside its folder shows the folder it belongs to on a second line - in search, quick results, Continue reading and Favorites. Series matches find a title with a typo or from one or two letters; quick results open on the desktop Search page too. - New in 1.51.0: a short number also finds a volume or chapter written against its prefix (
12findsv12,vol012,ch12), a search of only-wordsasks for a word to search for, and the folder line under an archive skips shelf folders such as Ongoing or Completed.
Reader¶
- Four modes: paged left-to-right, paged right-to-left (manga), double-page spreads, and vertical webtoon scrolling. Admins set a default mode per library and per folder, and each user can override it per item or set a personal default. New in 1.41.0: Reading mode suggestions (Administration) lists folders whose pages are long webtoon strips or whose ComicInfo says right-to-left, for a one-click folder default - never applied on its own, nothing looked up on the web.
- Double-page mode adapts: it shows a single page in narrow portrait, keeps wide spreads whole, and shows both page numbers. When extra pages split a spread across the wrong pair, you can shift the pairing anywhere in an archive, and it is saved for everyone who reads it.
- Image quality: pages are sent at the size your screen shows them (or full size, your choice), downscaled on the server with a choice of filter to keep screentones clean. Pages shown larger than their resolution can be redrawn on your device's graphics chip: Crisp (AMD FSR 1, light; the default) or Enhance (the Anime4K line-art upscaler, Efficient or Max quality), in paged and vertical mode. Enhance uses WebGPU over HTTPS and WebGL2 elsewhere, so both also work over plain
http://on your LAN, and the reader always shows which engine is running. - Touch and keyboard navigation: direction-aware swipe zones, arrow keys, a draggable page scrubber, a help overlay (
?), and immersive fullscreen (new in 1.41.0: double tap or double click the center to enter or leave it). The toolbar groups its options into Display and Quality menus (new in 1.41.0). - Webtoon tap zones and swipe move by a configurable step (90% of the screen by default). Turn them off for free scrolling only. New in 1.41.0: the left and right edges step too, and you choose which edge goes forward (the swipe follows). New in 1.48.0: the two edges are much bigger - they run the full height of the screen - and the back and forward strips shrink to the top and bottom of the middle; the reading help shows the new layout.
- Configurable page-turn animation (Slide / Reveal / None).
- Auto-advance to the next or previous archive, plus page prefetch around the current position.
Series information¶
- Reads the
ComicInfo.xmlinside your archives (series, number, summary, credits, genres, publisher). Nothing leaves your server for this. - A card with series information shows an (i): it opens a side panel with the summary, and a full series page lists the items. New in 1.41.0: the reader's Series info button opens it while you read, and a linked series lists its MangaDex title under Sources.
- Admins can link a folder or archive to a MangaUpdates series with Identify (search, or paste a MangaUpdates address). Optional and off by default; see What leaves your server.
- New in 1.42.0: a series MangaUpdates does not list yet can be linked to its MangaDex title instead - MangaDex is a third site in Identify, and with Automatic matching a folder MangaUpdates finds nothing close for is searched on MangaDex too, always waiting for an admin under Needs review. Switch to MangaUpdates moves the link once MangaUpdates lists the series (see Series only on MangaDex).
- Automatic matching (a separate switch with its own consent, also off by default) matches new folders in the background. It tells series, one-shots, artist folders and collections apart by their names and contents, so category folders are never linked themselves. Confident matches go live at once; close calls wait for an admin on the Metadata Manager page (account menu), where each can be accepted, identified by hand or marked Don't match. Linked series are refreshed in the background.
- In Needs review, Later sets a hard case aside (kept on the server, for every admin) so the easy matches can be accepted first. A row also says when other waiting works are by the same circle or artist (read from names like
[Circle (Artist)] Title, also without the opening bracket) or sit in the same folder; one tap lists them together for a bulk action, and Authors lists the largest groups first. - Several selected items can be identified one by one (the Identify dialog steps through them), and Re-run matching works on a selection from the library view.
- Webtoons, manhwa and manhua without a real volume list show their chapters in order instead of guessed volumes, and are counted in chapters (new in 1.34.0).
- New in 1.42.0: more file names are read: a number right after the series title that changes from file to file is the chapter (
Series 002 Title,Series 100 Vol 11 Title), a site's watermark at the end of a name (Read Online) is ignored, andCh.014.005is chapter 14.5 (see Volumes). - In a folder of stories, such as an artist's one-shots, the stories linked to the same collected volume (tankoubon) show as one stacked card in the Volumes view (new in 1.37.0; see Stories collected in one volume).
- New in 1.44.0: Find the chapters inside volume files - when no volume list says which chapters a volume file holds, MangaPixer reads the pages of the volume file and of the chapter files next to it in the background and compares them; the chapter files it finds join the volume ("Chapters 51-58 are inside the volume file") and count as its duplicates. On by default in Administration > Volume contents; files are only read and nothing leaves the server (see Volumes).
- New in 1.45.0: the Info panel shows a folder's tags - creators (with their role), series, magazine, publisher, year started, genres, type and "Fan works of" - each counting the works you can open; select a tag to see every work that carries it in Search, or type
creator:"...",genre:,publisher:,magazine:,year:,type:. Creators are joined across spellings (admins can rename, merge and split them), and the tag index is built in the background. New in 1.47.0: a library's top level has Info too (the tags of the whole library), +N more shows the rest of a row of tags in place, and in a tag search the Reading / Read / Unread chips filter the works (a work is Read when every archive of it you can open is read - all its folders, for a series kept in several; Incognito leaves your Private libraries out). - New in 1.49.0: a Tags row from the MangaUpdates categories and ComicInfo
Tags; tags that combine - Not, or, an Info chip adds to the current search, and a Refine list with counts; and the full typed syntax (tag:,series:,-,|, quotes,year:2010..2015,is:read,library:) with a ? list of examples (see Series information). - New in 1.45.0: an artist folder can be tied to its MangaUpdates author with Find on MangaUpdates (admins, on demand), and new chapters are noticed sooner: with Automatic matching on, MangaDex and MangaUpdates are checked every few hours and series you are reading every 2 days.
- New in 1.51.0: automatic matching also knows an author by the other names stored under Artists' other names, so an archive tagged with a pen name links to that author's series instead of waiting in Needs review.
- Readers can report a wrong series with Wrong series?; admins see the reports on the same page.
- Per folder, admins choose whether web data or
ComicInfo.xmlwins, whether it holds doujinshi (Content), and can mark a folder Don't match when it is not one series, or (new in 1.34.0) Collection about a series when it holds works about it, such as fan-made doujinshi: the folder shows the series, and each work inside is matched on its own. New in 1.37.0: Artist folder marks a folder of one artist's works - it is never linked to a series, its stories are matched one by one, and records by that artist count in their favour (see Artist folders). New in 1.38.0: Match folders by name marks many selected folders at once as artist folders or collections, by their names against the artists and series titles stored on your server - the comparison sends nothing; marking a collection may download its series' cover, and Search the web for the rest is opt-in - and Artists' other names reads the MangaUpdates author pages of your linked series' creators when you ask, so a folder named with a pen name matches too (see Match folders by name). New in 1.39.0: a folder can declare its own edition (Volumes in this edition, Omnibus / Master / Deluxe), so its Completion counts that edition's volumes instead of the regular edition's list, and Track completion off keeps a series linked with no Completion or missing answers (see This folder's edition). Renamed or moved folders keep these settings. Show series information hides it all for everyone.
Per-user reading state¶
- Each user has their own progress, read marks and "Continue reading" row. You can dismiss items from the row, and finished ones hide automatically.
- A "Start reading" / continue shortcut on each folder that opens the next unread item.
- Optional "always open read items from the start" preference.
- New in 1.40.0: Themes - each user picks Dark (the default), Light, Black (true black for OLED), Sepia or System (follows the device), and an accent colour, in Settings > Appearance; the choice follows the user to every device (see Appearance).
- New in 1.40.0: a volume file that replaces its chapter files keeps their read state (see Rescans, moves and deletions).
- New in 1.43.0: Tracker sync - send your reading progress to your own MyAnimeList or MangaUpdates list while you read, once an admin allows it (Tracker sync; admins: Tracker setup).
- New in 1.44.0: split chapters (33.1 + 33.2) count toward your trackers; the series' Tracking button says why a folder is not synced and can turn sync on; and when a tracker's own chapters finish more volumes than it lists, MangaPixer offers Set tracker's volumes to N (only on your click; see Tracker sync).
- New in 1.52.0: Ratings - give a series or an archive your own rating from half a star to five stars (others see it only inside a server average, once an admin turns on Shared ratings - 1.53.0): in the Info sheet, on the series page or with Rate in the reader. Rated cards show your rating; sort by My rating in the library and on Favorites, filter Favorites by Rated, and search
rating:4for what you rated four stars or more (Ratings). - New in 1.53.0: Shared ratings - once an admin turns them on in Administration, the Info sheet and the series page show a Server line with the average of everyone's ratings and how many rated - never who rated what; Private libraries never count, and each user can stop sharing in Settings > Ratings and recommendations. Sort a library by Server rating (Ratings).
- New in 1.53.0: Recommended for you on Home and More like this on the series page - series on your server that share authors, tags, genres, magazines or a sequel / spin-off with what you rated well, starred or finished, each with a one-line reason; worked out on your server (Recommendations).
- New in 1.53.0: Your score on MyAnimeList and MangaUpdates - keep your score there in step with your rating here (per tracker, off by default), or take your scores from there for the series you have not rated (Tracker sync).
- New in 1.53.0: What's new - after an update, admins see what changed since the version they last saw (account menu > What's new opens it again).
Home¶
- "Continue reading": one row across all your libraries.
- "New chapters": recently added archives, grouped by library and stacked per series folder (latest chapter plus a "+N" badge): the folder with its own series link, or else the folder that holds the new archives, so a library whose top level is categories such as Manga and Manhwa shows one card per series, not per category. Each user chooses the time window in days (30 by default), how many stacks each library shows (6, 12, 24 or 50; 12 by default - new in 1.41.0) and which libraries contribute.
- Continue reading, New chapters and Favorites cards carry the same controls as the library view: the favorites star and, where there is series information, the (i) and the summary on hover. New in 1.48.0: the Favorites row and the Favorites page also show Read / Reading badges (a folder's or a stack's covers the whole folder), and a folder can be starred from inside it.
- A New chapters card of a linked series, and a Continue reading card of one of its chapters, show the series cover (for example your volume 1's cover) rather than a chapter's first page - see Covers. New in 1.39.0: Choose cover… on a folder linked to a series also offers the series poster (see The series poster).
- Tapping a New chapters card of a linked series opens it in the Volumes view (by name, the Continue row on top); other folders open sorted by Recently updated.
- A grid of your libraries.
Multi-user, privacy and access¶
- No default credentials. A fresh instance shows a first-run setup screen, and the first admin account is created there (see First-run setup).
- Admin and reader roles, with per-user library access grants.
- Onboard users with a password, or with a single-use activation link that expires after 48 hours so the user sets their own password.
- Private libraries and Incognito: each user can mark libraries as private. While Incognito is on (the default for every new browser session), private libraries are hidden from browse, home and search.
- Login rate limiting, CSRF protection on authenticated state-changing requests, forced password change, per-user session revocation, and last-admin protection.
Administration and operations¶
- Add, rename and remove libraries from the web UI, using a folder picker confined to the media root. Removing a library deletes only MangaPixer's own metadata and thumbnails; your files are untouched.
- Scans run per library or across all libraries, and can be canceled. Each library is also rescanned automatically on its own schedule (daily by default; hourly, every 6 hours, weekly or off), set in Scheduled jobs. There is no filesystem watching yet; an app with an API token allowed to request scans can start one after it adds files (new in 1.36.0).
- Persistent thumbnails that survive restarts and cache clears. A background backfill fills them in and yields to active readers. Thumbnails can be regenerated per library.
- Automatic rotating database backups (daily, 7 kept by default) and on-demand backups. A validated backup can be uploaded for restore; it is applied atomically on the next restart, with rollback if that fails (see Backup and restore).
- New in 1.49.0: rotating backups are gzip-compressed (
.db.gz, about a quarter of the plain size on a real library), each checked before it is kept; restore accepts.dband.db.gz. - New in 1.50.0: a Compress new backups switch in the Backup settings (on by default; a server configuration value still wins).
- Runtime log-level control (global and per subsystem) and a diagnostics export.
- New in 1.42.0: a Performance card sets the number of media workers, the page cache size and what background work may do while someone reads (Pause, Slow - the default - or Normal); pages someone is reading are always served first, and the reader loads at most two pages ahead at a time (see Configuration).
- YACReader progress import: if a library folder contains a YACReader library database, an admin can preview its read progress and import it into their own account. The YACReader data is only read.
- API tokens and a metadata export for other apps: an admin creates a read-only token for a tool such as MangaList, which can then read each linked series' information (links, volume lists, completion, and from 1.38.0 duplicate files with their ids so they can be opened in the reader; from 1.39.0 a folder's declared edition and whether its completion is tracked; from 1.42.0 MangaDex's released chapters in your preferred language and the Volumes view's estimated volumes) from
/api/v1/export/- names only, never a path. A token works nowhere else and is stored only as a fingerprint; revoked and expired tokens can be cleared from the list (new in 1.37.0) (see API tokens and Metadata export API). - Health endpoints (
/health,/health/ready) and an OpenAPI document at/openapi/v1.json(the checked-in contract iscontracts/openapi.jsonin the repository). - Web app manifest and icons, so MangaPixer can be added to a phone or tablet home screen.
- New in 1.51.0: on a touch screen every control is at least 40 px to tap and every icon button has a name for screen readers; phones held sideways keep the library sidebar at its width; the select bar is one row; the scrub strip of a long folder follows your finger from the top of the page.
- New in 1.52.0: the phone's Back gesture - and the browser's Back button - closes an open menu, list, bottom sheet, dialog or confirmation and stays on the page; on a phone the selection bar shows Select, Mark read and More; the Metadata Manager tabs scroll under the finger on a touch screen.
Supported formats¶
| Formats | |
|---|---|
| Archives | ZIP (.cbz, .zip), RAR 4 and RAR 5 (.cbr, .rar) |
| Page images | JPEG, PNG, WebP, AVIF, GIF, BMP, TIFF |
Archives are read in place by a managed library (no external 7z or unrar binary), and pages are decoded in a separate, supervised worker process so a malformed file cannot take the server down. Not supported yet: solid RAR and 7-Zip archives (scanned and listed, but the reader cannot open them; repack them as .cbz), PDF, EPUB, CBT and folders of loose images. Details: Supported archive formats.