[GUI Plugin] FanFicFare

[JimmXinu]

Not that I'm aware of.

I would look at:

• Your include_subject_tags setting
• 'New Only' for Tags checkbox (FFF config>Standard Columns tab)
• 'Update Calibre Metadata' checkbox on each download, or Default checkbox for it on FFF config>General tab)

[estherflails]

Originally Posted by JimmXinu

Nope.

I copied your file, changed make_linkhtml_entries: to add_to_make_linkhtml_entries:, and it worked.

At least for titlepage_entries. I don't have a collections custom column.

Thank you for the help, I figured out the what was causing the issue, if not the why 😅 I use a slightly modified version of this plugin and a bit of code that really shouldn't have affected anything... affected some stuff. I removed it and it works now.

[criscros]

Originally Posted by JimmXinu

• Your include_subject_tags setting
• 'New Only' for Tags checkbox (FFF config>Standard Columns tab)
• 'Update Calibre Metadata' checkbox on each download, or Default checkbox for it on FFF config>General tab)

[default]
include_subject_tags: extratags

New Only is checked although I tried it with it unchecked and no difference.

Update Metadata on each download is checked as is on the config/general tab.

I tried adding extratags_label:WebNovel and even changed it to FanFiction but no joy.

Strange how it just stopped working. I might try with a portable version of calibre to see if that works.
Thank!

[criscros]

Wow, my old personal.ini was full of stuff I don't remember putting in there. I used a clean new copy, added what I wanted and it works again. I've been using FFF for years, I guess a fresh start was needed.
Thanks!

[epicmusic42]

When updating metadata OR downloading fics from URLs, the fandom is populating as "FanFicFare v4.48.0" rather than the listed fandom. All of the fics I'm trying to update metadata on are listed on Ao3.

I have very little coding knowledge so don't have the first clue how to figure out what's causing this behaviour or how to fix it. The only changes I've made to the personal.ai are to add my browser cache path, uncomment is_adult:true, add_chapters:true, add instructions for using the browser cache copied from the browser cache instructions, uncomment always_login:true, and add my login info.

Any guidance on how I might be able to get FanFicFare to populate the fandom field with the fandom(s) specified on Ao3 would be greatly appreciated!

[JimmXinu]

Originally Posted by epicmusic42

When updating metadata OR downloading fics from URLs, the fandom is populating as "FanFicFare v4.48.0" rather than the listed fandom. All of the fics I'm trying to update metadata on are listed on Ao3.

That's the version("Downloader Version") metadata, which is one of the usual standard metadata entries.

I would speculate that either you accidentally copied some in personal.ini with version, or clicked on it in the Custom Columns tab for that column.

For historical reasons, FFF uses category as the 'fandom' metadata entry. Go to the FFF config > Custom Columns tab for your fandoms column and select Category. That's the easiest way to get 'fandom' into a custom fandom column.

[mijkala]

Originally Posted by JimmXinu

include_in_tags:au

include_in_tags does nothing, FFF doesn't have a metadata entry named tags. (As standard--it can be defined for individual sites or by users.)

include_subject_tags:

The Calibre Tags column is treated special for historical reasons. The include_subject_tags setting controls what goes into Tags.

Do you know how I could tweak this to add "crossover" to tags instead of fandom?

 add_category_when_multi_category: Crossover

I tried these, but then saw that include_in_tags does nothing

include_in_tags_when_multi_category:Crossover
include_in_subject_tags_when_multi_category:Crossover

[JimmXinu]

Originally Posted by mijkala

I tried these, but then saw that include_in_tags does nothing

include_in_tags_when_multi_category:Crossover
include_in_subject_tags_when_multi_category:Crossover

Yeah, you're just making up settings now. Notice how they didn't turn blue in the color coded editor? Not valid.

These are the only two valid versions:

## Add this to *genre* if there's more than one category.  Applied
## *before* genre replace_metadata/include/exclude_metadata
#add_genre_when_multi_category: Crossover

## Add this category if there's more than one category(before this is added).
## Applied *after* category replace_metadata/include/exclude_metadata
#add_category_when_multi_category: Crossover

Originally Posted by mijkala

Do you know how I could tweak this to add "crossover" to tags instead of fandom?

 add_category_when_multi_category: Crossover

By default, genre and category are both included in include_subject_tags, which is the setting that controls what goes in Calibre's Tags column. Using either of the above when_multi_category settings should work.

If you've removed both genre and category from include_subject_tags, it's more difficult. I'm not typing that up again if it's not needed.

[mijkala]

Originally Posted by JimmXinu

Yeah, you're just making up settings now. Notice how they didn't turn blue in the color coded editor? Not valid.

These are the only two valid versions:

## Add this to *genre* if there's more than one category.  Applied
## *before* genre replace_metadata/include/exclude_metadata
#add_genre_when_multi_category: Crossover

## Add this category if there's more than one category(before this is added).
## Applied *after* category replace_metadata/include/exclude_metadata
#add_category_when_multi_category: Crossover

By default, genre and category are both included in include_subject_tags, which is the setting that controls what goes in Calibre's Tags column. Using either of the above when_multi_category settings should work.

If you've removed both genre and category from include_subject_tags, it's more difficult. I'm not typing that up again if it's not needed.

