Skip to content

Reader

Select any archive in a library to open it in the reader. This page covers the reader's layouts, controls and how it remembers where you are.

The reader on desktop: a single page centered on a dark background, the toolbar above and the page slider below

The reader toolbar on desktop: back arrow, page counter and the archive's name on the left; previous and next archive, Series info, the bookmark menu, the favorite star, the Display and Quality menus, help and fullscreen on the right

Toolbar

On desktop and tablet, the toolbar at the top holds, on the left:

  • Back to folder.
  • The page counter (12 / 40, or 12-13 / 40 while a double page is showing).

and on the right:

  • Previous archive / Next archive. Their tooltips name the neighboring archive. They are disabled at either end of the folder.
  • Series info (the (i) icon), when the archive belongs to a series with series information: opens the series page. It shows whenever the folder view's Series info button would show for this archive, so not when series information is turned off. Your place in the archive is saved when you leave for the series page.
  • Bookmarks (the bookmark icon, filled when the page on screen is bookmarked): Bookmark this page (Remove bookmark on a bookmarked page), and Bookmarks…, which lists this archive's bookmarks so you can jump to or delete one.
  • Favorite (the star): adds the open archive to your favorites.
  • Display (its icon shows the page mode on screen): how pages are laid out - Layout (see Page modes), Image fit (in vertical mode the Page width slider instead), Reading direction (not in vertical mode) and Page transition (in vertical mode Tap to scroll and Edge taps instead).
  • Quality (the magic-wand icon): Upscaling, Enhance quality, Page quality and Downscale filter, described in Image quality.
  • Reading help (?).
  • Fullscreen. A double tap or double click in the center of the page does the same.

Picking an option in Display or Quality applies it at once and closes the menu; the selected option in each group is highlighted.

The name of the open archive shows with the controls, in fullscreen as well: in the middle of the toolbar on wide screens (about 1000 px and up), otherwise in a small row just below it. A long name is cut with an ellipsis; hover it with a mouse to see the whole name.

In a normal window the controls stay visible. In fullscreen they hide after 3 seconds without input. Tap the center of the page, press m, or (with a mouse) move to the top of the screen to bring them back. Double tap the center (or double click it) to enter or leave fullscreen.

The bottom bar has a page slider: tap to jump, or drag to scrub, with a bubble showing where you will land. When the controls are hidden, a thin progress line shows how far through the archive you are.

Fullscreen on iPad and iPhone

In Safari, Fullscreen switches the reader to its own immersive in-page mode instead of Safari's fullscreen: Safari's fullscreen would leave a system close button and the status bar sitting over the page, and the page has no way to hide either. Immersive mode hides the reader's own toolbar and bars the same way fullscreen does elsewhere, without any of that.

For a reader with no Safari bars at all, add MangaPixer to the Home Screen (Share > Add to Home Screen). The installed app has no browser bars and an opaque black status bar. The same goes for an app installed from Chrome on Android. In an installed app, the reader opens in immersive mode, with its own bars hidden; tap the center of the page to bring them back.

On phones

On screens narrower than 600 px, the toolbar keeps only Next archive, Fullscreen and Reader options (⋮). Reader options opens a bottom sheet with everything else, grouped like the desktop toolbar:

  • Bookmark page, Bookmarks, Favorite and, when the archive has series information, Series info: the same actions as the desktop toolbar's bookmark menu, star and Series info button. A bookmarked page or a favorite archive shows the filled icon, highlighted. Bookmarks closes the sheet and opens the list of this archive's bookmarks; Series info closes the sheet and opens the series page.
  • Display: Layout, Image fit, Reading direction and Page transition. In vertical mode, Page width, Tap to scroll and Edge taps replace the paged-only groups.
  • Quality: Upscaling (plus Enhance quality while Enhance is selected), Page quality and Downscale filter (see Image quality).
  • Previous archive, Next archive and Reading help.

Changing a setting, bookmarking the page or favoriting the archive keeps the sheet open.

The Reader options bottom sheet on a phone in vertical mode: the Bookmark page, Bookmarks, Favorite and Series info tiles, then the Display section with Layout, Page width, Tap to scroll and Edge taps, and the start of the Quality section

