Skip to content
chocolatechipcats edited this page Feb 5, 2021 · 34 revisions

Metadata Management

This page is for users to share their metadata settings with others.

Some users spend considerable time normalizing metadata using replace_metadata and include/exclude_metadata_pre/post ini settings.

For Contributors

When adding content to this page, please start with a level 3 header (### Title), a description and then use a code block (indent each line with spaces or one tab) for the ini settings. If those settings are for a specific site, include the appropriate [section] to indicate that.

You should also separate settings for different functions / fandoms so users can pick and choose more easily.

For Users

When taking content from here for your own use, it's up to you to correctly add and combine them to your personal.ini settings. However, here are a few common pointers.

There are other wiki pages for the details of using replace_metadata and include/exclude_metadata_pre/post.

Using add_to_replace_metadata instead of replace_metadata lets you do exactly that--add to the replace_metadata instead of overriding it. That way you can use add_to_replace_metadata in both site sections and [defaults] and have both included. Otherwise replace_metadata from [fanfiction.net] (for example) will override replace_metadata from [defaults] (Using add_to_ with include/exclude_metadata_pre/post is more complex.)

If you have questions, the best place to ask is the FanFicFare Calibre Plugin Forum.

Contributed Settings

Removing Japanese Characters

My Kindle Voyage doesn't correctly list books with Japanese characters. Since I include tags with category in my title plugboard (search for Calibre Plugboards), I like to remove those characters.

[defaults]
add_to_replace_metadata:
# kindle voyage doesn't list books with extended chars correctly.
 /ハイスクールD×D=>
 マクロス Frontier [|] =>
 <?/?[一-龠々ぁ-んーァ-ヾ★!]+(&[一-龠々ぁ-んーァ-ヾ★!]+)?>?=>

Removing AO3 'No Warnings', 'Tags To Be Added'

I don't find AO3's non-warnings and 'Tags To Be Added' tag to be useful. This removes them.

[archiveofourown.org]
exclude_metadata_pre:
 freeformtags,genre==Other Additional Tags to Be Added
 warnings==Creator Chose Not To Use Archive Warnings
 warnings==No Archive Warnings Apply

Generic cleanup

Normalizing the data a bit so that filtering actually works.

category=> (- All Media Types|- Fandom|\(Movies\)|\(Movie [0-9]+\)|\(Comics\)|\(TV\))$=>
characters=>\(mentions of\) =>
characters=> \([Ch]haracter\)=>
characters=> ?\((cameo|briefly|if you squint|sort of)\)=>
characters=> - Character=>
characters=>^Other mentions$=>

ships=>(.*)[/&](.*) \(?[Ff]riendship(?: only)\)?=>\1 & \2
ships=> - Relationship=>

No one has ever said 'I'm looking for a story with exactly one OC, but no more!'

ships_CHARS,characters=>^OC(s|)$=>Original Character
ships_CHARS,characters=>^OFC(s|)$=>Original Female Character
ships_CHARS,characters=>^OMC(s|)$=>Original Male Character
ships_CHARS,characters=>^Original (.*)Character(\(s\)|s|)$=>Original \1Character

Normalizing content ratings

Two examples, one using MPAA ratings, the second using FR ratings (created on Twisting the Hellmouth and used on various websites; modified by me to sort properly by replacing "FR7" with "FR07").

For MPAA ratings:

[defaults]
add_to_replace_metadata:
 rating=>^15$=>PG-13
 rating=>^Adult Only$=>NC-17
 rating=>^Everyone$=>G
 rating=>^Explicit$=>NC-17
 rating=>^FR7$=>G
 rating=>^FR13$=>PG
 rating=>^FR15$=>PG-13
 rating=>^FR18$=>R
 rating=>^FR21$=>NC-17
 rating=>^G - General Audiences$=>G
 rating=>^General Audiences$=>G
 rating=>^K$=>G
 rating=>^K\+$=>PG
 rating=>^M$=>R
 rating=>^Mature$=>R
 rating=>^NC-17 - No One 17 and Under Admitted$=>NC-17
 rating=>^Not Rated$=>Unrated
 rating=>^PG - Parental Guidance Suggested$=>PG
 rating=>^PG-13 - Parents Strongly Cautioned$=>PG-13
 rating=>^R - Restricted$=>R
 rating=>^T$=>PG-13
 rating=>^Teen And Up Audiences$=>PG-13
 rating=>^Teens \+$=>PG-13
 rating=>^Teens$=>PG-13
 rating=>^Young Teens$=>PG
 rating=>^X - Adult: No readers under 18\. Contains Graphic Adult Themes/Extreme violence\.$=>NC-17
 rating=>^$=>Unrated

For FR ratings:

[defaults]
add_to_replace_metadata:
 rating=>^FR7$=>FR07
 rating=>^G$=>FR07
 rating=>^PG$=>FR13
 rating=>^PG-13$=>FR15
 rating=>^R$=>FR18
 rating=>^NC-17$=>FR21
 rating=>^15$=>FR15
 rating=>^Adult Only$=>FR21
 rating=>^Everyone$=>FR07
 rating=>^Explicit$=>FR21
 rating=>^G - General Audiences$=>FR07
 rating=>^General Audiences$=>FR07
 rating=>^K$=>FR07
 rating=>^K\+$=>FR13
 rating=>^M$=>FR18
 rating=>^Mature$=>FR18
 rating=>^NC-17 - No One 17 and Under Admitted$=>FR21
 rating=>^Not Rated$=>Unrated
 rating=>^$=>Unrated
 rating=>^PG - Parental Guidance Suggested$=>FR13
 rating=>^PG-13 - Parents Strongly Cautioned$=>FR15
 rating=>^R - Restricted$=>FR18
 rating=>^T$=>FR15
 rating=>^Teen And Up Audiences$=>FR15
 rating=>^Teens \+$=>FR15
 rating=>^Teens$=>FR15
 rating=>^Young Teens$=>FR13
 rating=>^X - Adult: No readers under 18\. Contains Graphic Adult Themes/Extreme violence\.$=>FR21

Removing redundant character entries

Some fandoms have characters of indeterminate gender (e.g. player characters in video games), and authors sometimes add both a general and gender-specific entry.

[defaults]
 exclude_metadata_pre:
 ## Removes "CharacterName" if Male or Female CharacterName is already present.
 characters=~^CharacterName&&characters=~^(Male|Female) CharacterName
Clone this wiki locally