Ooh good point about the colors (I've only pieced together coding just for this so I actually have no concept of basic things)

Looks like I don't have either genre or category included in include_subject_tags as I have custom columns those get sorted into, and I've actually managed to wrangle the tags into something more cohesive and usable for my Kobo + Collections, so I'd like to keep it that way. Do you have any recommendations of what to do instead as a work around for this?

If I have to manually add it, I'm not too fussed. I also had some issues with the add_to_include_subject_tags:,oneshot not working. I've included my personal.ini

Spoiler:

[defaults]
## [defaults] section applies to all formats and sites but may be
## overridden at several levels. See
## https://github.com/JimmXinu/FanFicFare/wiki/INI-File for more
## details.
## Some sites also require the user to confirm they are adult for
## adult content. Uncomment by removing '#' in front of is_adult.
## Don't like the numbers at the start of chapter titles on some
## sites? You can use strip_chapter_numbers to strip them off. Just
## want to make them all look the same? Strip them off, then add them
## back on with add_chapter_numbers. Don't like the way it strips
## numbers or adds them back? See chapter_title_strip_pattern and
## chapter_title_add_pattern in defaults.ini.
#strip_chapter_numbers:true
#add_chapter_numbers:true

browser_cache_path:/Users****
## set up so can still grab from ff.net

### [Cover Wrangling] ###
generate_cover_settings:
## Cover found during download
 ${cover_image}=>(specific|first|force|default)=>Default Art Cover
## No cover found during download
# ${cover_image}=>^(|old)$=>Gen Book
# ${category} => Fandom => Cover name 
##if I choose to make individual default covers for fandoms 
##source:https://www.mobileread.com/forums/showpost.php?p=3856006&postcount=3484

##this seemed to sort our the forced alphabetizing tags issue
always_overwrite: true
keep_in_order_fandoms:true
keep_in_order_ships:true
keep_in_order_ratings:true
keep_in_order_warnings:true
keep_in_order_ao3categories:true
keep_in_order_characters:true
keep_in_order_freeformtags:true
keep_in_order_freefromtags:true
keep_in_order_genre:true
keep_in_order_categories:true
keep_in_order_series:true 
keep_in_order_collections:true
keep_in_order_dateRange:true

### [Misc. Default Settings] ###
add_category_when_multi_category:Crossover 
## fandom=category; genre= category; 
##source:https://www.mobileread.com/forums/showpost.php?p=4446332&postcount=110
##source:https://gist.github.com/8ullyMaguire/408263aa136345272b91ae44cf1eef55
remove_authorfootnotes_on_update:false

### [Date Formating] ###
datePublished_format:%%F
dateUpdated_format:%%F
## format = yyyy-mm-dd [2016-05-22]
dateCreated_format:%%d %%b %%Y %%R
## format = dd mm yyy hh:mm [02 Aug 2025 22:11]
dateRange_format:%%B %%d, %%Y
## format = M dd yyyy [September 02, 2015] - maybe done right -isn't working for now


[epub]
## Include images from img tags in the body and summary of stories.
## Images will be converted to jpg for size if possible. Images work
## in epub format only. To get mobi or other format with images,
## download as epub and use Calibre to convert.
## true by default, uncomment and set false to not include images.
include_images:true

## If set false, the summary will have all html stripped for safety.
## Both this and include_images must be true to get images in the
## summary.
## true by default, uncomment and set false to not keep summary html.
keep_summary_html:true

## If set true, and there isn't a specific cover image, the first
## image found in the story will be made the cover image. If
## keep_summary_html is true, images in the summary will be before any
## in chapters.
## true by default, uncomment and set false to turn off
make_firstimage_cover:true


###[Title Page Formatting Set-Up]###

titlepage_entry:<div style="text-indent:-1.5em; padding-left:1.5em; padding-right:1.5em;"> <b class="fff_tp_label" id="${id}_label">${label}:</b> <span class="fff_tp_value" id="${id}_value">${value}</span><br /></div>
add_to_output_css:
 body.fff_titlepage {
  font-size: 2.5vmax;
 }
 .fff_head_notes {
  margin-bottom: 10%%;
 }
#adds a small break between author notes + start of chapter
 .fff_foot_notes {
  margin-top: 10%%;
 }
#adds a small break between end of chapter + author foot notes 
 #calibre_cust_seriesdc_label {
  text-decoration: underline;
 }
 #calibre_cust_seriesdc_value {
  text-indent:0;
  padding-right: 2em;
 }
 #description_label {
  text-decoration: underline;
 }
 #description_value {
  text-indent:0;
  padding-right: 2em;
 }
 #bookmarksummary_value {
  font-style: italic;
 }
 #bookmarktags_value {
  font-style: italic;
 } 
 img {
  max-width: 100%%; height: auto; 
 }
## max-width came from https://www.reddit.com/r/Calibre/comments/jd7mbq/how_to_resize_images_to_fit_screen/
## I use any images found and this will help it from warping weird

[archiveofourown.org]
use_basic_cache:true
username:XXXXXXXX
password:XXXXXXXX
always_login:true
is_adult:true

## WORK AROUND FOUND YAY ##
#use_archiveofourown_gay:true
#use_archive_transformativeworks_org:true
##work aorund for the AO3 server issue - doesn't save my bookmark notes tho- hashed out as normal is working
##use one OR the other, not both 

slow_down_sleep_time:5
##from FFF calibrate-> personal.ini tab -> defaults.ini-> view defaults

##Includes workskin
use_workskin:true


### [EXTRA VALID ENTRIES] ###

extra_valid_entries:fandoms, freeformtags, freefromtags, ao3categories, comments, chapterslashtotal, chapterstotal, kudos, hits, bookmarks, collections, byline, bookmarked, bookmarktags, bookmarksummary, bookmarkprivate, bookmarkrec, subscribed, markedforlater, restricted, collections, collectionsHTML, collectionsUrl, creatorstyle, markedforlater,
 inspired, inspiredUrl, inspiredHTML, endnotes, endnotesUrl, endnotesHTML, allseriesHTML, series00, series01, series02, series03, series00Url, series01Url, series02Url, series03Url, series00HTML, series01HTML, series02HTML, series03HTML, 