Page modes

Choose a mode from Display > Layout (on phones: Reader options > Layout):

Mode Phone label What it does
Auto (orientation) Auto Double page in landscape, single page in portrait. Switches live when you rotate the device or resize the window.
Single page Single page One page at a time.
Double page Double page Two pages side by side: 1-2, 3-4, …
Double page (shifted) Double, shifted Pairing moved by one page: the cover shows alone, then 2-3, 4-5, … Use this when a two-page spread is split across the wrong pair.
Vertical (webtoon) Vertical One continuous vertical strip you scroll through.

Details:

  • Wide pages are never paired. A page at least 1.2 times wider than it is tall (usually a scanned spread) is shown alone at full width in both double modes, and pairing restarts after it.
  • Narrow portrait screens show single pages. If you pick a double mode on a narrow portrait screen (under 600 px wide), pages still show one at a time. Double page returns when you rotate to landscape or widen the window.
  • Your layout choice is remembered by this browser (Auto, Single or Double). It applies to every archive you open on that device, and is not saved to your account. The double-page pairing is saved differently: see Fixing double-page pairing.
  • Choosing Vertical from the menu lasts for the current archive only. To make a series always open in vertical mode, an admin sets its reading direction to Vertical (see Reading direction).

Fixing double-page pairing

Scanned releases often insert extra pages (credits, color pages), so from some point on the pages pair up wrongly: the left half of a spread ends up next to the right half of the previous one. You can fix this anywhere in an archive:

  • Pick the other double-page mode. The highlighted entry, Double page or Double page (shifted), shows how the spread on screen is paired. Picking the other one shifts the pairing by one page from this spread on, up to the next wide page. On the first page this is the classic "cover alone" setting.
  • Press o. The same as picking the other mode.
  • Or use d. At a wrongly paired spread, press d for single page, go to the next page, and press d again: the pairing now starts at that page.

Things to know:

  • The pairing is saved for the archive, for everyone. It is stored on the server as a property of the file, so every user who can read the archive sees the same pairing, and anyone who can read it can change it.
  • A changed file starts over. If the archive is replaced or modified, its saved pairing is dropped.
  • Archives you have not adjusted use the setting you last picked on the first page of an archive (cover alone or not), remembered by this browser.
  • If the pairing cannot be saved (for example, you are offline), it still applies until you leave the archive, and the reader says so.

Image fit

Image fit (in the Display menu) has four options:

  • Fit screen (default): the whole page fits on screen.
  • Fit width
  • Fit height
  • Original size

The fit resets to Fit screen each time you open the reader.

In vertical mode, Image fit is replaced by a Page width slider from 15% to 100% of the screen width. The default is 70%, and your browser remembers the setting. Pages in the strip sit edge to edge, with no gap.

Image quality

Scanned pages rarely match your screen pixel for pixel, so every page is either shrunk or enlarged before you see it. Manga and comics are mostly line art and screentones (fine dot patterns), and both suffer when a browser resizes them with its default method: lines go soft and screentones can shimmer into moire patterns. The Quality menu (magic-wand icon; on phones, the Quality section of Reader options) holds three settings that control this. All three are remembered by this browser, not your account.

Page quality

  • Auto (default): the reader works out how large each page will actually appear on your screen, including its pixel density, and asks the server for a copy at about that size. The server shrinks the page once, with a high-quality filter, and caches the result. Pages load faster and look cleaner than when the browser shrinks a full-size scan.
  • Full: always download the original page. Use this if you zoom in a lot, or want the exact source pixels.

The server never enlarges a page: if your screen needs more pixels than the scan has, you get the original. Animated pages are always sent as they are.

Downscale filter (Auto page quality only)

How the server shrinks a page:

Filter Look Good for
Sharp Crispest lines; may show moire on screentones Clean digital releases with little screentone
Balanced (default) A middle ground between the other two Most scans
Soft Smoothest screentones; lines slightly softer Heavily screentoned print scans

