[GUI Plugin] FanFicFare

[ownedbycats]

https://github.com/JimmXinu/FanFicFa...ive-of-our-own

use_archiveofourown_gay:true

It usually clears up the next day for me.

[hanjisung]

Thank you ever so much for your plugin!

Is there a way to 'lock' in the author, or block just the author from being updated during 'Update Existing FanFiction Books?'

I like retaining older author names, and marking as they shift their names, for example: authorname > orphan_account. So I wish not to update them. (For instance, if I add a new custom column, and want to grab the metadata from AO3 in bulk, then I have to update existing books and do 'Update Calibre Metadata from Web Site' right?)

[ownedbycats]

Originally Posted by hanjisung

Thank you ever so much for your plugin!

Is there a way to 'lock' in the author, or block just the author from being updated during 'Update Existing FanFiction Books?'

I like retaining older author names, and marking as they shift their names, for example: authorname > orphan_account. So I wish not to update them. (For instance, if I add a new custom column, and want to grab the metadata from AO3 in bulk, then I have to update existing books and do 'Update Calibre Metadata from Web Site' right?)

Use a replace_metadata on author.

[hanjisung]

Originally Posted by ownedbycats

Use a replace_metadata on author.

Can you extrapolate a little? I have author mapper, but I'm not understanding what I would need to input/select, sorry.

When/if you explain, can you also explain what the exact meaning of what I'm selecting is?

Or do you not mean utilizing the mapper? (On the mapper I don't see how this would work so maybe you don't mean this...)

[ownedbycats]

personal.ini:

[defaults]
replace_metadata: 
 author=>^Anonymous$=>Unknown
 author=>^orphan_account$=>Unknown

Alternately, a storyURL section. This also lets you use a match-any (.*)