##from google doc --> https://docs.google.com/document/d/192D1NFSXG50NmbqyxNoU1-K60fEcQO8tUijwNA_m8Hg/edit?tab=t.0

add_to_extra_valid_entries:, oneshot, kcp, dateRange, seriesdc, specs, series04, series05, series06, series07, series08, series09,  series10, series11, series12, series13, series14, series15, series16, series17, series18, series19, series20, series04Url, series05Url, series06Url, series07Url, series08Url, series09Url, series10Url, series11Url, series12Url, series012rl, series13Url, series14Url, series15Url, series16Url, series17Url, series18Url, series19Url, series20Url, series04HTML, series05HTML, series06HTML, series07HTML, series08HTML, series09HTML, series10HTML, series11HTML, series12HTML, series13HTML, series14HTML, series15HTML, series16HTML, series17HTML, series18HTML, series19HTML, series20HTML 
## Adds the tag "oneshot" to 1-chapter completed stories
include_in_specs:rating, warnings, ao3categories, fandoms, ships, freeformtags 
include_in_dateRange: datePublished, dateUpdated 
include_in_kcp:ships
##&bull is the • symbol I want - used on https://www.mobileread.com/forums/showpost.php?p=4301832&postcount=7
##I give up on it for now

make_linkhtml_entries:series00,series01,series02,series03,collections,
##source:https://www.mobileread.com/forums/showpost.php?p=4446332&postcount=110
##Needed to make Series on Titlepage linked

add_to_make_linkhtml_entries:,series04,series05,series06,series07,series08,series09,series10,series11,series12,series13,series14,series15,series16,series17,series18,series19,series20,

include_subject_tags:freeformtags,
include_in_category:fandoms
add_to_include_subject_tags:,oneshot

### [CUSTOM COLUMN SEETTINGS] ###

custom_columns_settings:
 specs=>#specs
 characters=>#characters 
 bookmarksummary=>#bookmarknotes
 series=>#multiseries,a
 collections=>#collections
 series00=>#multiseries,a
 series01=>#multiseries,a
 series02=>#multiseries,a
 series03=>#multiseries,a
 series04=>#multiseries,a
 series05=>#multiseries,a
 series06=>#multiseries,a
 series07=>#multiseries,a
 series08=>#multiseries,a
 series09=>#multiseries,a
 series10=>#multiseries,a
 series11=>#multiseries,a
 series12=>#multiseries,a
 series13=>#multiseries,a
 series14=>#multiseries,a
 series15=>#multiseries,a
 series16=>#multiseries,a
 series17=>#multiseries,a
 series18=>#multiseries,a
 series19=>#multiseries,a
 series20=>#multiseries,a

add_to_custom_columns_settings:
 freeformtags=>#ao3_additional_tags
 freefromtags=>#ao3_additional_tags
 fandoms=>#fandom,n
 relationship=>#ships
 numWords=>#words
 bookmarked=>#bookmarked
 dateRange=>#date_range
 dateUpdated=>#ao3_last_updated
 seriesdedc=>#seriesdc
 collections=>#collections
 kcp=>#kcp
## There are three parts, the entry name, then the label of the calibre custom column,
## then (optionally) a mode'.  'r' to Replace any existing values, 'a' to Add to existing
## value (use with tag-like columns), and 'n' for setting on New books only.  (Default is 'r'.)


### [LABELING] ###

fandoms_label:Fandoms
ships_label:Relationships
freeformtags_label:Additional Tags
freefromtags_label:Freeform Tags
chapterslashtotal_label:Chapters
chapterstotal_label:Total Chapters
ao3categories_label:Categories
comments_label:Comments
kudos_label:Kudos
hits_label:Hits
collections_label:Collections
dateRange_label:Date Range
dateUpdated_label: Updated :
site_label: Site
bookmarks_label:Bookmarks
## Tags & Summary from *your* bookmark on the story.
## Only collected if always_login:true
bookmarked_label:I Bookmarked Story
bookmarktags_label:Bookmark Tags
bookmarksummary_label:Bookmark Notes
bookmarkprivate_label:My Bookmark Private
bookmarkrec_label:My Bookmark Rec
markedforlater_label:I Marked for Later
subscribed_label:I Subscribed
restricted_label:Restricted to Registered Users
seriesdc_label: Series Description
calibre_cust_seriesdc_label:Series Description
description_label: Summary
series00HTML_label:Series
series01HTML_label:Additional Series
series02HTML_label:Additional Series
series03HTML_label:Additional Series
series04HTML_label:Additional Series 
series05HTML_label:Additional Series 
series06HTML_label:Additional Series 
series07HTML_label:Additional Series 
series08HTML_label:Additional Series 
series09HTML_label:Additional Series 
series10HTML_label:Additional Series 
series11HTML_label:Additional Series 
series12HTML_label:Additional Series 
series13HTML_label:Additional Series 
series14HTML_label:Additional Series 
series15HTML_label:Additional Series 
series16HTML_label:Additional Series 
series17HTML_label:Additional Series 
series18HTML_label:Additional Series 
series19HTML_label:Additional Series 
series20HTML_label:Additional Series  