Press s to cycle through the filters while reading. With Full page quality nothing is shrunk, so the filter is greyed out ("Applies to Auto page quality").

Upscaling

What happens when a page is shown larger than its original resolution (a small or old scan on a big or high-density screen). Pages that are not being enlarged are always left to the browser, and nothing is ever sent to the server: the work happens on your device's graphics chip.

  • Smooth: the browser's normal image scaling. No extra work, works everywhere.
  • Crisp (default): AMD FidelityFX Super Resolution 1 (FSR 1): an edge-aware upscale plus a light sharpening pass. Cheap on battery, and it works on almost any device, over plain http:// too.
  • Enhance: Anime4K, an upscaler designed for anime and line art. It restores and redraws lines and screentones for the sharpest result, at more graphics work than Crisp.

Animated pages (a GIF, WebP or PNG with several frames) are always shown as they are: Crisp and Enhance draw a page as one still picture, which would stop the animation.

Which graphics engine runs what:

Choice Runs on Needs
Crisp WebGL2 Any browser with WebGL2 (almost all). Works over plain http://.
Enhance WebGPU when the browser offers it A secure connection: HTTPS, or localhost on the computer running MangaPixer.
Enhance WebGL2 otherwise (for example over plain http://<LAN address>) WebGL2 with float render targets (most devices). Runs Efficient only.

Browsers only offer WebGPU to secure pages, so on a phone or tablet that opens MangaPixer as http://192.168.x.x:… (a LAN install, Docker or Unraid without a reverse proxy, or the Windows app with Allow LAN access), Enhance runs on WebGL2 instead. It gives practically the same picture as WebGPU Enhance with Efficient quality; only Max quality needs WebGPU. For WebGPU, open MangaPixer over HTTPS (see Reverse proxy and HTTPS).

The Quality menu always tells you what is running: the selected choice has a small second line naming the upscaler that runs (for example "AMD FSR 1" for Crisp, "Anime4K" for Enhance, or "Anime4K (WebGL2)" when Enhance runs without WebGPU - then Max quality says what it needs), and a choice that cannot run on this device is greyed out with the reason ("Needs a secure connection (HTTPS)", "Graphics chip unavailable", ...). On phones, the reasons are listed under the Upscaling chips. If a choice you picked earlier (for example on HTTPS) cannot run on this connection, the reader says so once ("Enhance isn't available here - showing Smooth.") and shows the page with Smooth; your choice is kept for the next time it can run. The status line under Upscaling (also the Quality button's tooltip) sums up what this device offers (for example "GPU: WebGPU needs HTTPS, WebGL2 ready"); on a phone, where the choices are chips without a second line, it names the engine in use instead. If the browser can only draw WebGL in software (its graphics chip is blocked, often an old or unusual driver), Enhance is greyed out as "Graphics chip unavailable", because it would take seconds per page; Crisp still works there.

Crisp is the default until you pick something else on a device; where it cannot run, that device quietly shows Smooth (the menu says why). Enhance has the edge on some pages, but it costs several times the graphics work and battery of Crisp. Crisp and Enhance work in single page, double page and vertical modes. Press e to cycle Smooth, Crisp and Enhance (choices this device cannot run are skipped). Both use the graphics chip, so they can use more battery on phones and tablets; Crisp much less than Enhance.

Enhance quality picks how much work Enhance does in single and double page. It appears under Upscaling while Enhance is selected (not in vertical mode):

  • Efficient (default): a lighter Anime4K network. It uses much less graphics memory and battery, and is the right choice on phones and tablets.
  • Max quality: the heavier network Enhance used before version 1.24.0. It can be a little sharper in single and double page modes, at the cost of more graphics memory and battery. WebGPU only: when Enhance runs on WebGL2 it is greyed out and Efficient is used (your choice is kept for WebGPU).

In vertical mode Enhance always uses Efficient (your Enhance quality choice is kept for the paged modes), because it keeps many parts of the strip enhanced at once while you scroll. There, the enhanced (or sharpened) version of a page appears a moment after you stop scrolling (the plain page shows while you scroll quickly), and only pages shown more than 1.2 times larger than their original width are processed.

If the graphics chip resets twice within a minute (for example after the app spends time in the background), vertical-mode Enhance or Crisp pauses until the page is reloaded and the Upscaling status line reads "Enhance paused (GPU reset)" (or "Crisp paused"); the pages still show normally.

Before an enhanced picture replaces the page, MangaPixer checks a few of its pixels against the page. If the graphics chip returns a black picture for a page that is not black (seen now and then with Enhance on WebGPU, for example on an iPad over HTTPS), the plain page stays on screen, Enhance tries that page or part of the page once more, and after a second black result it leaves it plain until the page changes. The Upscaling status line then adds how many such pictures it caught since the reader was opened, for example "GPU: WebGPU ready, WebGL2 ready - 2 blank frames caught". The count is kept only in this browser tab and is never sent. A page that really is black is enhanced as usual.

Enhance is built on Anime4K by bloc97: on WebGPU through the anime4k-webgpu port, on WebGL2 from Anime4K's own shaders. Crisp is a port of AMD's FidelityFX Super Resolution 1. See THIRD-PARTY-NOTICES.md.

Reading direction

The reader supports left-to-right (comics), right-to-left (manga) and vertical (webtoon) content. In right-to-left mode:

  • The arrow keys swap: ← moves forward.
  • The side tap zones swap.
  • Swipes are mirrored.
  • The page slider fills from the right.

Where the direction comes from. When you open an archive, the server picks its mode from the nearest setting it finds:

  1. the folder's direction,
  2. then the library's direction,
  3. otherwise left-to-right.

Admins set these (readers cannot):

  • Per library: MangaPixer Administration > Libraries, the Direction menu on each row: Inherit, Left-to-right, Right-to-left or Vertical.
  • Per folder: in the library view, choose Select, pick one or more folders, then Direction. The same options appear there, with Inherit (clear) removing the folder's own setting. Admins see a small LTR / RTL / Vertical chip on folders that have their own direction.

Display > Reading direction (Left to right / Right to left; on phones the same group in Reader options) sets the direction for the archive you are reading. It is not saved. The library sidebar and home cards show a small icon with each library's direction.

Reading mode suggestions

Admins can let MangaPixer point out folders that would read better in another mode: MangaPixer Administration > Libraries > Reading mode suggestions. The list uses only what MangaPixer already knows about your files - nothing is looked up on the web:

  • Tall-strip pages (the strongest sign): when at least half of a folder's pages are at least twice as tall as they are wide, it suggests Vertical (webtoon). MangaPixer looks at up to 400 measured pages per folder, and needs at least 20.
  • ComicInfo: when most of a folder's archives that state a reading direction in their ComicInfo.xml say Manga = YesAndRightToLeft, it suggests Right-to-left.
  • The linked series (a hint - on its own, low confidence): a series marked as a webtoon, or from Korea or China / Taiwan, suggests Vertical; a Japanese series suggests Right-to-left. A hint that the folder's own pages or ComicInfo contradict is dropped - for example a Korean series whose pages are ordinary book pages.

Each row shows the folder, what MangaPixer found, the mode the folder opens in now and the suggested one, and a confidence: High, Medium or Low. Signals that agree raise the confidence, signals that disagree lower it.

  • Apply sets the folder's reading direction - the same setting as Direction in the library view - for everyone. Tick several rows and choose Apply selected to set them together. Nothing is ever applied on its own, and readers can still switch the mode for the archive they are reading.
  • A folder is listed only when the suggestion differs from what it opens in today (its folder's or a folder above's direction, otherwise the library's). Right-to-left is not suggested for a library set to double pages.
  • A folder that has its own direction, or sits below a folder that has one, is never suggested: an admin already chose. Where its pages or ComicInfo disagree with that choice, it is listed under Set by an admin, without an Apply button; change it from Direction in the library view if you want to.
  • A series linked to series information that keeps its volumes or chapters in subfolders is listed once, as the series folder, with the pages of all its subfolders counted together. Without a series link each subfolder is listed on its own.

Page transition

Page transition (in the Display menu) controls the animation when you turn a page in single or double mode:

  • Slide (default): the new page slides in.
  • Reveal: the new page is wiped in over the old one.
  • None: pages change instantly.

The choice is remembered by this browser. Animations are skipped in vertical mode, while scrubbing the slider, and when the page is zoomed. They are also turned off entirely if your operating system asks for reduced motion.

Keyboard shortcuts

Key Action
← / → Previous / next page (swapped in right-to-left). At the end or start of an archive, moves to the next or previous archive.
Home / End First / last page
f Toggle fullscreen
d Switch between single and double page. Keeps the archive's pairing; switching to double page makes the page you are on start a spread.
o Double page: shift the pairing by one page from the current spread (saved for the archive, see Fixing double-page pairing)
s Cycle the downscale filter: Sharp, Balanced, Soft
e Cycle Upscaling: Smooth, Crisp, Enhance (skipping any this device cannot run), in every mode
m Show / hide the controls
Esc Close an open menu or help. Otherwise exit fullscreen, or go back to the folder if not in fullscreen.
? Show / hide the help overlay
  • In vertical mode only m, s, e, ? and Esc (to close help) apply. Scroll with the mouse wheel, trackpad or the usual scroll keys.
  • Shortcuts are ignored while you type in a text field.
  • When the page slider has keyboard focus, the arrow keys step one page and Home / End jump to the ends.

Touch and mouse

Single and double page:

  • Tap the left or right 30% of the screen to turn the page. In right-to-left mode the sides swap.
  • Tap the center to show or hide the controls. Double tap the center (or double click it) to enter or leave fullscreen; a single tap then waits a moment (about a quarter of a second) to tell the two apart.
  • Swipe left or right anywhere on the page to turn the page. Start the swipe inside the page: the very edge of the screen belongs to the browser's back/forward gesture. Swipes are ignored while the page is zoomed.
  • Scroll the mouse wheel (or two fingers on a trackpad) down for the next page and up for the previous one, in reading order (also in right-to-left mode, and a whole spread in double page). One scroll turns one page: the rest of the same scroll, including a trackpad's glide, is ignored until the wheel stops for a moment.
  • This works only while the page fits the screen. When it does not (a tall page in Fit width, any page larger than the screen in Fit height or Original size, or a zoomed page), the wheel scrolls the page as usual and never turns it, also at the end of the page.
  • Sideways scrolling never turns a page, and Ctrl (Cmd on a Mac) + wheel, or a trackpad pinch, still zooms the browser.

Vertical mode:

  • Scroll freely. This is always available.
  • Tap to scroll adds tap zones. Options: Off, 80%, 90% (default) or 100% of a screen per step. The setting is remembered by this browser.
  • Tap the left or right edge (20% of the width each, from the top of the screen to the bottom) to move a step: with Right goes forward (the default) the right edge moves forward and the left edge back; with Left goes forward it is the other way round. Choose it under Edge taps in the Display menu (on phones, in Reader options). The setting is remembered by this browser and does not follow the series' reading direction.
  • In the center column between the edges, tap the top strip (about 15% of the height) to move back one step and the bottom strip (about 15%) to move forward one step.
  • Tap the rest of the center to show or hide the controls; double tap it (or double click) for fullscreen. A tap on an edge or a strip moves at once; only the center waits a moment to tell a single tap from a double tap.
  • A horizontal swipe moves a step too, following Edge taps: with Right goes forward swipe left to go forward and right to go back; with Left goes forward swipe right to go forward.
  • With Tap to scroll off, a tap anywhere shows or hides the controls, and a double tap anywhere enters or leaves fullscreen. The edges and the swipe are off too; Edge taps stays in the menu, greyed out, until you turn Tap to scroll back on.
  • At the bottom of the strip, Previous archive and Next archive buttons appear. Vertical mode never moves to another archive on its own.

Help overlay

Select Reading help (?) or press ? to see the controls for the current mode, drawn over the page. The overlay opens automatically the first time you use the reader on each device. Tap anywhere to close it.

The help overlay drawn over a page: tap zones on the left, center and right, the swipe band across the middle, and the Reader controls card listing the keyboard shortcuts

Moving between archives

In single and double page mode:

  • On the last page, turning the page once more names the next archive in the same folder; turning it again within 3 seconds opens it. A tap, click, swipe, arrow key or wheel scroll all count. Holding an arrow key down, or the glide of the same trackpad scroll, never counts as the second turn.
  • On the first page, going back twice the same way opens the previous archive, on its last page.
  • A short message names the archive you moved to. At either end of the folder you see "You’ve reached the end. No next archive in this folder." or "You’re at the start. No previous archive in this folder."

"Next" follows the folder's Name order (see Library layout). Moves between archives replace the browser history entry, so Back always returns to the folder.

Loading and prefetch

The reader loads ahead so page turns feel instant:

  • Single and double page: the next 6 pages and the previous 2.
  • Vertical: the next 4 pages below your scroll position.
  • Prefetch stays within the current archive.

While a page is still on its way (for example when the library's drive is spinning up), the reader shows a small spinner where the page will appear, and adds Loading… if the page has not arrived after about 3 seconds. In vertical mode each page's space is reserved and shows its own spinner; if a page fails to load, Page N did not load - Tap to retry asks for it again.

On the server, the page you are looking at always takes priority over prefetching, and prefetching takes priority over background work such as analyzing new archives. Extracted pages are cached (see the cache budget in Configuration), so rereading is fast.

Where you resume

The server saves your position as you read, including when you let go of the page slider and when you switch away from the browser or app. When you open an archive again:

Archive state Opens on
Never opened Page 1
Started, not finished The page where you left off
Finished (you reached the end: the last page or near it) Page 1
Marked read, but you last stopped partway through (before the end) Where you left off, or page 1 if Always open read archives from the start is on

This works the same in every mode: in vertical mode the archive opens scrolled to that page.

Always open read archives from the start is in Settings > Reading. It is off by default and saved to your account.

Read and unread

Reaching the end marks an archive as read: the last page, or near it (below). In vertical mode, scrolling to the very bottom counts. The read mark is sticky: going back to an earlier page later does not make the archive unread again. Arriving at the end of an archive through Previous archive does not mark it read, even if you then step back a page or two; going back past the end does resume saving.

Near the end counts as finished

Stopping on page 19 of 20 counts the same as stopping on page 20. A position is at the end when at most n pages follow it, where n is 5% of the archive's pages rounded down, at least 1 and at most 5:

Pages in the archive Pages that count as the end
1 page 1
2 page 2 (the first page never counts)
3 to 39 the last 2 pages (19/20 and 20/20)
40 to 59 the last 3 pages
60 to 79 the last 4 pages
80 to 99 the last 5 pages
100 or more the last 6 pages (195/200 counts, 190/200 does not)

The same rule both marks the archive read and decides that a read archive opens on page 1, so an archive that reopens at the start always shows as read. In double page mode, a spread counts once its later page is at the end.

This rule applies from version 1.27.0 on. Existing reading positions and read marks are not changed: an archive you left on page 19 of 20 before the update keeps its Reading state and resumes there, and is marked read the next time you reach the end.

There is no mark-read button inside the reader. To mark archives or whole folders yourself, use the library view:

  1. Choose Select.
  2. Pick items. Shift-click selects a range, and on touch screens a long press offers Select to here. The Select menu also offers Select all, Select all unread and Select all read.
  3. Choose Mark read or Mark unread, then Done.

  4. Selecting a folder applies to every archive below it, at any depth. Selecting a volume in the Volumes view applies to every archive in that volume, and a volume's own page has the same Select mode for its chapters.

  5. Mark unread fully resets an archive: it clears both the read mark and your position, so it opens on page 1 next time.
  6. Cards show ✓ Read or Reading badges. Folders show ✓ Read when everything inside is read and Reading when it is partly read.
  7. On the home page, the × on a Continue reading card (Remove from Continue reading) hides it from that row without marking it read.

Incognito and your reading history

Incognito hides the libraries you marked Private from Home, search and browsing. It does not pause progress tracking. Your position and read marks are still saved while Incognito is on, including in Private libraries. See Users and access.