Skip to content

Series information

MangaPixer can show a series summary (title, description, authors, genres, publication status, cover art) for your folders and archives. The information comes from two places:

  • ComicInfo.xml inside your archives. It is read when an archive is analyzed; nothing leaves your server.
  • MangaUpdates, only if an admin allows it. An admin identifies a folder (or a single archive) with a MangaUpdates series; MangaPixer then fetches that series' details and cover once and stores them on your server. With Automatic matching on, MangaPixer also matches new series folders on its own (see Automatic matching).

Folders and archives with information show an (i) in the cover's bottom-left corner. It opens a side panel (a bottom sheet on a phone); Open series page leads to the full page. A folder that holds several series (an anthology or an author's folder, for example) lists them in the panel instead, without a series page. Inside a series folder, Series info in the top bar opens the same panel; an admin inside a folder without information sees Identify… there instead (when web lookups are on for the library). The (i) and the top-bar button update as soon as an admin links, unlinks or marks a folder, without reloading the page. New in 1.41.0: while reading, Series info (the (i) in the reader's top bar; Series info in Reader options on a phone) opens the full series page of the archive you are reading, when it has series information.

The (i) also appears on Search results, on the Favorites page and the home page's Favorites row (a favorites stack shows its folder's) and on the home page's Continue reading and New chapters cards. New in 1.48.0: a favorite archive shows the series it belongs to, like a Continue reading card (before, only an archive with its own information did). A Continue reading card is one archive, so its (i) shows the series that archive belongs to (for example, the linked series folder it sits in); a New chapters card shows its folder's, or the archive's for a loose archive.

Summary on hover

With a mouse or trackpad, rest the pointer for a moment on the cover, the title or the (i) of an item that shows the (i) - in the library's card and list views, in Search, on the Favorites page and in the home page's Continue reading, New chapters and Favorites rows. A short summary appears beside it: the title, up to two alternative titles, the facts line, up to three genres and the first lines of the description. You can move the pointer into the summary; More under the description opens the series page. It closes when the pointer leaves, when you press Esc, click, or scroll. A click still opens the item, and the (i) still opens the full panel.

  • Nothing is fetched while you just move the pointer across the library: the summary is loaded only after the pointer has rested on one item, from your own server (the same information the panel shows). Nothing is sent to MangaUpdates.
  • It follows Show series information: when an admin hides series information for a library or everywhere, there is no (i) and no summary.
  • Touch screens (phones, tablets) are not affected, and keyboard focus does not open it: use the (i) there.
  • Turn it off in Settings > Series information > Show series information on hover. It is on by default and saved to your account.

On the series page the description appears once, under About. Genres are shown as text. The precedence line under Sources appears only when both MangaUpdates data and ComicInfo exist. New in 1.41.0: when the series also has a MangaDex title (see Volume covers and volume lists), Sources links to it ("Also on: MangaDex"); the link only opens MangaDex in your browser when you click it - nothing is fetched to show it. A series page for a single archive offers Read (or Continue reading) and Show in folder.

Where the information applies

A link made on a folder applies to the folder and everything inside it, so every chapter in a series folder shows the series. An archive can also be linked on its own (a one-shot in an artist folder, for example).

  • Don't match marks a folder or archive as "not one series": nothing is inherited from above. Use it on anthology, magazine and artist folders, then link the right subfolders or archives individually.
  • Collection about (new in 1.34.0) marks a folder of works about one series - fan works such as doujinshi of a manga - see Collections about a series.
  • Artist folder (new in 1.37.0) marks a folder of one artist's works - see Artist folders.
  • Source precedence decides which source wins when both have a value: Web first (the default) or ComicInfo first, per library or per folder. Chapter-level details (number, volume, chapter title) always come from ComicInfo.

These actions are in the panel's and series page's Admin menu, and in the Series menu of the browse selection bar (hidden while Show series information is off for that library or globally). The same menus set a folder's Content.

Collections about a series

New in 1.34.0. A folder can hold works about a series rather than the series itself - for example Doujins/To Love Ru/ full of fan-made doujinshi by different circles. Linking that folder to the manga would make every doujin "the manga"; Don't match loses the connection and stops automatic matching inside. Collection about keeps both:

  • The folder shows the series as context: its panel and series page say Collection about Series with the series' poster, description and genres - but none of its numbers (status, volumes, latest chapter, licensing), because the folder is not the series. It gets no volume covers, volume list, Completion, Missing report row or refresh: its record is a label only, never refreshed automatically (Refresh in its Admin menu updates it by hand).
  • Nothing inside inherits the series. Like Don't match, it stops inheritance: an archive inside shows its own link or ComicInfo, or nothing.
  • The works inside are matched on their own. Each archive in the folder is a work of its own (a numbered Title 1, Title 2 stays one work); its subfolders are judged as usual. Automatic matching searches each one by its own name and then in the form MangaUpdates names doujinshi with, the series' MangaUpdates title in front: To Love-Ru dj - Title. A work whose own name states another parody, such as a crossover (Other Series), keeps that. A dated doujin name (Artist] [2023-05] Character (Tag) (Title)) is searched by its title, To Love-Ru dj - Title; its groups are tags, never the parody. Nothing new is sent: it is the same search, and the series part comes from the record you chose, never from a file name.
  • It works inside a linked series too: the nearest decision wins, so a Doujins subfolder marked as a collection inside a linked series folder is matched work by work, while the rest of the series folder stays covered by its link. Inside a folder marked Don't match, or inside a folder still waiting in Needs review, nothing is looked up - a collection included.
  • Setting it also sets the folder's Content to Doujinshi & adult one-shots when it is something else (a box in the dialog, on by default): automatic searches include doujinshi records only below such a folder. With Automatic matching on, the works inside are queued at once (the message says how many); otherwise Match this library now finds them. Links already made inside the folder are kept.
  • How to set it: Collection about… in the Admin menu of a folder's panel or series page, or in the Series menu of the browse selection bar (one folder selected), or - from 1.34.1 - on any folder row waiting in Needs review or Unmatched (key f). It opens Identify in a "pick the series" mode: search for the series the works are about and choose Set as collection. In a folder's normal Identify, Set as collection instead (and Link instead) switches between the two after you have found the series (1.34.1). The message offers Undo. Clear collection (same menus) removes it; the Content stays as it is.
  • Suggested in review: a folder waiting in Needs review whose archives are doujin-shaped works by several circles (most names start with a [Circle (Artist)] tag, no volume or chapter numbers) and whose name matches a series closely (not a doujinshi record) reads Looks like a collection about Series, with Accept as collection as its first action (key f). The matcher never sets it by itself.
  • Collections are listed on the Collections tab of the Metadata Manager, are carried over when a folder is renamed or moved, like links, and are recorded in the audit log.

Artist folders