# Date range formatting (combines publish/update dates intelligently)
 dateRange_LIST=>([^\s]+)\s+(\d{1,2})\,\s+(\d{4})\,\s([^\s]+)\s+(\d{1,2})\,\s+(\d{4})=>\1 \2, \3-\4 \5, \6   # Different dates
 dateRange_LIST=>([^\s]+)\s+(\d{1,2})\,\s+(\d{4})-([^\s]+)\s+(\d{1,2})\,\s+\3=>\1 \2-\4 \5, \3               # Same year
 dateRange_LIST=>([^\s]+)\s+(\d{1,2})-\1\s+(\d{1,2})\,\s+(\d{4})=>\1 \2-\3, \4                              # Same month


### [META DATA MANAGEMENT] ###

anthology_title_pattern:${title} Anthology
## Uses a python template substitution.  The ${title} is the default
## title of a new anthology, <series name> in the case of a series, or
## the first book title otherwise.  This is only applied to new
## anthologies.
anthology_tags:Anthology
## Add tag(s) for anthology (series) books.  Set to empty to not add
## any anthology tags.

include_metadata_pre:
 kcp=~/

replace_metadata:
 collections=>&amp;=>+
## makes sure collections that use & don't get seperated into different collections
##source:https://github.com/JimmXinu/FanFicFare/wiki/MetadataManagement
 fandoms=>\(?(- Fandom|- Movieverse|Video Games?)\)?$=>
 fandoms=>No Fandom=>Original Work
##freeform tags/additional tags
 freeformtags=>^(Fanfiction)$=>
##source: https://docs.google.com/document/d/192D1NFSXG50NmbqyxNoU1-K60fEcQO8tUijwNA_m8Hg/edit?tab=t.0
 authorUrl=>(/users/orphan_account)/pseuds/.*$=>\1
## Due to a bug with Archive of Our Own, the link to orphan_account
## just leads to a 404 page. this replaces orphan_account author links with one that works.source: defaults.ini
##deleted large section of this so that original informaiton is true on title pages
 kcp=>(?i)background|minor| - relationship|preslash|pre-slash|pre-relationship|pre relationship=>
 kcp=>(?i)pre-|mentioned|if you squint|implied|past=>
#misc
 kcp=>Danny Fenton/Jason Todd=>DeadOnMain
 kcp=>Dean Winchester/Sam Winchester=>wincest
 kcp=>Sokka/Zuko \(Avatar\)=>zukka
 kcp=>Merlin/Arthur Pendragon (Merlin)=>merthur
 kcp=>Merlin/Arthur Pendragon=>merthur
 kcp=>Hatake Kakashi/Uzumaki Naruto=>KakaNaru
 kcp=>Hatake Kakashi/Maito Gai \| Might Guy=>MightyIchi
 kcp=>Yassen Gregorovich/Alex Rider=>yalex
 kcp=>Brian O'Conner/Dominic Toretto=>bridom
 kcp=>Chris Argent/Peter Hale/Stiles Stilinski=>stetopher
 kcp=>Peter Hale/Stiles Stilinski=>steter
 kcp=>Jasper Hale/Bella Swan=>jaspella
 kcp=>Jasper Hale/Peter/Bella Swan=>the whitlocks
 kcp=>Baby \| Miles/Buddy \| Jason van Horn/Darling \| Monica=>ATL gang
 kcp=>Edward Elric/Roy Mustang=>MetalFlame
 kcp=>Jinu/Rumi \(KPop Demon Hunters\)=>rujinu
 kcp=>Abby/Jinu \(KPop Demon Hunters\)=>jibby
 kcp=>Abby/Baby/Jinu/Mystery/Romance \(KPop Demon Hunters\)=>SajaBoys
 kcp=>Klaus Hargreeves/David "Dave" Katz=>Goodbye Tragedy
 kcp=>Dave/Klaus Hargreeves=>Goodbye Tragedy
 kcp=>Quentin Coldwater/Eliot Waugh=>queliot
 kcp=>Quentin Coldwater/Margo Hanson/Eliot Waugh=>marqueliot
 kcp=>Eskel/Geralt z Rivii \| Geralt of Rivia/Jaskier \| Dandelion=>geraskel
 kcp=>Geralt z Rivii \| Geralt of Rivia/Jaskier \| Dandelion=>geraskier
 kcp=>Geralt z Rivii \| Geralt of Rivia/Jaskier \| Dandelion/Yennefer z Vengerbergu \| Yennefer of Vengerberg=>geraskefer
 kcp=>Apollo/Percy Jackson=>SeaLight
 kcp=>Luke Castellan/Percy Jackson=>StormBetrayer
#MCU
 kcp=>Peter Parker/Wade Wilson=>spideypool
 kcp=>Bruce Banner/Tony Stark=>ScienceBros
 kcp=>James "Bucky" Barnes/Steve Rogers=>stucky
 kcp=>Steve Rogers/Tony Stark=>IronCap
 kcp=>James "Bucky" Barnes/Tony Stark=>IronWinter
 kcp=>James "Bucky" Barnes/Steve Rogers/Tony Stark=>stuckony
 kcp=>Tony Stark/Jason Todd=>IronHood
 kcp=>James "Bucky" Barnes/Tony Stark/Jason Todd=>WinterIronHood
 kcp=>Steven Grant/Marc Spector=>La lune&smp;I
 kcp=>Harry Osborn/Peter Parker=>parksborn
 kcp=>Matt Murdock/Peter Parker=>SpideyDevil
#DCU
 kcp=>Barry Allen/Leonard Snart=>ColdFlash
 kcp=>Barry Allen/Mick Rory/Leonard Snart=>ColdFlashWave
 kcp=>Barry Allen/Mick Rory=>FlashWave
 kcp=>Mick Rory/Leonard Snart=>ColdWave
 kcp=>Barry Allen/Oliver Queen=>olivarry
 kcp=>Bernard Dowd/Tim Drake/Kon-El \| Conner Kent=>timbercon
 kcp=>Clark Kent/Lex Luthor=>clex
 kcp=>Dick Grayson/Jason Todd=>jaydick
 kcp=>Dick Grayson/Slade Wilson=>sladick
