## An 'Update Always' that doesn't add a new last chapter will also remove the end notes.
## DO NOT USE UPDATE ALWAYS.
## 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. Example:
## [defaults]
## titlepage_entries: category,genre, status
## [
www.whofic.com]
## # overrides defaults.
## titlepage_entries: category,genre, status,dateUpdated,rating
## [epub]
## # overrides defaults & site section
## titlepage_entries: category,genre, status,datePublished,dateUpdated,dateCreated
## [
www.whofic.com:epub]
## # overrides defaults, site section & format section
## titlepage_entries: category,genre, status,datePublished
## [overrides]
## # overrides all other sections
## titlepage_entries: category
## Some sites also require the user to confirm they are adult for
## adult content. Uncomment by removing '#' in front of is_adult.
is_adult:true
## 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.
#strip_chapter_numbers:true
#add_chapter_numbers:true
## Add this to genre if there's more than one category.
#add_genre_when_multi_category: Crossover
## Adds the tag "oneshot" to 1-chapter completed stories. Copy-pasted from FAQ.
# defaults so is affects everything, but can be overridden by
# more specific sections.
#[defaults]
# 'add_to_' concats on to existing param, thus the leading comma
add_to_extra_valid_entries:,oneshot
# oneshot is a copy of status because status itself isn't a list.
include_in_oneshot:status
# add oneshot to the tags that are included in epub & calibre.
add_to_include_subject_tags:,oneshot
# Change oneshot to ['Completed'] to ['Completed','Oneshot'] only when
# numChapters is exactly 1.
# with ',' instead of '\,' it would be ['Completed'] to
# ['Completed,Oneshot']--one string instead of two.
#add_to_replace_metadata:
## oneshot thing over.
###
http://www.mobileread.mobi/forums/sh...59221&page=443
###custom_columns_settings: oneshot=>#fanficstatus
###replace_metadata:
## Sets one-chapter fics to oneshot oneshot=>Completed=>Oneshot&&numChapters=>^1$
# 'add_to_' concats on to existing param, thus the leading comma
###add_to_extra_valid_entries:,oneshot,tagscategor y,
# oneshot is a copy of status because status itself isn't a list.
###include_in_oneshot:status
add_to_replace_metadata:
oneshot=>Completed=>Completed\,Oneshot&&numChapter s=>^1$
replace_metadata:
series=>(.*)=>
[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.
#include_images:true
## If not set, the summary will have all html stripped for safety.
## Both this and include_images must be true to get images in the
## summary.
#keep_summary_html:true
## If set, the first image found will be made the cover image. If
## keep_summary_html is true, any images in summary will be before any
## in chapters.
make_firstimage_cover:false
## Resize images down to width, height, preserving aspect ratio.
## Nook size, with margin.
#image_max_size: 580, 725
image_max_size: 1180,980
## Change image to grayscale, if graphics library allows, to save
## space.
#grayscale_images: false
## Most common, I expect will be using this to save username/passwords
## for different sites. Here are a few examples. See defaults.ini
## for the full list.
#titlepage_use_table: true
#titlepage_wide_entry:<b>${label}:</b> ${value}<br />
#wide_titlepage_entries:description
#titlepage_no_title_entry:${value}<br />
[archiveofourown.org]
use_workskin:true
# as of 2023.07.20
use_archiveofourown_gay:true
# as of 2025.05.22
## Some adapters collect additional meta information beyond the
## standard ones. They need to be defined in extra_valid_entries to
## tell the rest of the FanFicFare system about them. They can be
## used in include_subject_tags, titlepage_entries,
## extra_titlepage_entries, logpage_entries, extra_logpage_entries,
## and include_in_* config items. You can also add additional entries
## here to build up composite metadata entries.
## archiveofourown.org, for example, fills genre (a standard
## entry) as the composite offreeformtags, ao3categories in
## include_in_genre. If there's ever more than 4 series, add
## series04,series04Url etc.
extra_valid_entries:fandoms, freeformtags, freefromtags,
ao3categories, comments, chapterslashtotal, chapterstotal, kudos,
hits, bookmarks, collections, collectionsUrl, collectionsHTML, byline, bookmarked, bookmarktags,
bookmarksummary, bookmarkprivate, bookmarkrec, restricted, series00,
series01, series02, series03, series00Url, series01Url, series02Url,
series03Url, series00HTML, series01HTML, series02HTML, series03HTML,
series04, series05, series06, series07, series08, series09, series10,
series04Url, series05Url, series06Url, series07Url, series08Url, series09Url, series10Url,
series04HTML, series05HTML, series06HTML, series07HTML, series08HTML, series09HTML, series10HTML, series11HTML, series12HTML, series13HTML, series14HTML,
empty, subscribed, associations, creatorstyle, markedforlater,
inspired, inspiredUrl, inspiredHTML, endnotes, endnotesUrl, endnotesHTML, allseriesHTML
fandoms_label:Fandom
freeformtags_label:Additional Tags
freefromtags_label:Additional Tags
ao3categories_label:Category
## comments count
comments_label:Comments
chapterslashtotal_label:Chapters
chapterstotal_label:Total Chapters
kudos_label:Kudos
hits_label:Hits
collections_label:Collections
collectionsUrl_label:Collections
collectionsHTML_label:Collections
## Count of bookmarks on story by all users
bookmarks_label:Bookmarks
## Tags & Summary from *your* bookmark on the story. Only collected
## if always_login:true
#bookmarked_label:I Bookmarked Story
#bookmarktags_label:My Bookmark Tags
#bookmarksummary_label:My Bookmark Summary
#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
series00HTML_label:Series
series01HTML_label:Series
series02HTML_label:Series
series03HTML_label:Series
series04HTML_label:Series
series05HTML_label:Series
series06HTML_label:Series
series07HTML_label:Series
series08HTML_label:Series
series09HTML_label:Series
series10HTML_label:Series
series11HTML_label:Series
series12HTML_label:Series
series13HTML_label:Series
series14HTML_label:Series
empty_label:
#description_label:
#datecreated_label:Downloaded
warnings_label:Archive Warning
## (Plugin Only) - You can also populate calibre custom columns with
## the site specific metadata using custom_columns_settings (but only
## if 'Allow custom_columns_settings from personal.ini' is checked in
## the plugin GUI config.) 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'.)
add_to_custom_columns_settings:
fandoms=>#fandoms,r
freeformtags=>#freeformtags,r
freefromtags=>#freeformtags,r
ao3categories=>#ao3categories,r
comments=>#reviews,r
chapterslashtotal=>#chapterslashtotal,r
chapterstotal=>#chapterstotal,r
kudos=>#kudos,r
hits=>#hits,r
collections=>#collections,r
bookmarks=>#bookmarks,r
bookmarked=>#bookmarked,r
bookmarktags=>#bookmarktags,r
bookmarksummary=>#bookmarksummary,r
bookmarkprivate=>#bookmarkprivate,r
bookmarkrec=>#bookmarkrec,r
restricted=>#restricted,r
byline=>#byline,r
series00Url=>#series00url,r
series01Url=>#series01url,r
series02Url=>#series02url,r
series03Url=>#series03url,r
series04Url=>#series04url,r
series05Url=>#series05url,r
series00=>#series00,r
series01=>#series01,r
series02=>#series02,r
series03=>#series03,r
series04=>#series04,r
series05=>#series05,r
# series00HTML=>#series00html,r
# series01HTML=>#series00html,a
# series02HTML=>#series00html,a
# series03HTML=>#series00html,a
subscribed=>#subscribed,r
associations=>#associations,r
inspired=>#inspired,r
inspiredHTML=>#inspired,r
markedforlater=>#markedforlater,r
creatorstyle=>#creatorstyle,r
# added 2023.03.13
allseriesHTML=>#serieshtml,r
collectionsHTML=>#collectionshtml,r
# added 2025.10.04
include_in_allseriesHTML: series00HTML,series01HTML,series02HTML,series03HTM L,series04HTML,series05HTML, series06HTML, series07HTML, series08HTML, series09HTML, series10HTML, series11HTML, series12HTML, series13HTML, series14HTML
# added 2023.12.07
keep_in_order_genre:true
keep_in_order_characters:true
keep_in_order_relationships:true
keep_in_order_category:true
keep_in_order_tags:true
keep_in_order_freeformtags:true
keep_in_order_freefromtags:true
keep_in_order_fandoms:true
keep_in_order_ships:true
keep_in_order_warnings:true
keep_in_order_bookmarktags:true
keep_in_order_collections:true
keep_in_order_allseries:true
keep_in_order_byline:true
keep_in_order_anthologyfff:true
keep_in_order_seriescomma:true
keep_in_order_seriesfff:true
keep_in_order_series:true
keep_in_order_pairing:true
keep_in_order_pairings:true
keep_in_order_inspired:true
keep_in_order_associations:true
#added on 2022.02.19
add_to_comma_entries:,reviews, comments, kudos, hits, bookmarks,
## Assume entryUrl, apply to "<a class='%slink' href='%s'>%s</a>" to
## make entryHTML.
make_linkhtml_entries:inspired,associations,endnot es,series00,series01,series02,series03,series04,se ries05,series06,series07,series08,series09,series1 0,series11,series12,series13,series14
#include_in_genre: freeformtags, ao3categories
#include_in_category:fandoms
## 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
titlepage_entries: rating,warnings,ao3categories,empty.SHOW_EMPTY,fan doms,empty.SHOW_EMPTY,ships,empty.SHOW_EMPTY,chara cters,empty.SHOW_EMPTY,freeformtags,empty.SHOW_EMP TY,chapterslashtotal,numWords,datePublished,dateUp dated,bookmarks,comments,kudos,hits,collectionsHTM L,collections,series00HTML,series01HTML,series02HT ML,series03HTML,series04HTML,series05HTML, series06HTML, series07HTML, series08HTML, series09HTML, series10HTML, series11HTML, series12HTML, series13HTML, series14HTML,description,empty.SHOW_EMPTY,empty.SH OW_EMPTY
## adds to titlepage_entries instead of replacing it.
#extra_titlepage_entries: fandoms,freeformtags,ao3categories,comments,chapte rslashtotal,chapterstotal,kudos,hits,bookmarks,boo kmarked,bookmarktags,bookmarksummary,series00,seri es01,series02,series03,series00HTML,series01HTML,s eries02HTML,series03HTML,byline
#extra_subject_tags:fandoms,freeformtags,ao3catego ries
#exclude_notes:authorheadnotes,chaptersummary,chap terheadnotes,chapterfootnotes,authorfootnotes,insp iredlinks
## AO3 authorfootnotes and inspiredlinks end up in the 'last' chapter,
## but if updated, then there's a new 'last' chapter, leaving multiple
## copies. This option applies the 'skip_on_ffdl_update' class to
## those tags which means they will be removed during epub reading for
## update. This will only effect chapters added after turning the
## setting on.
## Result: Only the last chapter will have end notes.
## Side-effect: An 'Update Always' that doesn't add a new last
## chapter will also remove the end notes.
remove_authorfootnotes_on_update:true
## DO NOT USE UPDATE ALWAYS.
slow_down_sleep_time:10
## AO3 chapters have 'date' available for each chapter.
## These can be used with custom output (see
##
https://github.com/JimmXinu/FanFicFa...i/CustomOutput ) or with
## chapter_title_*_pattern settings.
## Examples for html & epub:
[html]
include_tocpage: true
tocpage_entry:
<a href="#section${index04}">${chapter}</a> ${date}<br />
[epub]
include_tocpage: true
tocpage_entry:
<a href="file${index04}.xhtml">${chapter}</a> ${date}<br /><br />
## The 'date' value for chapters mentioned above can be formated with
## datechapter_format. Otherwise it will default to
## datePublished_format
datechapter_format:%%Y-%%m-%%d
#include_logpage: smart
#include_logpage: true
## This section will override anything in the system defaults or other
## sections here.
[overrides]
## default varies by site. Set true here to force all sites to
## collect series.
#collect_series: true