New in 1.37.0. Many libraries keep a folder per artist - Artists/Some Artist/ with that artist's doujinshi and one-shots, each a work of its own. The matcher recognises some of these by itself (when most archive names carry the artist's tag, or the folder is named like the author of a series linked in the library - new in 1.50.0: also by any of that author's other names your server has already stored under Artists' other names, with no new request), but not every artist folder looks like one. Artist folder tells MangaPixer, in one step:

  • The folder is never linked to a series, and nothing inside inherits a link from it - like Don't match, an archive inside shows only its own link or ComicInfo. Its panel and series page say Artist folder, with the folder's name and the artist under Declared.
  • The artist becomes the folder's declared creator - the folder's name by default, which you can change, with the role Story & art (or Story / Art). The folder's other declared facts stay. Like every declared creator it flows down to the works inside and is a hint, never a veto: a series record by that artist counts in its favour when they are matched, and a record by another artist is not ruled out by it (the creator tags in the archives' own names still are, as everywhere). The folder's name is not used as the artist the way it is in a folder recognised as an artist's folder by itself.
  • The works inside are matched on their own - unlike Don't match, automatic matching keeps working inside the folder, archive by archive (a numbered Title 1, Title 2 stays one work); its subfolders are judged as usual. With Automatic matching on, marking queues the works at once - those never tried and those that found nothing before - and the message says how many; otherwise Match this library now finds them. Links already made inside are kept.
  • The folder's own review row goes: a folder waiting in Needs review or Unmatched as one work leaves the list.
  • Nothing new is sent. The artist's name is only compared on your server with the creators the provider already returns; the works are searched by their own names, as always.
  • It works inside a linked series too: the nearest decision wins, as for collections. Inside a folder marked Don't match, or inside a folder still waiting in Needs review, nothing is looked up.
  • How to set it: Artist folder… in the Admin menu of a folder's panel or series page, in the Series menu of the browse selection bar (one folder selected), or on a folder row waiting in Needs review or Unmatched (key r). A small dialog asks for the artist and the role. New in 1.45.0: Find on MangaUpdates in that dialog searches MangaUpdates' authors for the text in the Artist field (or the folder's name) - see Find the artist on MangaUpdates. In the review list the change is sent when its Undo message closes; Artist folders in the bulk bar marks every selected folder with its own name.
  • Remove artist folder (same menus, and on the Collections tab) removes the mark: the folder is judged by its shape again. The declared artist stays - change or remove it with Declared facts….
  • Artist folders are listed on the Collections tab of the Metadata Manager, are kept by Delete fetched web data (they name no record; from 1.45.0 the MangaUpdates author picked for the artist stays too), carried over when a folder is renamed or moved, like links, recorded in the audit log, and exported with the state ArtistFolder (see Metadata export).

Find the artist on MangaUpdates

New in 1.45.0. An artist folder named after someone none of whose works you have linked yet can be tied to that artist's MangaUpdates author, so its works join the same author's series in the series information:

  • Find on MangaUpdates in the Artist folder dialog sends the text in the Artist field (the folder's name when it is empty) - and nothing else - to MangaUpdates' author search, once per press. Search MangaUpdates for the rest in Match folders by name does the same for many folders at once.
  • Each author found shows its main name (and the other name the search matched, when it is another), the number of series MangaUpdates lists, up to three genres and a link to the author's MangaUpdates page (opened in a new tab by your browser); at most 8 per folder, no pictures. Nothing is chosen for you: pick one, or None of these.
  • Nothing is marked until you press Mark. A picked author fills in the artist's name (its main MangaUpdates name); marking saves the folder as an artist folder with that artist and the author's MangaUpdates number. Marking sends nothing. Searching or picking stores nothing else: the authors found are kept only in the dialog (and in memory for an hour, so repeating a search sends nothing).
  • Renaming the artist (in Declared facts, or in the Artist folder dialog without a pick) links the new name to its MangaUpdates author when exactly one author known on this server has that name - nothing is sent; otherwise the artist stays without one and Find on MangaUpdates still works. Match folders by name as artist folders also saves the matched artist's MangaUpdates number when only one known author has that name.
  • The author's other names are not read at once: the author now counts among the known authors of Artists' other names, so Look up the rest reads them when you press it.
  • The search needs Fetch from the web (with the current consent) and the folder's library Fetch switch, counts in the daily request budget, and is refused while MangaUpdates asks MangaPixer to slow down or the budget is spent. It is never part of Automatic matching or any background work.

Match folders by name

New in 1.38.0. When a whole folder holds artists' folders, or collections named after their series, mark many of them at once: select the folders in the browse view (up to 200; archives in the selection are ignored), then Series > Match folders by name…, and choose As artist folders or As collections.

  • What is compared - only what is already stored on your server; nothing is sent to look it up:
    • As artist folders: each folder's name against every name of the artists of the series records you have (MangaUpdates and the Grand Comics Database) - every spelling a record uses, in any name order (Family Given = Given Family), with or without spaces, accents and long vowels ignored (Satou = Sato) - and, once fetched, the artist's other names (pen names) from MangaUpdates. MangaUpdates spellings of one person count as one artist. A matched folder becomes that artist's artist folder with the artist's main MangaUpdates name as its declared creator and the role from the records (Story & art, or Art for an artist who only draws).
    • As collections: each folder's name against the titles and other titles of the series records you have - the whole title, not a part of it. A matched folder becomes a collection about that series. Series linked in your libraries are listed first.
    • The folder's name is read as the matcher reads it: tags in brackets, volume numbers and edition words are left out (Some Artist (Artbooks) is compared as Some Artist). 1.39.0: as artist folders, a name in the doujin style Circle (Artist) or [Circle (Artist)] is also compared by each of its two names on its own, so it finds the artist when your records know either the circle or the artist (both known: two matches to pick from); a year or a tag in brackets is not taken for a name.
  • Nothing changes until you press Mark. The list shows every folder with a tick box: a folder with one match is ticked; a folder with several matches needs a pick (or Skip this folder); a folder without a match is left alone - as artist folders you may tick Mark it with the folder's own name. A folder that already has a link, Don't match, a collection or an artist folder is shown with it and not ticked; ticking it replaces that.
  • Mark marks each ticked folder exactly as Artist folder… or Collection about… does for one folder (with the same Doujinshi & adult one-shots Content box for collections), and shows the result per folder. With Automatic matching on, the works inside are queued at once. When a collection's series cover is not stored on your server yet, it is downloaded from MangaUpdates (cdn.mangaupdates.com, by the address MangaUpdates gave), as Collection about… does; nothing else is sent.
  • Search the web for the rest (collections only, off until you tick it): the folders without a match show the search text that would be sent for them - their cleaned name, which you can edit - each with its own tick box. Search sends only the ticked ones to MangaUpdates, exactly like the Identify search (with Hide doujinshi & novels when ticked): one folder per second, one at a time, at most 50 per run, counted in the daily budget, and stopping when MangaUpdates asks to slow down or the budget is spent (Stop ends it early). The results are only offered: pick a series for a folder to mark it - its record is then fetched, as when you choose it in Identify.
  • Search MangaUpdates for the rest (new in 1.45.0, as artist folders, off until you tick it): the folders without a match - and artist folders that have no MangaUpdates author yet - show the text that would be sent for them (their cleaned name, editable), each with its own tick box. Search sends only the ticked ones to MangaUpdates' author search (see Find the artist on MangaUpdates): one folder per second, one at a time, at most 50 per run, counted in the daily budget, stopping when web lookups are off, the budget is spent or MangaUpdates asks to slow down (Stop ends it early). The authors found are only offered; a folder with a picked author is marked with that author (instead of its own name) when you press Mark - which sends nothing.

Search by alternative title

Once a folder or archive is linked to a series, Search also finds it by any of that series' alternative titles: a folder named Dungeon Meshi turns up for Delicious in Dungeon. These hits appear in their own Series matches row above the normal results (at most 20, on the first page of results), and each card adds a caption such as aka Delicious in Dungeon (the shortest matching title; hover for the full text). A folder that is also a normal name match is shown once, in Series matches.

  • Only links that are in use count (Confirmed or automatic), and folders that are a collection about that series (new in 1.34.0); folders marked Don't match and matches awaiting review never appear.
  • The row follows the same access rules as the rest of search: libraries you cannot see, and Private libraries while Incognito is on, contribute nothing.
  • When Show series information is off, globally or for a library, that library's alternative titles are not searchable.
  • Searching runs entirely on your server; nothing is sent to MangaUpdates.
  • New in 1.50.0: the row also finds a title with a typo, after the titles that match exactly (when the results show close matches), and a title from one or two letters (a word of the title that starts with them: ka finds Kaibutsu).

New in 1.49.0. The Info panel has a Tags row next to the genres: the categories MangaUpdates lists for the linked series (the 20 with the most votes, as stored with the series) and the Tags of the archives' ComicInfo, in one row. Spellings that differ only in case, spacing, - or _ are one tag (Time Travel, time-travel). On a single series the row shows its strongest tags first - most votes on MangaUpdates, then the ComicInfo tags - and +N more shows the rest; on a folder of many works it shows the tags most of them share, as the other rows do. MangaUpdates' categories are crowd votes, so a few can be surprising or give away a plot point. After the update the tag index is rebuilt once per library, in the background; until then the row may be missing.

Select a tag (or any other chip) to search for every work that carries it. Opened from the Search page - the (i) on a result - a chip adds its tag to the search there: your text, the Reading / Read / Unread choice and the other tags stay.

Combining tags in the tag search:

  • Every tag in the field must match (and). The small button at the start of a tag in the field switches it to Not - the works must not carry it - and back.
  • Refine lists the tags of all the results, with how many of them carry each: select one to add it, or to accept either it or a tag of the same row already in the search (with two or more of that row in the search, a small menu asks which one to join), or the minus to leave out works that carry it. A row shows its most common values; +N more (new in 1.50.0) opens the whole row in a list that scrolls, Show fewer closes it again. Counts are yours: only works you can open count, Private libraries are left out while Incognito is on, and libraries with Show series information off show no tags at all.
  • Text typed next to tags narrows the works by title, by the series' other titles and by the folder's name; every word must match, in any order. A word with a - in front must not match. New in 1.50.0: accents, upper and lower case and punctuation do not matter here either, as in the plain search: pokemon finds Pokémon, re-zero finds Re:Zero.

Typed search (the ? next to the search box lists these too):

Type Finds
tag:"time travel" works with this tag (also genre:, creator:, publisher:, magazine:, type:)
creator:urasawa a value with all of these words; in quotes (creator:"Naoki Urasawa") only the exact name
genre:horror\|mystery either value (\| = or)
-genre:horror works without it (- = not); alone, every work with tags you can open except those
year:2010..2015 started in these years (year:2004, year:..1999, year:2020..)
series:monster works whose title, other title or folder name has these words
is:read, is:unread, is:reading your read state - in any search, also a plain one
library:manga only this library (its name, or the start of it) - in any search

While you type one of these fields in the search box, the list of quick results suggests its values (creator:ura lists the creators with ura in their name) and choosing one completes the field.

A word with a colon that is not one of these (such as Re:Zero) stays plain text. A tag search lists works, as before; without any field or tag, Search finds names as it always did. Nothing here is sent anywhere: tags are read from what is already stored on your server.

Identify a series (admins)

Before you can look anything up, turn on Fetch series information from the web (see Admin settings) and the Fetch switch of the library. Folders waiting in the Review list open the same dialog from Identify….

  1. Open Identify… from the panel's or series page's Admin menu, from Identify… in the top bar inside a folder without information, or select one folder in browse and choose Series > Identify…. When lookups are off, the menu item and the dialog say why.
  2. New in 1.32.0: Search on: MangaUpdates | Grand Comics Database | MangaDex chooses the site (1.42.0: MangaDex, for a series MangaUpdates does not list - see Series only on MangaDex). For a folder that looks like comics (see Comics: the Grand Comics Database) the dialog starts on the Grand Comics Database; otherwise on MangaUpdates. The switch is one tap away either way.
  3. Search: the box is filled with a suggestion (the cleaned folder name, an English title in trailing square brackets such as [Delicious in Dungeon], or the ComicInfo series; from 1.42.0 without a site's watermark at the end of the name, such as Read Online or Read Manga Online Free). Edit it if needed and press Search. Only this text is sent. Hide doujinshi & novels (on by default, off below a folder whose Content is Doujinshi & adult one-shots) leaves doujinshi, novels, artbooks and drama CDs out of the results.
  4. Or paste a MangaUpdates series address (https://www.mangaupdates.com/series/njeqwry/berserk) or a shortcode (mu:51239621230, mu:njeqwry) and press Look up. MangaPixer reads the series number from what you paste, so only that number is sent. Old-style series.html?id= addresses do not work: open the series on MangaUpdates and copy its current address.
  5. Or paste a Grand Comics Database series address (https://www.comics.org/series/4347/, or gcd:4347): only the series number is sent. An issue address (…/issue/…) does not work: open its series and copy that address.
  6. New in 1.42.0: or paste a MangaDex title address (https://mangadex.org/title/…): only its id is sent.
  7. If an archive's ComicInfo already points to a MangaUpdates (or Grand Comics Database) series, ComicInfo points to a … series – Use it previews it directly.
  8. Results are ranked by how closely they match the folder name (Strong, Possible, Weak). "matched as" shows the alternative title MangaUpdates matched. Preview opens a series.
  9. The preview shows your folder next to the MangaUpdates record: item count, the ComicInfo series, whether the pages are tall strips, and MangaUpdates' type (Manga, Manhwa, …), year, volumes, authors and genres ("MangaUpdates: webtoon" when its users tag it so). Warnings point out likely mistakes, for example a novel instead of the comic, a different year, or far more volumes than the record lists ("The record lists 7 volumes; this folder has volumes 1-43."). Volumes are compared only with the record's volume total and chapters only with its chapter total, so a folder of chapters gets no count warning when MangaUpdates counts the series only in volumes. When the folder has a declared type that the record does not fit (a folder declared manhwa, a Japanese record), a warning says so; it is a hint and never stops you from linking.
  10. Link stores the series and its cover and applies it. Undo in the message that follows restores what was there before.

Several items, one at a time (new in 1.34.0): select two or more items in browse (folders, or archives inside a folder) and choose Series > Identify one by one…. The dialog steps through them: the title reads 1 of 4: Name, and each step is the normal Identify for that item - search, results, preview. Link stores the series for that item and goes straight to the next one; Skip leaves it as it is and goes on; Stop (or the x, or Escape) ends the run. At the end a message says Linked 3 · skipped 1 (and how many were not reached, after Stop). There is no "same series for all": every item gets the record you choose for it, and an archive's own link always wins over the folder it is in, so this is the way to link single archives inside a folder marked Don't match or Collection about. The message at the end has no Undo; Unlink on an item undoes its link.

Re-run matching from browse (new in 1.34.0): Series > Re-run matching queues the selected items (one or several) for automatic matching again, the same action as Re-run matching in Review. The message says how many were queued and, for the others, why not: already linked - unlink first (an item with a link of its own, or marked Don't match, is never re-run) or inside a folder that is linked, marked Don't match or waiting in review (the folder above decides; clear it, or use Identify one by one… for the items). Nothing is sent while Automatic matching is off.

Refresh from MangaUpdates in the Admin menu fetches the linked series again (the page shows how long ago it was fetched). Unlink removes a link; inheritance from above resumes. Nothing is refreshed or matched automatically unless an admin turns on Automatic matching.

Automatic matching

Automatic matching (see Admin settings) is one switch for the whole server, off by default. It applies to every library whose Fetch switch is on. Turning it on sends nothing by itself; it needs its own consent, separate from the one for Fetch from the web.

  • What is matched. After each scan, MangaPixer looks at the folders the scan found, and at folders that gained archives, and decides from their names and contents what each one is: a series (chapters or volumes of one work, also with Volumes / Chapters subfolders), a one-shot, or a collection of different works (an anthology, an artist's folder). Series folders are matched as a whole; in a collection folder each archive, or each numbered group such as Title 1 / Title 2, is matched on its own. Archives lying loose next to other folders are matched one by one too (a one-shot, or a whole series kept in one archive), unless they look like volumes or chapters of one work. Category and container folders (Manga, an author's folder of series) are never matched themselves; the series inside them are. Folders that are unclear go to review and are never linked automatically.
  • Artist folders. A folder is taken as an artist's folder, matched archive by archive, when it is named like the creator most of its archives carry ([Artist] Title, [Circle (Artist)] Title), or - without any tag - when it is named exactly like an author or artist of a series already linked in the same library (the name in either order, Given Family or Family Given). The second rule uses only the series information already stored on your server; nothing is sent to find it. It never applies to a folder whose own archives look like volumes or chapters of one work (a series whose title is also an author's pen name stays a series), to a folder of one archive, or to a folder that is linked itself. In an artist's folder, a record whose authors MangaUpdates lists links automatically only when that artist is one of them. A folder you mark as an artist folder is treated differently: its declared artist only counts in a record's favour and rules none out.
  • Chapters and names. Numbered chapters with their own chapter titles (Title 025 Chapter Name) are one series. A name in brackets or parentheses anywhere in a folder or file name (Title [Author], Title [English Title] (Author), or Author] Title with a lone bracket), or next to a plain separator (Title by Author, Title - Chapter 12 | Author, Author - Title), is taken as a possible author: a record by that author, or whose MangaUpdates title carries it as (AUTHOR Name), wins over records with the same title. It is only used as evidence, never on its own: a two-word name in brackets at the end (Title [Two Words]) can be an English title or an author, and it links a record automatically only when the folder's own name fits that record too. MangaUpdates also writes the author after a title that several works share (Fly Me to the Moon (HATA Kenjiro) for Tonikaku Kawaii); a record found only through such a name is looked up once more, so MangaPixer can check that the name in parentheses is one of its authors - then the name counts in full. New in 1.51.0: an author's other names that your server has already stored under Artists' other names count as that author's name here too (a tag or folder name giving a pen name agrees with the record instead of sending the work to Needs review); a tag naming someone else still does, and nothing is requested.
  • Dated doujin names (new in 1.34.2). Some downloaders name doujins [Artist] [2023-05] Character (Tag) (Title), often without the opening bracket (Artist] [2023-05] ...). When a bracketed date - [2023], [2023-05] or [2023-05-17] - follows the artist tag directly, the last group in parentheses is the title and is what MangaPixer searches, groups and shows in review; the other groups are tags, and the text outside them is the character the work is about. Size and release tags such as (x1600) or [Decensored] are never the title, and text after the title stays with it ((Title) - Part 2). The character is searched last, only when nothing confident was found, and a record found that way never links automatically - it waits in Needs review. Names without the date, such as the common [Artist] Title (Parody), are read as before.
  • Partial names. A record titled Title: Long Subtitle, Title ~Long Subtitle~ or Title - Long Subtitle is offered for review for a folder named Title, and so is a long title whose first three or more words are the folder's name, but none of these is linked automatically. The other way round, a folder named Title - Subtitle is also searched as Title; when a record carries that same subtitle (a spin-off Title: Subtitle), it ranks above the plain Title series. When the two are one series family (MangaUpdates lists them as each other's main story, spin-off, side story, prequel or sequel - or, when it lists nothing, they share the title and an author), the subtitle is all that tells them apart, so the folder waits in Needs review with both series shown together instead of being linked automatically. When the archives carry the longer name, that name is searched second. A number that belongs to the title (Title Level 99) is not mistaken for a sequel number. When the right record is not on the first page of results - a one-word title, or nothing close enough - the second page of the same search is read too.
  • Counts. A folder that holds far more volumes or chapters than the series has published goes to review. MangaPixer compares the highest volume or chapter number in the file names (so 12.5 chapters and extras do not add up) with the largest count MangaUpdates states: the latest chapter, the chapter total in the status (webtoons that restart their chapter numbers each season), and the English publishers' totals. The latest chapter follows scanlation releases, so for a series MangaUpdates counts only in volumes it can agree but never counts against a record. Volume and chapter subfolders (Volumes, Chapters, Season 2 ...) count by the numbers in their file names, not by how many files they hold. A folder that mixes volumes and chapters is not compared.
  • Covers. When two records tie on the title for a folder of volumes or a one-shot (a series and its anthology, or several series with the same name), MangaPixer compares their covers with the folder's own cover: it downloads the two candidates' cover images from MangaUpdates (those that have one), compares each with the thumbnail of the folder's first archive, and gives a small preference to the record whose cover is the same picture. The comparison is made on your server with the cover thumbnail MangaPixer shows for the folder (made on the spot if the scan has not made it yet), and the downloaded covers are deleted right after. A matching cover puts the right record first in Needs review; it never links a record on its own, never counts against a record, and is not used for chapter folders or webtoons (their first page is not a cover). The two downloads count in the daily budget like any other request. Covers are compared only when Compare covers is on, under Automatic matching settings.
  • Declared facts. What an admin declared for a folder or library (see Declared facts) helps too. A declared type is a strong hint: a record from the country the type names (manga: Japan, manhwa: Korea, manhua: China; webtoon: a webtoon or a Korean or Chinese record; comic and graphic novel: a Western record) gets a clear preference, and a record the type contradicts loses the same amount - enough to settle a tie between two series of the same name, never enough to beat a record whose title fits better, and never a block: a wrong declared type does not stop the right series from being linked. It takes the place of a category folder's preference. A record by one of the declared creators is preferred like one named in brackets in the folder name; declared creators never count against a record. Nothing declared is ever sent to MangaUpdates.
  • Category folders. A folder named exactly Manga, Manhwa, Manhua or Webtoon(s) above a series gives a small preference to records of that origin. It never counts against a record: a manhwa kept in a Manga folder is still linked.
  • What is never matched. Anything with a link already (confirmed or automatic), anything inside a folder marked Don't match, and anything inside a linked series (a new chapter of a linked series is covered by its link, so it costs no request).
  • Confident matches go live at once and are listed under Auto-linked so you can check them: Confirm, Unlink, Identify… or Don't match. Close calls go to Needs review with up to five stored candidates; nothing from them is shown to readers until you accept one. Works with no good match are listed under Unmatched and tried again after 30, 90 and 180 days, then not any more. A work waiting in Needs review is checked once more, in the background, after a MangaPixer update changes how matches are scored - see Checked again after an update.
  • Match now (per library) matches a whole library at once; see Automatic matching settings.
  • Pacing. Automatic lookups send at most one request per second, so Identify stays responsive. A work costs at most four searches (a second page counts as one) plus a few record lookups, and only records that could match are looked up. Automatic lookups count in the same daily budget as everything else: when it is used up, automatic matching waits for the next day (midnight server time). Raise the budget if you want it to go faster. When MangaUpdates asks MangaPixer to slow down, automatic matching pauses too.
  • Doujinshi. Automatic searches leave doujinshi, novels, artbooks and drama CDs out, like Hide doujinshi & novels; a folder's Content setting can allow doujinshi below it.
  • Thresholds can be adjusted under Automatic matching settings.

What the matcher did - links it made, close calls, works without a match and folders it could not follow - is listed on the Review tab of the Metadata Manager page.

Renamed and moved folders

When a folder is renamed or moved - also to another library - MangaPixer recognizes its archives at the new place and moves the folder's link or Don't match, its source precedence, its default reading mode, its Content setting, its declared facts, its Volumes view setting, its cover choice, its folder cover preference and every user's star to the new folder, as long as at least 80% of its archives went to the same new folder. A setting the new folder already has is kept. A link the automatic matching gave the new folder to the same series becomes Confirmed; a different link waits on the Move conflicts page for an admin to choose (see Moving series between libraries). Otherwise (a folder split in two, for example) the settings wait under Missing folders, where you can Re-attach them to a folder of the same library or delete them. Archives keep their links and reading progress when they move anyway.

Checked again after an update

Updates sometimes change how a folder's name, counts or type are scored (for example, a Count chip that today's rules would no longer put on a chapter folder). The results already stored do not change by themselves, so after such an update, with Automatic matching on, MangaPixer checks each work that is still waiting in Needs review once more under the new rules, in the background:

  • Once per change of the rules, not on every start: each result remembers the rules it was scored under, so a work that has been checked since the last change is left alone.
  • Only what the matcher itself put there. A work an admin linked, confirmed or marked Don't match is never touched, and neither is a folder inside one, in a library whose Fetch switch is off, or one that Review everything once held back by your own choice (it is re-scored, but stays in review). A work whose chip says Reach is left as it is: the Volumes view's own check put it there, and a new score would only undo that.
  • It costs requests. The stored candidates are only a short list, so each work is looked up again: the cleaned folder name is sent, with the same type filter, to the same site as before, about two or three requests per work. They come out of the daily budget, at most one per second, and wait behind everything else (new folders, Re-run matching, retries). Nothing is sent while Automatic matching is off.
  • The row keeps its result until the new one is in. On Needs review a line says how many items are being checked again under the current rules, and each of them is marked Checking again. The new result may link the work, leave it in review with different candidates and chips, or (if nothing fits any more) move it to Unmatched. Review rows stay as they were if you act on them first.

Background refresh

With Automatic matching on, linked series are refreshed from MangaUpdates by their series number, once a day at the hour you choose in Scheduled jobs (03:00 server time unless you pick another; 1.45.0: and every 4 hours in between for the series that are due): an ongoing series by how quickly it gets new chapters or volumes (1.35.0: new chapters as scanlations appear, new volumes of the original release, or whichever is faster - your choice; 1.45.0: at about half the time between two new chapters, at most every 3 days), or at a fixed rhythm you choose; a series someone is reading (read in the last 2 weeks, or Reading on a tracker) every 2 days (1.45.0); a finished series every 3 months (or every month, or every 6 months); a series on hiatus or with nothing new for six months like a finished one. 1.45.0: MangaPixer also checks MangaDex and MangaUpdates for new chapters every few hours and refreshes a series with a new chapter right away - see Checking for new chapters. Never when MangaUpdates no longer lists them; there is no separate limit - refreshes count in the daily request budget like every other request. Only the series number is sent. The cover is fetched again only when it changed.

Folder Content

Automatic matching leaves doujinshi out of its searches, because they otherwise crowd out the series you are looking for. If a folder does hold doujinshi or adult one-shots, tell MangaPixer: Admin > Content in the panel or on the series page (folders only), or Series > Content in the selection bar for several folders at once:

  • Auto (the default): automatic matching leaves doujinshi out.
  • Doujinshi & adult one-shots: automatic matching also searches doujinshi in this folder and everything below it, and Identify starts with Hide doujinshi & novels unticked there.
  • Not doujinshi: never search doujinshi here, even inside a folder marked Doujinshi & adult one-shots.

Changing it matches again. When a change allows or stops doujinshi below the folder (setting or clearing Doujinshi & adult one-shots), the items below it that are still in Needs review or Unmatched were searched with the other rule, so they are queued to match again and the message says how many. Linked and Don't match items are never touched, nor anything below a subfolder with its own Content. With more than 200 such items MangaPixer asks first (Match again in the message); with Automatic matching off it only tells you how many could be re-run from Review. For a tree such as Doujins/Artists/<artist>/, marking Doujins is enough.

Like the folder reading direction, the value applies to everything below the folder until a subfolder sets its own; the menu says whether it is set here, inherited or the default, and Inherit (clear) removes a folder's own value. When MangaPixer's folder check thinks a folder looks like doujinshi (from its name), the menu marks that choice suggested; it never applies it by itself. Content only changes what automatic matching searches for; the Identify dialog has its own Hide doujinshi & novels box.

Reporting a wrong series

Anyone who can see a series' MangaUpdates information can tell the admins it is wrong: Wrong series? in the series panel or on the series page. Choose what is wrong (a different series; right series, wrong details; the folder is not one series; something else) and, if you like, add a note of up to 500 characters. Only admins see the report and the note. Nothing changes for anyone until an admin looks at it.

After sending, the panel shows You reported this; once an admin has dealt with it, Reviewed (you can report again if it is still wrong). You can have one open report per series and send up to 20 reports a day (more on large servers: 2% of the series you can see); the dialog says when you have reached the limit. A report is about the series, not the single archive.

Admins see the reports, with the note, under Flags on the Metadata Manager page and resolve them by relinking with Re-identify…, Unlink, Don't match or Dismiss; resolving applies to every open report on that series. Notes are never written to the logs.

What is sent

Only to api.mangaupdates.com (search and series details) and cdn.mangaupdates.com (cover images), only in libraries whose Fetch switch is on, and only:

  • when an admin presses Search, Look up, Preview, Link, Accept or Refresh - or Search under Search the web for the rest in Match folders by name (each ticked folder's search text as listed): the search text you confirmed;
  • with Automatic matching on: the cleaned name of each new series folder, or of an archive that is its own work - in a collection or artist folder, or loose next to other folders (for example "Series Title" from "Series Title [English Title]"), or the series name its ComicInfo agrees on - sent without anyone reviewing it first, which is why this needs its own consent. A MangaUpdates link in an archive's ComicInfo is used first, and then only its number is sent. Nothing inside a folder marked Don't match is ever looked up. The same name can be sent again for a folder that is still waiting: one left unmatched is tried again after 30, 90 and 180 days, and one waiting in Needs review is checked once more after an update changes how matches are scored (see Checked again after an update), never one an admin linked, confirmed or marked Don't match;
  • with Automatic matching and Compare covers on, when two records tie on the title for a folder of volumes or a one-shot: the cover images of those two records, downloaded from cdn.mangaupdates.com by the address MangaUpdates gave (nothing from your library is sent with them);
  • with Hide doujinshi & novels ticked, and always for automatic searches, the fixed list of types to leave out (Doujinshi, Novel, Artbook, Drama CD; without Doujinshi below a folder whose Content is Doujinshi & adult one-shots);
  • MangaUpdates series numbers;
  • from 1.38.0, only when an admin presses Look up the rest under Artists' other names: the MangaUpdates author numbers that the stored series records list for their creators (from 1.45.0 also those of the authors an admin picked for an artist folder), one request per author;
  • from 1.45.0, only when an admin looks for an artist - Find on MangaUpdates in the Artist folder dialog, or Search under Search MangaUpdates for the rest in Match folders by name: the text you confirmed, as an author search with a fixed page (1) and page size (10) - see Find the artist on MangaUpdates;
  • a fixed User-Agent: MangaPixer/<version> (+https://github.com/dixit92/mangapixer) - the same on every server of that version (before 1.32.0: MangaPixer-Metadata).

To api.mangadex.org and uploads.mangadex.org (new in 1.42.0): when an admin picks MangaDex in Identify, the search text you confirmed (or the id of a pasted MangaDex title address); with Automatic matching on and Search MangaDex when MangaUpdates finds nothing on, the cleaned name of a work MangaUpdates found nothing close for (at most two searches; never for comics or inside a Collection about folder); MangaDex record numbers (Look up, Link, Refresh, background refresh); fixed parameters (all four content ratings, cover art, authors and artists); the fixed User-Agent. A candidate's cover is shown from MangaPixer while you choose; a linked series' cover is stored on your server.

Never sent: file paths, your file list, user accounts, reading progress, reports and their notes, cookies, or anything that identifies your server. MangaUpdates sees your server's IP address, as with any web request. Readers' browsers never contact MangaUpdates: covers are stored on your server and served by MangaPixer. Logs record IDs, counts, status codes and timings, never search text, folder names or titles.

MangaPixer is polite to MangaUpdates: at most 2 requests per second (5 per second for cover images), a daily request budget, and when MangaUpdates asks it to slow down it waits (up to an hour) before trying again. Search results are kept in memory for an hour, so repeating a search sends nothing.

Series data is provided by MangaUpdates as-is and is credited to it wherever it is shown.

Artists' other names

New in 1.38.0.

Artists often publish under several names: pen names, other spellings, the name in Japanese, Korean or Chinese script. MangaUpdates keeps them on each author's page. MangaPixer can read them for the creators of the series you have linked, so Match folders by name recognises an artist's folder named with any of them.

Metadata Manager > Settings > Artists' other names shows how many of the known authors are looked up ("12 of 1512 known authors fetched"). The known authors are the creators that a stored MangaUpdates record lists with their MangaUpdates author number, for series linked (confirmed, automatically, or as Collection about) in a library whose Fetch switch is on - and, from 1.45.0, the MangaUpdates authors you picked for an artist folder in such a library (see Find the artist on MangaUpdates). Look up the rest says how many requests that takes and about how long, then reads one author page per second in the background - for 1500 authors, about 25 minutes. A progress bar and Cancel show while it runs; the card shows how many names were found when it ends.

  • It runs only when you press the button - never as part of Automatic matching, the scheduled refresh or any other background work.
  • Each request sends only the MangaUpdates author number and the fixed User-Agent, to api.mangaupdates.com - never a name, a search or anything from your library. It needs Fetch from the web (with the current consent) and MangaUpdates on the allowed sites, but not Automatic matching.
  • Every request counts in the daily request budget. The look-up stops when the budget is spent, when MangaUpdates asks MangaPixer to slow down, when you switch web lookups off, or when you press Cancel; the authors it did not reach stay to look up, and pressing the button again continues there.
  • An author already looked up is not asked again for 180 days. An author MangaUpdates does not know is remembered as such; one whose answer could not be read is tried again next time.
  • Only the author's main name and other names are stored on your server (at most 50 names per author). Delete all fetched web data removes them; deleting one library's fetched data removes the names no remaining stored series - or picked artist - needs. From 1.47.0 the metadata export carries them as each creator's otherNames.

Allowed sites

New in 1.28.0.

Metadata Manager > Settings > Web lookups lists the allowed sites: every site MangaPixer may contact for series information, each as a card with its name, the hosts it uses, what it is used for and what is sent to it. All approved sites are allowed by default:

Site Hosts Used for Sent
MangaUpdates api.mangaupdates.com, cdn.mangaupdates.com Identify, automatic matching, refresh: series details, cover art, publication status, English release totals See What is sent
Grand Comics Database www.comics.org, files1.comics.org Comics and graphic novels: Identify, automatic matching and refresh of comics (see Comics); cover thumbnails to help you choose The search text you confirm (usually a folder or file name), a start year when the name has one, and GCD record numbers; with Automatic matching on, also the cleaned names of new comics folders
MangaDex api.mangadex.org, uploads.mangadex.org Volume covers and which chapters make up each volume (see Volume covers and volume lists); 1.42.0: the series information of a series MangaUpdates does not list (see Series only on MangaDex) The search text you confirm or, with Automatic matching on, the cleaned name of a work MangaUpdates found nothing for; the MangaUpdates title of a linked series; MangaDex record numbers and your cover languages; downloads cover images
AniList graphql.anilist.co Chapters per volume, for the Missing report and virtual volumes - when an admin asks, or automatically when MangaDex has no volume list The AniList record number, or the MangaUpdates title of a series that is already linked (never a folder or file name)
Wikipedia en.wikipedia.org, www.wikidata.org Which chapters make up each volume, with English release dates and ISBNs, for series already linked to MangaUpdates whose MangaDex volume list has gaps (see Volumes) The MangaUpdates record number (to Wikidata, to find the English article), the page titles found that way or built from the linked series' title - never a folder or file name

Remove a site with the × on its card: from then on MangaPixer sends it nothing, whether an admin asks or automatic matching runs. Removed sites are listed under Not allowed with Add back. Removing or adding back a site takes effect at once and needs no new consent. Identify, automatic matching and refresh use MangaUpdates, so they stay off while it is removed (Identify can still search the Grand Comics Database and MangaDex). With MangaDex removed, Identify and automatic matching never search it, and series linked to MangaDex are not refreshed. With the Grand Comics Database removed, comics are searched on MangaUpdates only. Volume covers and volume lists use MangaDex: they stay off while it is removed, and covers already stored are kept.

Comics: the Grand Comics Database

New in 1.32.0.

MangaUpdates covers manga, manhwa and manhua; it lists almost no Western comics, graphic novels or European albums. For those, MangaPixer uses the Grand Comics Database (GCD), a free, volunteer-run catalogue of comics whose data is open (CC BY-SA 4.0). It needs no account or key.

  • Which folders. A folder counts as comics when an admin declared it Comic or Graphic novel, when it is inside a folder named Comics or Comic, or when its archives carry other clear comics signs (see Library layout). Comics are searched on the Grand Comics Database first, and on MangaUpdates only when GCD finds nothing close; everything else is searched on MangaUpdates only, exactly as before. In Identify you choose the site yourself (Search on), so a folder sent to the wrong site is one tap away.
  • What is sent to it. Only to www.comics.org (its API, under /api/) and files1.comics.org (cover thumbnails), and only: the search text you confirm (or, with Automatic matching on, the cleaned name of a new comics folder or work, as for MangaUpdates); a start year taken from the name - when the folder is named like Bone (1991), the search can be narrowed to series that began in 1991 (in Identify: Only series that began in 1991, on by default; automatic matching tries the name with its year first, then without); GCD finds a name only as it spells it, so for a name like Title - Subtitle the longest part (Subtitle) is searched too (and offered as a suggestion in Identify) - at most three searches per folder; GCD series, publisher and issue numbers; and the same fixed User-Agent as for MangaUpdates. Never file paths, file lists, user data, reading progress, cookies or anything that identifies your server.
  • Editions. GCD lists every edition and translation of a work as its own series (one comic can have a dozen: the original, an English edition, a Dutch one ...). Search results therefore show each series' language and how many issues or books it has. With automatic matching, the year in the folder name, your files' ComicInfo language (else your Preferred language), whether your files look like single issues or collected books (page counts, words like TPB) and the ComicInfo publisher help pick the right edition; they show as chips on the Review list (Start year fits, Other language, Issues or books?, Publisher fits). Same-named editions that nothing tells apart wait in Needs review: a wrong automatic link is worse than one more question.
  • Slow on purpose. GCD answers anonymous visitors only about 25 requests an hour, so MangaPixer sends it at most that many, for the whole server. Two of them are always kept for you: background matching takes a GCD request only while more are left, so Identify (a search, then a preview) keeps working. When none is left, Identify says when to try again, and automatic matching puts that comics folder back in the queue and goes on with the others - manga are never held up by a comic. A search answers with whole series, so linking a found series costs no second request; the preview reads only the series' publisher and its first issue (credits and its cover thumbnail). When GCD asks MangaPixer to slow down, or its site protection blocks a request, MangaPixer waits before trying again, like with MangaUpdates. Requests count in the same daily budget.
  • Covers. GCD's cover scans may be used to identify a comic, not as covers: the thumbnail is shown in the preview while you choose, and - with Automatic matching and Compare covers on - the thumbnails of two equally named GCD series may be compared with your folder's own cover and are deleted right after. A folder linked to a GCD series always keeps its own cover (see Covers).
  • No companions. Volume covers, volume lists and chapters per volume come from MangaDex and AniList for series linked to MangaUpdates; a series linked to GCD has none of them.
  • Credit. The series information of a folder linked to GCD shows "Data: Grand Comics Database, CC BY-SA 4.0" with a link to the series' page on comics.org.
  • Refresh. A linked GCD series is refreshed by its series number, on the same schedule as MangaUpdates series; its publisher and credits are kept.

Remove the Grand Comics Database from the allowed sites to send it nothing: comics are then searched on MangaUpdates only, and Identify shows the site as not allowed.

Volume covers and volume lists (MangaDex)

New in 1.29.0.

For a series linked to MangaUpdates, MangaPixer can also find the same series on MangaDex and read two things from it: which chapters make up each volume (so chapters can be grouped into volumes and a missing chapter shows where it belongs) and the volume covers. MangaDex is never used to identify or match a folder: it is found from the MangaUpdates link, by the linked record's own title (or one of its other titles), and a MangaDex title is accepted only when MangaDex itself links it to that same MangaUpdates series. Titles MangaDex does not list, or lists without such a link, are simply not found; they are looked at again on the series' refresh schedule.

  • What is fetched. The volume list (including chapters MangaDex does not host itself - only their numbers and volumes are read, never chapter pages), the same list filtered by your Preferred language (covers and releases) - which chapters are released in that language, so only those can count as missing -, the list of volume covers in your preferred language and in the series' original language, and the covers of volume 1 and of the volumes you have (a volume in a file name or its ComicInfo, or - 1.30.0 - a volume you have all the chapters of, by MangaDex's volume list; a volume you have only part of is not downloaded). When MangaDex lists no volume 1 cover at all (webtoons, for example), the series' main cover is downloaded instead. Covers are downloaded in their 512-pixel version, turned into MangaPixer's own cover thumbnails on your server and stored there; readers' browsers never contact MangaDex.
  • Languages. When a volume has no cover in your preferred language yet (volume 1 has one most often), the cover in the original language is used, and MangaPixer checks again on the series' refresh schedule. Changing the preferred language reads every series' cover list and released-chapter list again once.
  • When. With Automatic matching on, in the background, a little at a time so new folders are still matched promptly. Without it, only when an admin uses Refresh or Change MangaDex match…. Everything counts in the same daily budget and is paced at one request per second.
  • When MangaDex has no volume list for a series (webtoons, for example), MangaPixer asks AniList for the series' volume and chapter totals instead - by the AniList number MangaDex links, when there is one - the same lookup as the Missing report's chapters per volume.
  • A different numbering. When MangaDex numbers a series' volumes differently from its own covers and from MangaUpdates (for example several parts numbered continuously), its volume list is not used for grouping.
  • Change MangaDex match… (Admin menu of a linked series) shows which MangaDex title is used. Paste a MangaDex title address (https://mangadex.org/title/...) to use another one, choose Not on MangaDex so it is never looked up there again, or Check again.
  • Settings. Metadata Manager > Settings > Volume covers: Volume covers from the web (on by default; it still needs both consents, MangaDex on the allowed sites and the library's Fetch switch), Preferred language (covers and releases) (English by default; it decides which covers are preferred and which chapters and volumes count as released, and so as missing), the progress, and Delete stored volume covers, which removes every stored cover (the volume lists stay; nothing is sent). Metadata__AutoMatch__VolumeCovers=false in the server configuration switches the feature off regardless of the setting.

Cover images and volume data are provided by MangaDex and its community, as-is.

Series only on MangaDex

New in 1.42.0. Some series are on MangaDex but not (yet) on MangaUpdates. Such a series can use its MangaDex title as its record:

  • Identify: choose MangaDex under Search on, search (the text you confirm is sent; Hide doujinshi leaves doujinshi out on your server - nothing extra is sent), or paste a MangaDex title address (https://mangadex.org/title/…; only its id is sent). The preview shows MangaDex's title, other titles, status, start year, authors, description and cover. When MangaDex itself links the title to a MangaUpdates series, the preview says so and offers Preview on MangaUpdates - linking that one also gives English release totals.
  • Automatic matching: with Search MangaDex when MangaUpdates finds nothing on (Metadata Manager > Settings > Automatic matching; on by default; Metadata__AutoMatch__MangaDexFallback=false switches it off regardless of the setting), a folder that MangaUpdates (and, for comics, the Grand Comics Database) finds nothing close for is searched on MangaDex with the same cleaned name - at most two searches, or only the id when an archive's ComicInfo points to a MangaDex title. What it finds always waits under Needs review with a MangaDex tag; it is never linked on its own. When a MangaDex title MangaDex links to a MangaUpdates series is found, that MangaUpdates series is read by its number and proposed instead. Never for comics or inside a Collection about folder; folders left unmatched before 1.42.0 get this step when you run Match this library now with Also retry unmatched.
  • What a MangaDex record has: title, other titles, status, start year, authors, genres, description and cover; its latest chapter is the highest chapter MangaDex lists as released in your Preferred language (covers and releases) (read with its volume list); a finished series also gets its final chapter count. It has no English publishers or English release totals, no Wikipedia volume list, and AniList is asked only by the AniList number MangaDex links. Its volume list and volume covers come from the same MangaDex record. Refresh from MangaDex reads it again by its id; with Automatic matching on it is refreshed on the series' schedule like any linked series. A Collection about label cannot name a MangaDex title.
  • Switch to MangaUpdates: once MangaDex links the title to a MangaUpdates series, the series' Admin menu offers Switch to MangaUpdates: every link to the MangaDex title moves to that MangaUpdates series and keeps its confirmation, and the MangaDex title stays its companion for volume covers and volume lists. MangaPixer never switches on its own.

After an update: accept again

When an update changes what MangaPixer may send, or to which sites, the consent you gave earlier no longer covers it. Fetching from the web (and Automatic matching, when its own consent text changed) then stays off after the update, and admins see a banner on the administration pages: "An update changed what MangaPixer may send to metadata sites...". Choose Review settings, read the new consent text and the allowed sites, remove any site you don't want, tick the box and turn Fetch from the web back on. The banner goes away once every switch that was on has been accepted again, or when you leave it off.

MangaPixer 1.28.0 is such an update: it adds AniList to the allowed sites, so an instance that fetched from the web before has to accept again. So is 1.29.0: it adds MangaDex, and Automatic matching's consent text now also covers volume covers and volume lists. And 1.32.0: it adds the Grand Comics Database and Wikipedia, names MangaPixer and its version in every request, and Automatic matching's text now also covers comics and the refresh times you choose. And 1.38.0: MangaUpdates may now also be sent the author numbers of the creators of series you have stored, when you ask for artists' other names, and the names you confirm in Match folders by name. Automatic matching's consent is unchanged, but it stays paused with Fetch from the web until you accept the new text. And 1.42.0: MangaDex can now be the series record of a work MangaUpdates does not list - in Identify when you choose it, and (Automatic matching's new text) as a proposal under Needs review when MangaUpdates finds nothing. Both consents ask again. And 1.45.0 (consent version 7): MangaUpdates may also be sent the name you confirm when you look for an artist, as an author search, and the author numbers of the artists you picked; and, with Automatic matching on, MangaDex is asked for the latest uploaded chapter of your linked series (by their MangaDex ids only) and MangaUpdates' public list of the day's releases is read (by page number only). Fetch from the web asks again; Automatic matching's consent is unchanged. And 1.45.0: when you look for an artist, the name you confirm may also be sent to MangaUpdates' author search (see Find the artist on MangaUpdates), and the author numbers of the artists you picked when you ask for their other names.

Metadata Manager page (admins)

Renamed from "Series metadata" in 1.27.0; the route is still /admin/metadata.

Admins open Metadata Manager from the account menu. Its own summary tile - to review, open reports, requests used today against the budget, and whether automatic matching is on - sits at the top of the page itself, above four tabs: Settings, Review, Flags and Runs; tapping a number in the tile switches straight to its tab. When folders wait for review or reports are open, the account icon shows their number on a badge, and the menu item shows the same number and opens Review (or Flags when only reports wait).

Admin settings

The Settings tab:

  • Show series information: hides all series information (from files and from the web) for everyone when off. The data stays stored. Each library has its own Show switch too.
  • Fetch from the web: off by default. It can only be turned on after ticking the box under the consent text that explains what is sent. Turning it on sends nothing by itself. Once you have agreed, the text folds away; What is sent? next to the consent date shows it again.
  • Daily request budget: one budget for everything - Identify, automatic matching and background refresh. A whole number, 5000 by default; every search, series fetch and cover image counts one, and the count resets at midnight server time (00:00 UTC before 1.32.0). The bar and the status line show the requests used today, whether MangaUpdates asked MangaPixer to wait, and the last error. When the budget is spent, automatic work stops and Identify waits until the next day; raise the budget whenever you need more.
  • Automatic matching: off by default, one switch for all libraries whose Fetch is on. It can only be turned on after ticking the box under its own consent text (folder names are sent automatically, without review), and only while Fetch from the web is on (the consent text appears once it is). Like the first consent, it folds behind What is sent? once you have agreed. Turning it off stops new lookups; links it made stay until you remove them. See Automatic matching.
  • Per library: Fetch, Show, Precedence, Match now (see Automatic matching settings) and Delete fetched data (removes that library's web links and the stored series and covers no other library uses).
  • Artists' other names (new in 1.38.0): see Artists' other names.
  • Advanced: matching thresholds: the three thresholds and Reset to defaults (see Automatic matching settings).
  • Stored data: "ComicInfo: X of Y archives read" shows how far the background ComicInfo read has come; Delete all fetched web data removes every web link, stored series and cover, and the stored artists' other names. Don't-match marks and ComicInfo information stay.

To make sure the server never contacts MangaUpdates, whatever is set in the app, set Metadata__NetworkDisabled=true (see Configuration).

Automatic matching settings

The Automatic matching switch and its consent are described under Admin settings, what it does under Automatic matching. Its card lists the libraries it applies to: every library whose Fetch switch is on.

Match now on a library queues all of its series folders at once. Before you start, it shows a local estimate (nothing is sent to get it): how many folders it will try, about how many requests that takes and how many days at the current budget, and how many are already linked. Also retry folders that found no match before includes earlier misses. New in 1.45.0: when nothing is left to try, the panel says Nothing to match - every folder is linked or decided (or, while earlier misses are left out, how many there are and that Also retry tries them again) instead of "0 folders to match". The first time a library is matched, Review everything once keeps every result in Needs review instead of linking it, so you can check the matcher on your library before anything goes live.

Compare covers (under the Automatic matching switch, on by default) lets the matcher download the covers of two records that tie on the title, to compare them with the folder's own cover (see Automatic matching). Untick it to never download them; the rest of automatic matching is unchanged. It needs no consent of its own: the automatic-matching consent describes these downloads.

New in 1.31.0: with Compare covers on, MangaPixer also checks each automatic link once the series' volume covers are stored (see Covers) - nothing is downloaded for this. It compares the first page of each of your volume files (both halves of a jacket scan) with the web cover of the same volume in your preferred language (Preferred language (covers and releases)); a one-shot - an archive with no volume or chapter number - is compared with the volume 1 cover (or the series' main cover). Only when every compared volume is clearly a different picture - at least two volumes for a folder of volumes - does the folder go back to Needs review with the chip Cover differs. One matching cover in any language, or of another volume of the series, keeps the link; a cover in another language never counts against it (the same art under another edition's title and logo looks different). A page 1 that repeats in several volumes (a credits page) is not used. Confirmed links are never checked, and chapter folders and webtoons are not checked.

New in 1.42.0: Search MangaDex when MangaUpdates finds nothing (under the Automatic matching switch, on by default) lets the matcher search MangaDex for a folder that MangaUpdates (and, for comics, the Grand Comics Database) finds nothing close for. What it finds always waits under Needs review; see Series only on MangaDex. Untick it to never send folder names to MangaDex - volume covers and volume lists from MangaDex keep working. Metadata__AutoMatch__MangaDexFallback=false switches it off regardless of the setting.

Advanced: matching thresholds changes how sure the matcher must be:

  • Auto-link title score (85-99%, default 92%): the top candidate's title must match at least this well to link on its own;
  • Lead over the runner-up (5-30%, default 10%): and beat the second candidate by at least this much;
  • Review floor (40-90%, default 60%, below the auto-link score): below this a folder counts as unmatched instead of waiting for review.

Higher numbers link less on their own and send more to review. Changes apply to the next matching; Reset to defaults restores all three.

Review

The Review tab lists what the matcher did, with a count on each list and a library filter:

  • Needs review: close calls. A folder that looks like fan works of one series reads Looks like a collection about Series and offers Accept as collection first (see Collections about a series). A folder row also offers Artist folder… (key r, new in 1.37.0; also on Unmatched; see Artist folders). Each row shows the folder (or archive), where it is, why it is here (for example Close second: the runner-up scored almost as high; Count: your item count does not fit the record; Year, Type, Related series, Author; Cover differs: an automatic link whose volume covers turned out to be different pictures from the series' covers in your preferred language) and the stored candidates, each with its own chips - including Fits declared type / Not declared type when the folder has a declared type, and (new in 1.42.0) a MangaDex tag on a candidate found on MangaDex because MangaUpdates found nothing close (see Series only on MangaDex). Pick a candidate and Accept, or Identify… to search yourself, or Don't match. A row marked Checking again is queued to be scored once more under the current rules (a line above the list counts them); the chips and candidates shown are the earlier result until it is done. A row also says how many chapter or volume numbers are in more than one file of the folder (2 duplicate chapters; see Duplicate numbers).
  • Later (new in 1.33.0): sets a row aside so you can accept the easy ones first. The row moves to the end of Needs review and gets a Later tag; it stays there after a reload and for every admin, until the work is decided (accepted, linked with Identify…, marked Don't match) or checked again by the matcher - then it is a fresh result in the normal order. Not later brings it back at once. Rows set aside are listed oldest first after all the others. While any row is set aside, buttons above the list show All, only the rows still To review, or only the Later ones, with their count.
  • Same author and same folder (new in 1.33.0): doujins and artist collections often wait in groups. A row says when other works waiting here are by the same circle or artist - 4 more by Circle Name - read from the leading tag of the works' own names ([Circle (Artist)] Title, also Circle (Artist)] Title without the opening bracket); a circle and its artist count as one author, so [Circle (Artist)] and [Artist] are listed together. For a work whose name has no tag, the name of its artist folder or the writer and penciller in its ComicInfo are used instead. Tap the chip to list that author's works together (or press g), then use Select all and a bulk action - for example Later or Don't match - on all of them. Authors above the list shows every author with two or more works waiting, largest first. N more in Folder lists the works waiting in the same folder. A chip above the list (By Circle Name, In Folder) shows what is listed; its x shows everything again. This uses the names on your server only: nothing is looked up and the matcher is not changed.
  • Series families. Candidates that belong to one series - a main story with its spin-offs, side stories, prequels or sequels - are shown together in a box headed Same series family - check which one, each marked with its part (Main story, Spin-off, Side story, Prequel, Sequel, ...), so a folder that holds a spin-off is not given the main series' details, or the other way round. The row's chip says why: Spin-off or main story? when only the subtitle in the folder name tells them apart (never linked automatically), Series family when another series of the family also matched. The family comes from the series relations MangaUpdates lists; when it lists none, two series whose titles share the part before the subtitle and that share an author count as one family.
  • Auto-linked: links made automatically, newest first. A Series family chip means another series of the same family (for example a spin-off of the linked series) also matched the name - worth a look before you confirm. Confirm keeps one (automatic matching never changes a confirmed link), Change… opens Identify, Unlink and Don't match.
  • Unmatched: works the matcher found no good candidate for, with the date of the next automatic try. New in 1.34.0: the same N more by Circle Name and N more in Folder chips, Authors list and group filter as Needs review (including g), built from the Unmatched works only - so a folder of doujins nobody matched can be listed by circle and sent to Re-run matching or Don't match together. There is no Later here.
  • Don't match, Confirmed: what is marked or linked by hand.
  • Collections (new in 1.34.0): folders marked Collection about a series. Change series… opens Identify in its "pick the series" mode; Clear collection removes it. New in 1.37.0: artist folders are listed here too, as Artist folder: Name, with Remove artist folder; the tab's count includes them.
  • Missing folders: links or Don't match marks, source precedence, reading defaults, Content and declared facts left on a folder that was renamed or moved where MangaPixer could not follow it. Re-attach to… opens a folder picker - on the removed folder's library, with a Library choice for a series that moved to another library (new in 1.31.1); Delete removes what was left.

Archives matched on their own are marked Archive; several archives matched together as one work are marked Archive group. The other candidates' covers are not shown until you expand a row (the arrow on the right, or e), because each cover is a request to MangaUpdates.

Compare covers at a glance: every row shows your folder's or archive's own cover (Yours) next to the series cover: the Selected candidate's cover on Needs review - it follows the candidate you pick - or the linked record's stored poster on Auto-linked and Confirmed. Rest the mouse on the pair, or tap it, for a larger view. On Needs review, showing the selected candidate's cover is one request to MangaUpdates when the row first comes into view (and one per new choice), counted in the daily budget; the other candidates' covers still load only when you expand the row.

Select rows (the checkbox, x, or Select all) for bulk actions such as Accept top candidates, Accept as collections (the rows with that suggestion), Artist folders (1.37.0, folders only), Don't match, Re-run matching or Later. Every change shows a message with Undo; nothing is sent until that message closes, so Undo leaves everything as it was. Later is the exception: it decides nothing, so it is saved at once and Undo brings the rows back. Keyboard: j / k move between rows, a accept, f accept as collection, r artist folder, d Don't match, i identify, l Later (or Not later), g same author (or everything again), c confirm, u unlink, x select, e show covers.

On a phone each row is a card with the candidates as a list to choose from; tap a card and its actions appear in the bar at the bottom. Long-press a card to start selecting; the bottom bar then carries the bulk actions.

Flags

Readers' reports. Open reports come first, and among them reports on automatic links. Each shows the folder, what it is linked to and whether that link was automatic or made by an admin, who reported it, the reason and the note. Resolve it with Re-identify… (opens Identify; the report is closed once you link), Unlink, Don't match (offered first when the reader said the folder is not one series) or Dismiss. Resolved and All list earlier reports.

Runs

The Runs tab shows whether automatic matching is working or waiting, and why (switched off, budget spent, MangaUpdates asked it to slow down), how many folders are queued, the live run's progress with Cancel, and every run with its counts: folders tried, auto-linked, sent to review, unmatched, failed and requests used. Auto links changed by an admin counts the automatic links someone later changed, unlinked or marked Don't match - a measure of how well the matcher does on your library, kept on your server only. New in 1.47.0: when MangaDex stops returning a record that a linked series uses (taken down), the tab lists it above the history under MangaDex records taken down: how many, each record's title, the series here that use it, since when it has been missing, how many checks in a row missed it and when it was last found. This only shows what the new-chapter check already knows - nothing is requested and no other site is asked for a replacement. The list is hidden while no record is missing.