[GUI Plugin] FanFicFare

[slimcat]

Originally Posted by JimmXinu

The injected part needs to be emphasized here. We're talking about the cover image injected into the epub.

FFF cover support is over complicated. I really should have said 'no' more often in the early days to different cover options. There's a whole wiki page where I try to explain it.

FFF Anthology cover support is even more special and has it's own section in the wiki page.

FFF anthology works by downloading individual stories and using EpubMerge to create the anthology epub. Anthology updates work by using EpubMerge UnMerge, updating the individual stories, then merge together again.

As it exists today, EpubMerge's UnMerge does not give the cover image and FFF doesn't save it. I will think about how feasible it to do so.

In the meantime:

1. Calibre's cover in metadata is unchanged. If you use Calibre to send the epub to a device or save it to disk, Calibre will put the metadata cover inside it by default. For most people the problem you've identified is effectively invisible.
   
2. You can still Polish book to inject the cover, albeit manually.
   
3. If you uncheck "Generate Covers Only for New Books", FFF will generate and inject the cover every time.

I've read the Wiki but still get confused by the cover settings, so I appreciate the explanation. I don't see covers with epubs saved to disk, so your comment about that was a lightbulb moment. I didn't realize my Calibre settings could impact this. I have "Update metadata in saved copies" turned off, mainly because I have a group I share epubs with and don't want to expose my private library metadata. Also, since these are AO3 downloads, I end up with an insane amount of metadata in the OPF when it's on. So I really appreciate the ability to inject covers.

Also, I mainly use Apple Books and the Kindle app on iOS. The easiest way to get books from Calibre into Apple Books is by drag-and-drop, and covers don't show up unless they're embedded, regardless of metadata settings. Same with Send to Kindle, which is a lot faster and more reliable for me than emailing within Calibre. I also don't see non-embedded covers when opening EPUBs directly from Calibre. (If I'm missing something with any of these methods, I would love to know.)

So again, I'm super grateful for the ability to embed covers, while simultaneously sorry it's complicating your life!

Re: Anthologies, it's easy enough to use Polish after updating, I just have to remember to do it. Thanks again for all your help. You are a gentleman and a scholar.

[JimmXinu]

New Test Version Posted

2026-04-29
- PI Anthology: Reuse epub cover if there is one.
- adapter_scribblehubcom: Update ajax call for chapters data. Didn't fix #1339 but change noted 3+ years ago
- Update translations.

On anthology update, FFF now looks in the existing epub for a cover and re-uses it. Note that this will be overwritten by Generate Cover / Inject Cover.


Another point of Anthology cover weirdness:

If any sub-book has a cover, the anthology epub will be forced to have a cover, using first the Calibre cover, then the first sub-book cover if no Calibre cover is available. Now, anthology will first reuse the existing epub cover.

(AIR, there was an issue with Polish book cover update messing with the sub-book cover instead if there wasn't an overall anthology cover.)


BTW, this will get an internal epub cover, but it won't be exactly the same as a Polish'ed cover. EpubMerge (and FFF for that matter) use different code: cover.xhtml vs Polish's titlepage.xhtml for example.

[slimcat]

[QUOTE=JimmXinu;4582925]New Test Version Posted

I'm having trouble getting the test plugin working. Calibre reports a successful install, but after restart, FFF disappears from the menu/toolbar. It’s not in Available actions either, so I can’t add it back.

The test build still shows up in Plugins as installed and enabled. But if you go to check for updates, it shows 4.56.10 installed, but 4.56.0 as the available version. FFF reappears in menus/actions if I reinstall the regular version.

[JimmXinu]

Originally Posted by slimcat

I'm having trouble getting the test plugin working. Calibre reports a successful install, but after restart, FFF disappears from the menu/toolbar. It’s not in Available actions either, so I can’t add it back.

The test build still shows up in Plugins as installed and enabled. But if you go to check for updates, it shows 4.56.10 installed, but 4.56.0 as the available version. FFF reappears in menus/actions if I reinstall the regular version.

My bad. Should be fixed now.

[slimcat]

Originally Posted by JimmXinu

My bad. Should be fixed now.

It's working! Consider my case of the vanishing anthology covers officially closed. Thanks again.

[slimcat]

Originally Posted by vscogirl

2) I haven't tried to attempt these cosmetic changes in fear of ruining what I have but is it possible to do the following:
- change the data under the Series: section to be Part 1 of X instead of <hyperlinked series name [NUMBER]>

If you're just trying to get it to look like AO3 (Part X of Series Title), this is how I do it:

