[GUI Plugin] FanFicFare

[JimmXinu]

Originally Posted by abeesee

To clarify, you are saying I should remove the "freeformgenres" entry from the "extra_valid_entries" list and instead create it by writing:

add_to_extra_valid_entries: freeformgenres

add_to_extra_valid_entries:, freeformgenres

The leading comma is important.
https://github.com/JimmXinu/FanFicFa...add_to_keyword

The 'gotcha' about add_to_ is that it's a string concatenation. Which means you need to include a leading comma(,) when the keyword is a list like titlepage_entries instead of a string like replace_metadata

[MangoRoll]

Originally Posted by JimmXinu

Story URL?

https://archiveofourown.org/works/80642881

I should also note I've updated the .epub several times before and have had no issues before today. The current version I have is up to chapter 10.

[JimmXinu]

New Test Version Posted

2026-07-05
- adapter_pmdfanfiction: Fix downloading chapters for stories with chapter groups - Thanks, BlizzardBricks
- Better error message for open_pages_in_browser_tries_limit exceeded
- Add avif image type to image processing.

[ThistleProse]

Please feel free to point me to where I need to go if the answer has been provided!


I've updated my api to exclude authors notes and such from my ao3 downloads, and it's working perfectly.

My question, however, is there a way to remove the comments etc from the fics I downloaded BEFORE that change was made to my api, without having to redownload and replace them? @.@ there are a lot lol but I haven't been able to find any information. If I need to redownload I will, but if I can avoid breaking my browser that would be better XD

Thank you.

[JimmXinu]

Originally Posted by ThistleProse

My question, however, is there a way to remove the comments etc from the fics I downloaded BEFORE that change was made to my api, without having to redownload and replace them? @.@ there are a lot lol but I haven't been able to find any information. If I need to redownload I will, but if I can avoid breaking my browser that would be better XD

Not using FFF.

You'd need to use Calibre's Edit book or other epub editing tool. I would look at Action Chains and Editor Chains if you need to do a bunch.

[Hushround]

Originally Posted by JimmXinu

New Version Released

Version 4.59.0 - 2026-07-01
- New site: sofurry.com, thanks dbhmw!

Hi, I can't get sofurry.com to work with FFF. every attempt ends with the error message 'NoneType' object has no attribute 'get_text'.

last url I tried: https://sofurry.com/s/ek5K2rWn

I read somewhere on that site that it was updated on June 13, 2026, so I'm wondering if the site update broke something.

Anyways, I also wanted to thank you for making and maintaining FFF. It has been beyond useful for a reader like me.

[abeesee]

Thanks for all your help! I got it working how I want it to. Much obliged!

[Tharos]

If the description in FFnet starts with "#6", Calibre displays it in the comment field as <h1>6, which results in the text being formatted accordingly. I'm not sure if this is a problem with FFF or Calibre itself.

I noticed this with the following story: https://www.fanfiction.net/s/12884583/1/Coded

In Calibre (HTML source) , it looks like this:

<div>
<h1>6 in Language Series …</h1>
</div>

I’ve shortened the description text since it’s not relevant to the issue at hand.

In the personal.ini file, I've set keep_summary_html:false under [defaults]

[culytera]

A value of "False" gets detected as a boolean type instead of a string while trying to "download" test stories. But if the value is "True", the download proceeds. Exact error message is "not expecting type '<class 'bool'>'"

(Emojis got converted since they were in HTML, attached image is the resulting cover)

## http://test1.com?sid=10001
## http://test1.com?sid=10002
## http://test1.com?sid=10003

[test1.com]
add_to_extra_valid_entries:,bookmarked,subscribed,bookmarked_icon,subscribed_icon,icons

include_in_bookmarked_icon:bookmarked
include_in_subscribed_icon:subscribed
include_in_icons:bookmarked_icon,subscribed_icon
keep_in_order_icons:true

add_to_replace_metadata:
 bookmarked_icon=>True=>Bookmarked
 subscribed_icon=>True=>Subscribed
 bookmarked_icon=>False=>Not Bookmarked
 subscribed_icon=>False=>Not Subscribed
## Show only separator if no bookmark or subscribed data
 bookmarked_icon=>^(Bookmarked)$=>🔖
 subscribed_icon=>^(Subscribed)$=>🔔
 bookmarked_icon=>^(Not Bookmarked)$=>◈
 subscribed_icon=>^(Not Subscribed)$=>◈
## Show separator if data is missing, not sure if this one actually works
 icons_LIST=>^$=>◈