#Harry Potter
 kcp=>Draco Malfoy/Harry Potter=>drarry
 kcp=>Theodore Nott/Harry Potter=>notter
 kcp=>Marcus Flint/Harry Potter=>harflint
 kcp=>Percy Weasley/Oliver Wood=>Bedknobs&amp;Broomsticks
 kcp=>Harry Potter/Tom Riddle=>SoulSeeker
 kcp=>Harry Potter/Tom Riddle \| Voldemort=>SoulSeeker
 kcp=>Harry Potter/Severus Snape=>IllegalSubstances
 kcp=>Sirius Black/Remus Lupin=>WolfStar
 kcp=>Harry Potter/Charlie Weasley=>DragonScars
 kcp=>Harry Potter/Fred Weasley/George Weasley=>WheezingSnitches
 kcp=>Harry Potter/Blaise Zabini=>PotentSerpent
 kcp=>Fred Weasley/George Weasley=>mirror

add_to_replace_metadata:
 chapterstotal=>^([0-9])+/(.+)$=>\2 
## chapterslashtotal contains 1/3 or 1/1 or 3/? etc as reported by AO3.
## chapterstotal is just the total chapters part after the /
include_in_chapterstotal:chapterslashtotal.NOREPL
##source: https://www.mobileread.com/forums/showpost.php?p=4446332&postcount=110

#extratags: Fanfiction
exclude_metadata_pre:
 tags==Fanfiction
 freeformtags==Fanfiction
exclude_metadata_post:
 tags==Fanfiction
 freeformtags==Fanfiction



### [TITLE PAGE Set-Up] ###

titlepage_entries:seriesHTML, series01HTML,series02HTML, series03HTML, <hr />, fandoms, ships, rating, warnings, ao3categories, characters,freeformtags, bookmarktags, </div>, <hr />,status, numWords, chapterslashtotal, <hr />, calibre_cust_seriesdc, description, bookmarksummary, <hr />, site, datePublished, dateUpdated, <br />, dateCreated,
##QQQ ## why do I keep having an annoying space between the summary and the text of the fic summary??
##source: https://docs.google.com/document/d/192D1NFSXG50NmbqyxNoU1-K60fEcQO8tUijwNA_m8Hg/edit?tab=t.0

extra_titlepage_entries:series04HTML,series05HTML,series06HTML,series07HTML,series08HTML,series09HTML,series10HTML,series11HTML,series12HTML,series13HTML,series14HTML,series15HTML,series16HTML,series17HTML,series18HTML,series19HTML,series20HTML

##formatting - original/keep
titlepage_end:
# <dl class="stats">
# </dl>
 <hr />
 <div class="tag-summary-content" style="margin-top: 10px;">
  <div style="text-align: center; font-weight: bold; margin-bottom: 5px;">Stats:</div>
#  <hr style="border: .85px dashed; width: 80%%; margin: 10px auto;" />
   <div class="inline" style="display: flex; justify-content: space-between; margin-bottom: 8px;">
     <span>Hits: ${hits}</span>
     <span>Kudos: ${kudos}</span>
     <span>Comments: ${comments}</span>
     <span>Bookmarks: ${bookmarks}</span>
   </div>
  <hr style="border: .85px dotted; width: 80%%; margin: 10px auto;" />
   <div class="inline" style="display: flex; justify-content: space-between; margin-bottom: 8px;">
     <span>Collections: ${collectionsHTML}</span>
   </div>
 </body>
 </html>

### [original code for refrencing/notes] ###

## If regex special characters appear in the string you're trying to match, you need to escape
## them by putting a \ before them. Those characters are: [\^$.|?*+()


## making code/title page pretty ## ref: https://www.mobileread.com/forums/showpost.php?p=4489895&postcount=10366
## metadata
##titlepage_end:
## <dl class="stats">
## </dl>
## </dl>
## <hr style="border: .75px solid #999; width: 90%%; margin: 10px auto;" />
## <br />
## <div class="tag-summary-content" style="margin-top: 10px;">
## <div style="text-align: left; font-weight: bold; margin-bottom: 5px;">Stats:</div>
##   <div class="inline" style="display: flex; justify-content: space-between; margin-bottom: 8px;">
##     <span>Published: ${datePublished}</span>
##     <span>Updated: ${dateUpdated}</span>
##     <span>Status: ${status}</span>
##   </div>
##   <div class="inline" style="display: flex; justify-content: space-between; margin-bottom: 8px;">
##     <span>Kudos: ${kudos}</span>
##     <span>Hits: ${hits}</span>
##     <span>Bookmarks: ${bookmarks}</span>
##   </div>
## </body>
## </html>

##replace_metadata:
## category=>^AAA$=>BBB
##Where AAA is the fandom you want to change and BBB is the one you want it to turn into.
##Also make sure there is a space in front of the word 'category' and it should turn green 
##you will need to format it like this:
## category=>^鬼滅の刃 \| Demon Slayer: Kimetsu no Yaiba \(Anime\)$=>Demon Slayer
##source: https://www.reddit.com/r/Calibre/comments/1fhnxb2/how_to_automatic_merge_metadata_in_the_settings/



[www.fanfiction.net]
is_adult:true
username:XXXXXXXX
password:XXXXXXXX

use_browser_cache:true
use_browser_cache_only:true
open_pages_in_browser:true