[https://archiveofourown.org/works/000000]
add_to_replace_metadata:
 author=>^orphan_account$=>Username
 author=>^.*=>Username

[JimmXinu]

Originally Posted by hanjisung

Is there a way to 'lock' in the author, or block just the author from being updated during 'Update Existing FanFiction Books?'

FFF Config, on the 'Standard Columns' tab, check the 'New Only' checkbox for all the columns you want FFF to leave untouched.

[hanjisung]

Originally Posted by JimmXinu

FFF Config, on the 'Standard Columns' tab, check the 'New Only' checkbox for all the columns you want FFF to leave untouched.

Oh my god I swear I looked at that tab and must've glazed right over 'Authors:' somehow... Thank you so much!

[JimmXinu]

Skip Monthly Release?

Anybody think the 2 changes currently in the test version are worth doing the usual monthly release?

One change is a fix for a low-traffic site(adapter_fireflyfansnet) and the other is a rather technical change for which nobody's come back and said 'Yes, that helps' or 'No, don't do that'.

[applegaa]

Originally Posted by JimmXinu

Skip Monthly Release?

Anybody think the 2 changes currently in the test version are worth doing the usual monthly release?

One change is a fix for a low-traffic site(adapter_fireflyfansnet) and the other is a rather technical change for which nobody's come back and said 'Yes, that helps' or 'No, don't do that'.

I do like the limit, as I think it will be quite useful when a story on ScribbleHub is stubbed or I find a new story with a lot of chapters. Sorry I didn't comment on it sooner.

I don't know that it's worth an update, as I'm fine using the test version for another month.

- Andrew

[mijkala]

I've got my title page all set up how I like it, but am unsure how to add url/hyperlinks to collections so if I'm reading on my computer I can just click on it an open it. I saw another post about it and have added most of what it suggested, but because of how I have the end of my title page setup, whenever I try to use collecitionURL it doesn't work (screenshot below)

Here's my code below. The title page setup is near the bottom but I included everything in case something else needs to change. This is the fic I used as an example: https://archiveofourown.org/works/17...pters/42417584


Side note: anytime I log into mobileread to check this forum/get answers, the entire FanFicFare page is blank. Mobile read won't allow me to load anything on a forum that I've asked a question in while logged in, but all others work normally? I have to stay logged out to even look at the forum

Spoiler:

## This is an example of what your personal configuration might look
## like. Uncomment options by removing the '#' in front of them.

[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: XXXXX
## set up so can still grab from ff.net

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

##test- 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


[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;
 }
 #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;
 } 

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

## WORK AROUND FOUND YAY ##
#use_archiveofourown_gay:true
##work aorund for the AO3 server issue - doesn't save my bookmark notes tho- hashed out as normal is working

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, 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:,collectionUrl,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 
include_in_specs:rating, warnings, ao3categories, fandoms, ships, freeformtags, 
include_in_dateRange: datePublished, dateUpdated, 
##&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
add_to_make_linkhtml_entries:,series04,series05,series06,series07,series08,series09,series10,series11,series12,series13,series14,series15,series16,series17,series18,series19,series20, collectionsHTML

include_subject_tags:freeformtags,
include_in_category:fandoms

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
## [QQQ] ##
## could I add • to date range above?? - given up for making it pretty for now

## [CUSTOM COLUMN SEETTINGS] ##
custom_columns_settings:
 specs=>#specs
 characters=>#characters 
 bookmarksummary=>#bookmarknotes
 series=>#multiseries,a
 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:
 dateUpdated=>#ao3_last_updated
 freeformtags=>#ao3_additional_tags
 freefromtags=>#ao3_additional_tags
 numWords=>#words
 relationship=>#ships
 bookmarked=>#bookmarked
 fandoms=>#fandom,n
 dateRange=>#ao3_date
 seriesdedc=>#seriesdc
## 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
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
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  

##[META DATA MANAGEMENT] ##
add_category_when_multi_category: Crossover
##source:https://www.mobileread.com/forums/showpost.php?p=4446332&postcount=110
remove_authorfootnotes_on_update:false
replace_metadata:
##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

add_to_replace_metadata:
 chapterstotal=>^([0-9])+/(.+)$=>\2 
# diff dates 1pmonth 2pday 3pyear 4umonth 5uday 6uyear
 dateRange_LIST=>([^\s]+)\s+(\d{1,2}),\s+(\d{4}), ([^\s]+)\s+(\d{1,2}),\s+(\d{4})=>\1 \2,
 \3-\4 \5, \6
# same year 1 2 3 4 5
 dateRange_LIST=>([^\s]+)\s+(\d{1,2}),\s+(\d{4})-([^\s]+)\s+(\d{1,2}),\s+\3=>\1 \2-\4 \5, \3
# same month 1 2 3 4
 dateRange_LIST=>([^\s]+)\s+(\d{1,2})-\1\s+(\d{1,2}),\s+(\d{4})=>\1 \2-\3, \4
## 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

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

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

## 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_title_pattern:${title} Anthology

## Add tag(s) for anthology (series) books.  Set to empty to not add
## any anthology tags.
anthology_tags:Anthology


## [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: ${collections}</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/

[ownedbycats]

Originally Posted by mijkala

I've got my title page all set up how I like it, but am unsure how to add url/hyperlinks to collections so if I'm reading on my computer I can just click on it an open it. I saw another post about it and have added most of what it suggested, but because of how I have the end of my title page setup, whenever I try to use collecitionURL it doesn't work (screenshot below)

https://github.com/JimmXinu/FanFicFa...ive-of-our-own

Collection URL requires a version of FanFicFare released after April 4, 2023, which added the static include_in_* required for the placeholder (as FanFicFare cannot replace an empty entry).

[archiveofourown.org]
## This creates an 'collectionUrl' entry and adds a placeholder. I chose to use 'abc' for easy replacement (no escapes!).
add_to_extra_valid_entries:,collectionUrl
include_in_collectionUrl:"abc"

## Adds collectionURL to series.
include_in_seriesUrl:seriesUrl,collectionUrl

add_to_replace_metadata:
## Change the placeholder 'abcs' to collection urls using conditionals
## If you are using a collection name that has been modified by replace_metadata, make sure this goes below it.
 collectionUrl=>abc=>https://archiveofourown.org/collections/FicExchangeLink&&collections==Fic Exchange 2023

add_to_exclude_metadata_post:
## If the placeholder isn't changed during replace_metadata, this will remove it to prevent general breakage
 collectionUrl==abc

[mijkala]

Originally Posted by ownedbycats

https://github.com/JimmXinu/FanFicFa...ive-of-our-own

I've tried all of that and I don't think it has the outcome I'm looking for? I just wanted to keep all the hyperlinks that are usually with the collections, if a fic even has any collections. There are waaay too many under even one fic for me to manually add to personal.ini

for example this one has over 20 collections associated with it
https://archiveofourown.org/works/61...ters/157659826

The link you shared was also the only resource I could really find for it, so maybe it's not really possible...

[JimmXinu]

Originally Posted by mijkala

I've tried all of that and I don't think it has the outcome I'm looking for? I just wanted to keep all the hyperlinks that are usually with the collections, if a fic even has any collections. There are waaay too many under even one fic for me to manually add to personal.ini

for example this one has over 20 collections associated with it
https://archiveofourown.org/works/61...ters/157659826

The link you shared was also the only resource I could really find for it, so maybe it's not really possible...

FFF doesn't collect the URLs for AO3 collections.

To do so, we'd have to change the way we store collections from one metadata list to several separate entries like we do with series, series01, series02, (and series01Url, series01HTML), etc.

[ownedbycats]

I vaguely recall Jim saying not feasible to add links directly to collections. Hence the use of series, which do have links. edit: Missed new page....

Calibre lets you attach links to metadata items, so you can add them to a column and paste the links.

[mijkala]

Originally Posted by ownedbycats

I vaguely recall Jim saying not feasible to add links directly to collections. Hence the use of series, which do have links. edit: Missed new page....

Calibre lets you attach links to metadata items, so you can add them to a column and paste the links.

Could you possibly elaborate on the second part? I did try going the route of creating a separate column just for the collections. I set it up as comma separated text, like tags, shown in the browser. Do you mean I should copy and paste the links from Ao3 into the column and that would somehow populate onto the title page?

If not, thanks for the help anyways!