In your AO3 titlepage_entries, add seriesPartHTML wherever you want in the list (in place of SeriesHTML).

add_to_extra_valid_entries:,seriesPartHTML
include_in_seriesPartHTML:series00HTML
seriesPartHTML_label:Series
add_to_replace_metadata:
seriesPartHTML=>\s*<a[^>]*href=(["'])([^"']+)\1[^>]*>\s*([^<]+?)\s*\[(\d+)\]\s*</a>\s*=>Part \4 of <a href="\2">\3</a>

You'll end up with what you see in the attached screenshot.

[ownedbycats]

Is there a way to make AO3 fics with long titles automatically use certain profile in generate covers?

EDIT: This seems to work

[archiveofourown.org]
generate_cover_settings:
 ${title} => .{60,} => AO3_Smalltext

[wildfire070]

Originally Posted by ownedbycats

Is there a way to make AO3 fics with long titles automatically use certain profile in generate covers?

EDIT: This seems to work

[archiveofourown.org]
generate_cover_settings:
 ${title} => .{60,} => AO3_Smalltext

Genius! Thank you for that! I've just been manually going through and changing them but this is a lot easier.

[JimmXinu]

New Version Released

Version 4.57.0 - 2026-05-01
- PI Anthology: Reuse epub cover if there is one.
- adapter_scribblehubcom: Update ajax call for chapters data. Didn't fix #1339 but change noted 3+ years ago
- Update translations.
- PI: Correct Series field url link when setanthologyseries (aka "Set 'Series [0]' for New Anthologies")
- Move NotGoingToDownload to exceptions.py #1337
- PI: Add Fix Series Case setting for #1338
- adapter_literotica: Fix for numeric tag value from json. #1336
- fix_relative_text_links: Allow hrefs to name anchors as well as id.
- adapter_kakuyomujp: site update #1335, thanks praschke
- PI Anthologies: Only put status in tags if in include_subject_tags. Closes #1332
- Performance and perf profiling changes
- adapter_ficwadcom: Detect missing username as well as failed login #1330

[JimmXinu]

Originally Posted by JimmXinu

Here's my AO3 tags rant in full, since it's been a while.
...
AO3 Tags Cannot be Normalized Automatically
...

FYI, I've put a copy of this on github as #1340 for easier reference.

(Changing MR markup to github's markdown is more complex than you'd think.)

[ownedbycats]

Originally Posted by wildfire070

Genius! Thank you for that! I've just been manually going through and changing them but this is a lot easier.

There's still a few that I have to do manually because even smalltext isn't small enough but it's nice to have it done automagically.

[wildfire070]

Originally Posted by ownedbycats

There's still a few that I have to do manually because even smalltext isn't small enough but it's nice to have it done automagically.

Is it possible to make this work with ratings? For example, for fics that are not rated, I'd like to have the generate cover plugin automatically use the "Not Rated" cover profile.

I tried this but it didn't seem to work.

generate_cover_settings:
 rating => Not Rated => Not Rated

[JimmXinu]

Originally Posted by wildfire070

Is it possible to make this work with ratings? For example, for fics that are not rated, I'd like to have the generate cover plugin automatically use the "Not Rated" cover profile.
...

Unlike other types of settings, generate_cover_settings uses a template for the first part, so you need ${rating} not just rating in the first part:

generate_cover_settings:
 ${rating} => Not Rated => Not Rated

I don't think it's been mentioned lately, but part of the reason it works that way is so you can use more than one metadata entry to choose GC setting.

This, for example, will not trigger if there's a a cover_image found.

generate_cover_settings:
 ${rating}${cover_image} => Not Rated => Not Rated

(cover_image will be one of (specific|first|default|force) if found.)

[wildfire070]

Ah thank you! I tried that at first, but it didn't work so I played around with the combination. Still wouldn't work after changing it back until I remembered that I had set up an add_to_replace_metadata for Not Rated ratings to change to a different word, and switching that in was what did the trick!

[Jade Aislin]

I'm currently going through the defaults and other wiki pages to understand what I can do with the personal ini.

I was wondering if it were possible to use the extracategories, extragenres with a url conditional.


Something like:


extragenres:Soulmates&&storyURL=~(12280752|2902296 6)


Some authors don't always add the tags I want. For example there are a number of stories without the soulmate tag even though I want it. But it only applies to those stories. I even have one story that is missing a fandom.


I was wondering if this were possible or do I just have to add them manually.


URL examples
https://archiveofourown.org/works/12...pters/27913413
https://archiveofourown.org/works/12...pters/29022966