tweak_fg_sleep:true
min_fg_sleep:4.0
max_fg_sleep:12.0
max_fg_sleep_at_downloads:4

datePublished_format:%%F
dateUpdated_format:%%F
dateCreated_format:%%d %%b %%Y %%R

cover_exclusion_regexp:(/imageu/|d_60_90\.jpg)
skip_author_cover:true

## ffnet used to have a tendency to send out update notices in email
## before all their servers were showing the update on the first
## chapter.  It generates another server request and doesn't seem to
## be needed lately, so now default it to off.
check_next_chapter:false

## ffnet sometimes doesn't update the metadata on the first chapter
## immediately.  meta_from_last_chapter:true will instruct the adapter
## to take the metadata from the last chapter instead of chapter 1.
## It can generate another server request and usually isn't necessary,
## so it defaults to off.
meta_from_last_chapter:false

# ============================================================================
## EXTRA VALID ENTRIES ##
# ============================================================================
extra_valid_entries:favs, reviews, follows, id, pairings, characters

add_to_extra_valid_entries:,oneshot, dateRange, seriesdc, specs
include_in_specs:rating, category, genre, forumtags

add_to_include_subject_tags:,oneshot
add_genre_when_multi_category: Crossover

custom_columns_settings:
 specs=>#specs
add_to_custom_columns_settings:
 category=>#fandom
 genre=>#ao3_additional_tags
 forumtags=>#ao3_additional_tags
 characters=>#characters 
 dateUpdated=>#ao3_last_updated
 pairings=>#ships
# datePublished=>

replace_metadata: 
## Ratings
 rating=>^(K|K\+)$=>General Audiences
 rating=>^Teen And Up Audiences$=>Teen and Up Audiences
 rating=>^T$=>Teen and Up Audiences
 rating=>^Mature$=>Mature Audiences
 rating=>^M$=>Mature Audiences

# ============================================================================
## [LABELING] ##
# ============================================================================
category_label:Fandoms
genre_label: Additional Tags
ships_label: Pairing
characters_label: Characters
pairing_label:Pairings
dateUpdated_label: Updated :
chapterslashtotal_label:Chapters
favs_label: Favs
follows_label: Follows
reviews_label: Reviews
publisher_label: Site
seriesdc_label: Series Description

# ============================================================================
## [Titlepage Set-Up] ##
# ============================================================================
titlepage_entries: seriesHTML,<hr />,category, ships, pairings, rating,characters,genre,<hr />,status,numWords, numChapters,  <hr />,calibre_cust_seriesdc,description, <hr />, publisher,id,datePublished,dateUpdated,<hr />, dateCreated,

## Default:
## ${id}, ${label}, ${value}
titlepage_entry:<b>${label}:</b> ${value}<br />

#include_tocpage:true
titlepage_entry:<b class="fff_tp_label" id="${id}_label">${label}:</b> <span class="fff_tp_value" id="${id}_value">${value}</span><br />
wide_titlepage_entries:

add_to_output_css:
 #calibre_cust_seriesdc_value {
    font-style:italic;
 }


## metadata
titlepage_end:
## <dl class="stats">
## </dl>
 </dl>
 <hr />
# <hr style="border: .75px solid #999; width: 90%%; margin: 10px auto;" />
 <div class="tag-summary-content" style="margin-top: 10px;">
 <div style="text-align: left; font-weight: bold; margin-bottom: 5px;">Stats:</div>
   <div class="inline" style="display: flex; justify-content: space-between; margin-bottom: 8px;">
     <span>Favs: ${favs}</span>
     <span>Follows: ${follows}</span>
     <span>Reviews: ${reviews}</span>
   </div>
 </body>
 </html>
## original ##
##titlepage_entries: seriesHTML,rating,warnings,category,ships,characters,genre,language,
## status,datePublished,dateUpdated,dateCreated,numChapters,numWords,publisher,description

[www.tthfanfic.org]
is_adult:true
## tth is a little unusual--it doesn't require user/pass, but the site
## keeps track of which chapters you've read and won't send another
## update until it thinks you're up to date. If you set
## username/password, FFF will login to download. Then the site
## thinks you're up to date.
#username:XXXXXXXX
#password:XXXXXXXX
## This section will override anything in the system defaults or other
## sections here.

[literotica.com]
use_basic_cache:true
slow_down_sleep_time:1
user_agent:
extra_valid_entries:eroticatags,averrating
eroticatags_label:Erotica Tags
averrating_label:Average Rating
extra_titlepage_entries:eroticatags,averrating

## Chapters can be in different categories. Default to not using all
## to be consistent with previous version.
chapter_categories_use_all: false

## For multiple chapter stories, attempt to clean up the chapter title. This will
## remove the story title and change "Ch. 01" to "Chapter 1", "Pt. 01" to "Part 1"
## or just use the text. If this can't be done, the full title is used.
clean_chapter_titles: false

## Some stories mistakenly include 'Ch' or 'Pt' at the end of the
## story title. Appears to be a site bug or common author error.  Copy
## these to your personal.ini (and uncomment) to correct.
#add_to_replace_metadata:
# title=> (Ch|Pt)$=>

## Add the chapter description at the start of each chapter.
description_in_chapter: false

## Author's stories are now hidden behind 'Show More' button.
## This option will attemph to fetch the stories.
fetch_stories_from_api: true

## Clear FanFiction from defaults, site is original fiction.
extratags:Erotica


[overrides]
## default varies by site. Set true here to force all sites to
## collect series.
#collect_series: true

