Metadata

Metadata is a set of information associated with a work, such as its title, author, publisher, among others. Different formats have different ways of storing and representing metadata. Bunko Shelf will try to extract as much metadata as possible from a manga or book, but it will not always be possible. For example, PDF files usually lack good metadata support, and manga archive files (CBZ/CBR) often have malformed or missing metadata.

Sources by format

Below are the metadata sources supported for each format:

CBZ/CBR

Metadata is extracted from the ComicInfo.xml file found inside CBZ and CBR archives when present. Currently Bunko Shelf is based on the 2.0 standard schema from The Anansi Project and can detect and extract metadata from the following XML template (which you can use to add and/or adapt your mangas' metadata).

<?xml version="1.0" encoding="utf-8"?>
<ComicInfo>
    <Title></Title>
    <Series></Series>
    <Number></Number>
    <Count></Count>

    <Summary></Summary>

    <Year></Year>
    <Month></Month>
    <Day></Day>

    <Writer></Writer>
    <Penciller></Penciller>
    <Inker></Inker>
    <Colorist></Colorist>
    <Letterer></Letterer>
    <CoverArtist></CoverArtist>
    <Editor></Editor>

    <Publisher></Publisher>
    <Imprint></Imprint>
    <Genre></Genre>
    <Tags></Tags>
    <Web></Web>
    <PageCount></PageCount>
    <LanguageISO></LanguageISO>
    <Format></Format>
    <Manga></Manga>

    <AgeRating></AgeRating>
    <CommunityRating></CommunityRating>
    <GTIN></GTIN>
</ComicInfo>

Genre and Tags

The fields for genre <Genre> and tags <Tags> must be filled in lowercase, without spaces between them, and separated by commas: school,slice of life,shonen,yuri. Spaces are allowed if they are part of the genre or tag.

Reading Orientation

While mangas are often read right-to-left, Bunko Shelf allows specifying the reading direction using the <Manga> tag. According to the standard, Bunko Shelf supports these four values:

Unknown: Not specified (default is assumed right to left).
No: Not a manga and is read left to right.
Yes: Is a manga and is read right to left.
YesAndRightToLeft: Is a manga and is read right to left.

Manga with Western Orientation

For mangas that are read from left to right, we have added an additional non-standard value YesLTR for the <Manga> tag. This value indicates that the manga is of Japanese style but is read from left to right.

Age Rating

Bunko Shelf interprets the <AgeRating> tag in the ComicInfo.xml file as a recommended minimum age for reading. It does not accept direct numeric or arbitrary values.

Age (reflected in Bunko Shelf)	Valid value in <AgeRating>
0+	`G` `Early Childhood` `Everyone`
6+	`Kids to Adults`
10+	`Everyone 10+` `PG`
13+	`Teen`
15+	`MA15+`
16+	`M`
17+	`Mature 17+`
18+	`Adults Only 18+` `R18+` `X18+`
No age (null)	`Unknown` `Rating Pending`

Age Rating Tags

For Bunko Shelf to correctly recognize the age rating, it is important to use exactly the tags mentioned in the table above within the <AgeRating> field of the ComicInfo.xml file. Only one age rating value can be added in the <AgeRating> tag. If multiple values or an unrecognized value are provided, Bunko Shelf will not apply any age rating to the manga.