## Show bookmarked icon, show subscribed icon
 icons_LIST=>^(\&\#128278\;\, \&\#128276\;)$=>🔖🔔
## Don't show bookmarked icon, don't show subscribed icon
 icons_LIST=>^(\&\#9672\;\, \&\#9672\;)$=>◈
## Don't show bookmarked icon, show subscribed icon
 icons_LIST=>^(\&\#9672\;\, \&\#128276\;)$=>🔔
## Show bookmarked icon, don't show subscribed icon
 icons_LIST=>^(\&\#128278\;\, \&\#9672\;)$=>🔖

titlepage_start:<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
 <title>${title} by ${author}</title>
 <link href="stylesheet.css" type="text/css" charset="UTF-8" rel="stylesheet"/>
 <meta name="calibre-html-render-data"/>
 </head>
 <body class="fff_titlepage">
 <div class="title">
 <h1><a href="${storyUrl}">${title}</a> by ${authorHTML}</h1>
 <h2 class="display-on-cover">${seriesHTML}</h2>
 </div>
  <div class="flex-parent display-on-reader">
   <div class="flex-child-edge"></div>
   <div class="flex-child-text">◈</div>
   <div class="flex-child-edge"></div>
 </div>
 <div class="flex-parent display-on-cover">
   <div class="flex-child-edge"></div>
   <div class="flex-child-text category">${category}</div>
   <div class="flex-child-edge"></div>
 </div>

titlepage_end:
 <div class="flex-parent display-on-cover">
   <div class="flex-child-edge"></div>
   <div class="flex-child-text stats">${bookmarked_icon} ${subscribed_icon}</div>
   <div class="flex-child-edge"></div>
 </div>
 <div class="flex-parent display-on-reader">
   <div class="flex-child-edge"></div>
   <div class="flex-child-text">${icons}</div>
   <div class="flex-child-edge"></div>
 </div>
 <div class="tag-summary-content">${description}</div>
 </body>
 </html>

add_to_output_css:
 body {
  text-align: left;
  font-family: 'Noto Sans', sans-serif;
 }
 body.fff_titlepage {
  font-size: 2.5vmax;
  font-family: 'Roboto', sans-serif;
 }
 hr {
  display: block;
  border: 0; border-top: 1px solid;
  padding: 0;
 }
## https://stackoverflow.com/a/50191135
 .fff_titlepage .flex-parent {
  display: flex;
  align-items: center;
 }
 .fff_titlepage .flex-child-edge {
  flex-grow: 2;
  border-bottom: 1px solid;
 }
 .fff_titlepage .flex-child-text {
  flex-basis: auto;
  flex-grow: 0;
  text-align: center;
  margin: 0 5px 0 5px;
  font-family: 'Roboto', sans-serif;
 }
 .fff_titlepage .flex-child-text.stats span.rating { font-weight: bold; }
 .fff_titlepage .flex-child-text.stats span.dateRange { font-family: 'Roboto Condensed', 'Roboto', sans-serif }
 .fff_titlepage .flex-child-text.category { font-weight: bold; }
 .fff_titlepage .title h1,
 .fff_titlepage h4 {
  font-family: 'Roboto Condensed', 'Roboto', sans-serif;
  font-size: 3vmax;
  margin: 0;
 }
 .fff_titlepage .title h2 {
  font-family: 'Roboto Condensed', 'Roboto', sans-serif;
  font-size: 2.7vmax;
  margin: 0;
  padding: 0;
 }
 .fff_titlepage .title h1,
 .fff_titlepage .title h2,
 .fff_titlepage .title h5 { font-weight: normal; }
 .fff_titlepage a {
  font-weight: bold;
  text-decoration: none;
  color: unset;
 }
 .fff_titlepage .tag-summary-content a { font-style: italic; }
 .fff_titlepage .tag-summary-content p {
  font-family: 'Roboto Condensed', 'Roboto', sans-serif
  margin-top: 0;
  line-height: 1.1em;
 }
 .fff_titlepage blockquote {
  margin: 0 0.5em;
  padding: 0 0.5em;
 }
 .fff_titlepage blockquote p {
  margin-top: 0.5em; margin-bottom: 0.5em;
 }
 .fff_titlepage .userstuff p { margin-top: 0.5em; }
 .fff_chapter .userstuff p {
  margin-top: 1.5em;
  margin-bottom: 1.5em;
 }
 .fff_titlepage .tags {
  display: block;
  padding: 0;
  line-height: 1.1em;
  margin: 0.5em 0;
  font-size: 90%%;
 }
 .fff_titlepage dl .inline dt:after { content:'\00a0'; }
 .fff_titlepage dl .inline dt { float: left; }
 .fff_titlepage .display-on-reader { display: none; }
 .fff_titlepage dt { font-family: 'Roboto Condensed'; }
 .fff_titlepage dd { margin-left: 0.75em; }
 .fff_titlepage dl, .fff_titlepage dt { margin: 0; }
## Change displayed content on titlepage depending on screen width
 @media only screen and (max-device-width: 480px),
 only screen and (min-device-width: 768px) and (max-device-width: 1024px) {
  body.fff_titlepage {
    font-size: unset;
    font-family: unset;
    background-color: unset;
    color: unset;
  }
  body.fff_titlepage, .fff_titlepage dt {
    background_color: unset;
    color: unset;
    font-family: unset;
  }
  .fff_titlepage .title h1,
  .fff_titlepage h2,
  .fff_titlepage h3,
  .fff_titlepage h4,
  .fff_titlepage h5 {
    font-family: unset;
    font-size: unset;
    margin: unset;
  }
  .fff_titlepage .tag-summary-content p { line-height: unset; }
  .fff_titlepage .tags { line-height: unset; }
  .fff_titlepage .display-on-cover { display: none; }
  .fff_titlepage .display-on-reader { display: block; }
  .fff_titlepage .flex-parent.display-on-reader { display: flex; }
  h1, h2, h3, h4, h5,
  .fff_titlepage .tags { font-size: 100%%; }
 }

[teststory:defaults]
add_to_valid_entries:,bookmarked,subscribed

title:{{storyId}} Both False
author_list:{{storyId}}
category_list:Test Story

bookmarked:False
subscribed:False

[teststory:10001]
title:{{storyId}} Both True
author_list:{{storyId}}
category_list:Test Story

bookmarked:True
subscribed:True

[teststory:10002]
title:{{storyId}} True and False
author_list:{{storyId}}
category_list:Test Story

bookmarked:True
subscribed:False

[teststory:10003]
title:{{storyId}} False and True
author_list:{{storyId}}
category_list:Test Story

bookmarked:False
subscribed:True

[JimmXinu]

Originally Posted by Hushround

Hi, I can't get sofurry.com to work with FFF. every attempt ends with the error message 'NoneType' object has no attribute 'get_text'.

I've called it to the attention of the dev who implemented that site. See: https://github.com/JimmXinu/FanFicFa...ent-4893750616

Originally Posted by Tharos

If the description in FFnet starts with "#6", Calibre displays it in the comment field as <h1>6, which results in the text being formatted accordingly. I'm not sure if this is a problem with FFF or Calibre itself.

...

In the personal.ini file, I've set keep_summary_html:false under [defaults]

And that's your cause. With keep_summary_html:false, the summary is treated as Markdown instead of plain text. I'd set keep_summary_html:true for at least that story. Or use replace_metadata to change the leading "#" character.

Originally Posted by culytera

A value of "False" gets detected as a boolean type instead of a string while trying to "download" test stories. But if the value is "True", the download proceeds. Exact error message is "not expecting type '<class 'bool'>'"

Fix in next test version. There's another bug I want to fix first.

[JimmXinu]

New Test Version Posted

2026-07-06
- adapter_test1: Handle bool settings in [teststory:] better
- INI Snippet: Repopulate the combobox in AddNewDialog() when shown in case of library change.

[Tharos]

Originally Posted by JimmXinu

With keep_summary_html:false, the summary is treated as Markdown instead of plain text. I'd set keep_summary_html:true for at least that story. Or use replace_metadata to change the leading "#" character.

Then I must have misunderstood the explanation in the personal.ini file.

What do I need to write in the personal.ini so that only the plain text—and, if applicable, the paragraph breaks—are retained, while the rest of the formatting is ignored?

[JimmXinu]

Originally Posted by Tharos

Then I must have misunderstood the explanation in the personal.ini file.

What do I need to write in the personal.ini so that only the plain text—and, if applicable, the paragraph breaks—are retained, while the rest of the formatting is ignored?

keep_summary_html:true strips the site's HTML by sending it through Calibre's sanitize_comments_html(). That's what does the not-HTML conversion (via markdown) and also throws a basic <p> tag around the whole thing. Basically, it guarantees that whatever comes out, Calibre won't choke on it.

This is some really old code. 2012 old. Originally to help with BBCode.

Originally Posted by JimmXinu

@crackshot91 - Here's a version that uses sanitize_comments_html from calibre.library.comments as Kovid suggested rather than stripping all HTML from the summary.

This version also changes the default value for keep_summary_html to true. ...

Unless you can point to a significant collection of stories that this is a problem for, I'm not inclined to change it at this point.

For this particular story--or the ffnet site in general--I suggest you set keep_summary_html:true in this case. ffnet has never, to my knowledge, allowed HTML in their summaries anyway.

[Tee_Kay]

Greetings,

first off thanks for this amazing addon.
After setting it up it worked really well.

And then it suddenly stopped working for "Fimfiction.net" and i don't know why.
Now i always getting this error now: 'NoneType' object has no attribute 'find'

Neiter downloading the epub via downloadbutton and importing in calibre -> and then upadting via FFF nor the URL download works.
Re-downloading Flaresolverr, nor downloading an older version of FFF and calibre dind't help either.

A random story from Ao3 worked without any problems.

I searched in this tread and found this one arround "#11168"
Other site but similiar problem? Have not tried it yet since its "relatively" old.
Maybe there is some new input to this?
What i get from that is i am somehow blocked?

Debug is attached.

Thanks in advance.

[JimmXinu]

I don't know why you'd get that particular error. I don't see it.

Instead, I get a straight up 403 denied and have to use FlareSolverr to download from fimf these days. And I have had for months(years?).

See https://github.com/JimmXinu/FanFicFa...oblematicSites and https://github.com/JimmXinu/FanFicFa.../ProxyFeatures

Your error indicates that you weren't necessarily blocked, but you also didn't get the expected HTML.

I can give you a test version that dumps the collected HTML if you want to go to that level of troubleshooting.