continue_on_chapter_error:true
continue_on_chapter_error_try_limit:5
## mostly for ff.net, but saves chapters that DONT'T get errors, while notifiying if you do get errors
## (otherwise they all don't get saved?)
## source:https://www.mobileread.com/forums/showpost.php?p=4539496&postcount=11299


## If regex special characters appear in the string you're trying to match, you need to escape
## them by putting a \ before them. Those characters are: [\^$.|?*+()

[JimmXinu]

New Test Version Posted

2025-10-07
- OTW(AO3): Accept /chapter/999 URLs without /works/999 for #1258

[marshie250]

Hello everyone! No specific question here--just curious if anyone looks for the same things data-wise as I do and if so, how they collect it (especially if it's more efficient than how I do it). If you are not as obsessive, feel free to ignore!

I'm mostly concerned with tracking words read over the course of the year to see if I hit my reading goals. I track traditionally published books and fanfic in Calibre, which is handy. Word counts on tradpubs are easy, as it's just a simple count pages, but fanfic can be tricky with word counts changing with every update. First, I have an old-word-count column, which records the total word count the last time I marked a book as read (I use Action Chains for this). A separate column, #year-to-date, then takes this number and subtracts from it a year-start-word-count column, to return the total number of words read on that story that year:

#ytd
program:
(field ('#word')-field('#remaining')-field('#yearstart'))+(field ('#word')*field ('#reread'))

(I also have a column that I manually increase after a reread)

When a story updates, I have a third column, #remaining, which takes the new total word count and subtracts the old-word-count column to return the total number of words left to read in that book. This works well if a book updates more than once before I can read the new chapters, as the old-word-count column is not changed until the whole thing is marked as read.

#remaining
program:
if 'Yes' inlist field('#toread') then
	(field('#word')-field('#oldwords'))

fi

I then use Sum Column to tally that up every so often to see if I am on pace to meet 50-75k per day for the year.

I also like to track the pace at which a story updates, as I have a long TBR and it helps me figure out what to read next. That's a simple calculation in a column built from other columns:

#avpace
program:
if 'FanFiction' inlist field('tags') then
	if field('#chapters')==1 then
'0'
else
	if field('#chapters') then
	round(days_between(field('#updated'),field('pubdate'))/field('#chapters'))
	fi
fi
fi

which I then use to calculate when the next chapter might be posted (using 2 weeks as a default if there's only been one chapter):

#next
program:
	if 'In-Progress' inlist field('#status') then
		if field('#avpace')<1 then
			shorten(fractional_part(14-(days_between(today(), field('#updated')))),4,"",0)+(14-(days_between(today(), field('#updated')))-fractional_part(14-(days_between(today(), field('#updated')))))
			else
			shorten(fractional_part(field('#avpace')-(days_between(today(), field('#updated')))),4,"",0)+(field('#avpace')-(days_between(today(), field('#updated')))-fractional_part(field('#avpace')-(days_between(today(), field('#updated')))))				fi
	fi

I use the expected pace of a story to classify the status of the story (Extreme, Hiatus, Lapsed, and Updating) (with Completed and Dead not as a part of this equation, but also as classifications) (Names of the classifications had to be alphabetical as the tag browser automatically alphabetizes, and I wanted them to display in order).

#overdue
program:
	if 'In-Progress' inlist field('#status') then
		if field('#avpace')<1 then
		(((days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+15)))/(field('#avpace')+14)))
			else
			(((days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+1)))/(field('#avpace'))))
		fi
			fi

#HLevel
program:
	if 'Yes' inlist field('#toread') then 

				if 'Completed' inlist field('#status') then  
				'Completed'
				else
					if 'Dead' inlist field('#status') then  
					'Dead'
					else
						if 'In-Progress' inlist field('#status') then  
							if field('#avpace')<1 then
								if (days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+15)))/(field('#avpace')+14)<2 then
								"Updating"
								else
									if	(days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+15)))/(field('#avpace')+14)<5 then
									"Lapsed"
									else
										if (days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+15)))/(field('#avpace')+14)<10 then
										"Hiatus"
										else
										"Extreme"
										fi
									fi
								fi
							else
								if (days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+1)))/(field('#avpace'))<2 then
								"Updating"
								else
									if	(days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+1)))/(field('#avpace'))<5 then
									"Lapsed"
									else
										if	(days_between(today(), field('#updated'))-(days_between(today(), field('#updated'))/(field('#avpace')+1)))/(field('#avpace'))<10 then
										"Hiatus"
										else
										"Extreme"
										fi
									fi			
								fi
							fi
						fi
					
				fi
			fi
	fi

I can then calculate how often to check for updates (in case I missed subscribing to something), or how often to pull in updated metadata:

#update
program:
if 'FanFiction' inlist field('tags') then
if 'Update' inlist field('#errors') then
'Anthology Update'
else
	if days_between(today(), field('#lastchecked'))-1>0 then							
		if days_between(today(), field('#lastchecked'))-62>=0 then
			if 'Anthology' inlist field('tags') then
			'Anthology Update'
			else
			'Update'
			fi	
		else
			if 'Completed' inlist field('#status') then	
				if days_between(today(), field('#lastchecked'))-7>=0 then				
					if days_between(today(), field('#updated'))-7>=0 then		
						if 29-days_between(today(), field('#updated'))>=0 then				
							if 'Anthology' inlist field('tags') then
							'Anthology Update'
							else
							'Update'
							fi						
						fi
					fi
				fi
			else
				if 'Yes' inlist field('#approved') then		
				''
				else
					if (days_between(today(), field('#lastchecked')))-((days_between(today(), field('#updated'))/(field('#avpace')+2))+2+field('#avpace'))>=0 then
						if 'Anthology' inlist field('tags') then
						'Anthology Update'
						else
						'Update'
						fi
					else
						if 'Updating' inlist field('#hiatuslevel') then
							if (days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue'))))-(fractional_part(days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue')))))))>0 then
								if (days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue'))))-(fractional_part(days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue')))))))<2 then
									if 'Anthology' inlist field('tags') then
									'Anthology Update'
									else
									'Update'
									fi
								fi
							else
								if 'Lapsed' inlist field('#hiatuslevel') then
									if (days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue'))))-(fractional_part(days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue')))))))>0 then
										if (days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue'))))-(fractional_part(days_between(today(),field('#updated'))-(field('#avpace')*((field('#overdue'))-fractional_part(field('#overdue')))))))<2 then
											if 'Anthology' inlist field('tags') then
											'Anthology Update'
											else
											'Update'
											fi
										fi
									fi
								fi
							fi
						fi
					fi
				fi
			fi
		fi
	else							
		if field('#lastchecked') then						
			if days_between(today(), field('date'))-62>=0 then					
			'Meta'					
			else					
				if days_between(today(), field('date'))-7>=0 then		
					if days_between(today(), field('#updated'))-7>=0 then	
						if 29-days_between(today(), field('#updated'))>=0 then
						'Meta'
						fi
					fi	
				fi				
			fi					
		fi						
	fi																
fi
fi

If a story has also indicated an expected total of chapters, I like to calculate how long until the story is expected to be finished:

#expchap (yes there is a spelling error in this one but it was too entrenched by the time I noticed it)
program:
if '\?' inlist field('#chaptotal') then
	''
else
field('#exectedchaps')
fi

#completiondate
program:
if 'In-Progress' inlist field('#status') then
	if field('#expchap')>=1 then
	if field('#expchap')-field('#chapters')>=1 then
		if field('#avpace')>0 then
			if field('#overdue')>=1 then
			(field('#expchap')-(field('#chapters')+1))*(days_between(today(),field('pubdate'))/(field('#chapters')+1))
			else
			(field('#expchap')-field('#chapters'))*field('#avpace')-(fractional_part(field('#overdue'))*field('#avpace'))
			fi
		else
((field('#expchap')-(field('#chapters')+1))*(days_between(today(),field('pubdate'))/(field('#chapters')+1)))-(fractional_part(field('#overdue'))*(days_between(today(),field('pubdate'))/(field('#chapters')+1)))		
fi
fi
fi
fi

I also occasionally go onto the AO3 page for my fandoms and sort by kudos, then do a little math to calculate the top 1% and 10% of stories in the fandom (not to influence what I read, but just out of curiosity) and then do a column like this:

#Rank
program: 
if and('XXXXXX' inlist field('#fandom'),field('#kudos') >=780) then '1%' else
if and('XXXXXX' inlist field('#fandom'),field('#kudos') >=648) then '10%' else

Things I'm currently tinkering with: adding chapter updated dates and word counts to the html of each chapter (maybe using CustomOutputs?)--I don't want it displayed while reading, but I recently accidentally marked my entire library as read and it was a pain to recalculate everything. Would have been nice to be able to use that info.

Also, working on the Subscribed column--I only have it partially set up and can't remember why I stopped!

Ideally, it would be nice to mark if I left kudos/comments (even if only on a single chapter, as I imagine it would be confusing to see what chapters I left a comment on and which ones I missed).

Is any of this necessary? No. Did I know what I was doing when I set it up? Not really. I just like the challenge. But as I said, if you are collecting or calculating things I am not, or are doing something similar in a better way, I'd love to know!

[frenchtoast]

Hello! Very sorry if this has been posted before. But for the life of me I can't seem to find it anywhere. I'm using a Kobo Libra. Is there a way to *only* send a new chapter of a fic to the device? I keep having to remove the book from the device then sending it back with the new chapter. But it removes all the bookmarks and annotations! Thanks so much in advance!

[marshie250]

Originally Posted by frenchtoast

Hello! Very sorry if this has been posted before. But for the life of me I can't seem to find it anywhere. I'm using a Kobo Libra. Is there a way to *only* send a new chapter of a fic to the device? I keep having to remove the book from the device then sending it back with the new chapter. But it removes all the bookmarks and annotations! Thanks so much in advance!

Do you have the Kobo Utilities plugin? If so, go to Configure driver>Collections, covers, & uploads.

Make sure "Do not treat replacements as new books" is checked.

After syncing the files with the new chapters, you may also need to select those books and select Update ToC from the Kobo Utilities menu in order to see the new chapters on your Kobo.

[JimmXinu]

Kobo's software is not designed to have books change.

Updating books in Kobo is a several step process and needs the Kobo Utilities plugin to update ToC as a separate step from sending updated books to the device. For some metadata updates, the standard procedure is to connect, send, disconnect (for Kobo to import), then reconnect again to update those metadata. They have much expertise in Kobo issues in that thread.

(I found it so cumbersome that I switched to using KOReader on Kobo instead and wrote my own glue code in both KOReader and Calibre. I've documented what I did here, but I'm not at this point supporting it for other users.)

[ownedbycats]

Originally Posted by frenchtoast

Hello! Very sorry if this has been posted before. But for the life of me I can't seem to find it anywhere. I'm using a Kobo Libra. Is there a way to *only* send a new chapter of a fic to the device? I keep having to remove the book from the device then sending it back with the new chapter. But it removes all the bookmarks and annotations! Thanks so much in advance!

https://github.com/JimmXinu/FanFicFa...d-fics-to-kobo