[GUI Plugin] FanFicFare - Page 834

JimmXinu · 09-23-2026, 10:33 PM

culytera is correct.

If you have the same setting(keyword) listed more than once in a section, only the last applies. The same thing happens if it's under different copies of the same section.

And the details of 'X' vs 'add_to_X' are documented here: https://github.com/JimmXinu/FanFicFa...add_to_keyword

watani · 09-23-2026, 11:53 PM

Two issues to report:

First, RoyalRoad has rolled out an early access system that is causing book updates to fail even for new free chapters with an "element not found" error for each early access chapter it tries to get. You can bypass this for now with the `continue_on_chapter_error:true` option, but it does mean that it'll try to re-download the early access chapters every time you want to update it which results in a lot of unnecessary queries to the site.

Here's an example of a fic with this system: https://www.royalroad.com/fiction/164273

Could only test this with the latest stable because:

Second, latest test version of FFF cannot update any books, giving the following error after selecting "OK" in the "Update Existing List" pop-up.

calibre, version 9.15.0
ERROR: Unhandled exception: <b>TypeError</b>:expected string or bytes-like object, got 'NoneType'

calibre 9.15 embedded-python: True
Windows-10-10.0.19045-SP0 Windows ('64bit', 'WindowsPE')
('Windows', '10', '10.0.19045')
Python 3.14.7
Windows: ('10', '10.0.19045', 'SP0', 'Multiprocessor Free')
Interface language: None
EXE path: C:\Program Files\Calibre2\calibre.exe
Successfully initialized third party plugins: Count Pages (1, 15, 2) && EpubMerge (3, 3, 0) && EpubSplit (3, 12, 0) && FanFicFare (4, 61, 10) && Generate Cover (2, 4, 1) && Open With (1, 8, 5) && Resize Cover (1, 2, 2) && View Manager (1, 10, 5)
Traceback (most recent call last):
File "calibre_plugins.fanficfare_plugin.fff_plugin" , line 532, in plugin_button
File "calibre_plugins.fanficfare_plugin.fff_plugin" , line 1121, in update_dialog
File "calibre_plugins.fanficfare_plugin.dialogs", line 808, in LoopProgressDialog
File "calibre_plugins.fanficfare_plugin.fff_plugin" , line 1152, in update_dialog_finish
File "calibre_plugins.fanficfare_plugin.dialogs", line 1137, in get_fff_options
File "calibre_plugins.fanficfare_plugin.dialogs", line 216, in get_ini_snippet_text
File "calibre_plugins.fanficfare_plugin.fff_util", line 120, in make_safe_ini
File "re\__init__.py", line 208, in sub
TypeError: expected string or bytes-like object, got 'NoneType'

MrMental32 · Yesterday, 06:31 AM

Got it working now. Hopefully now that only the first section has 'replace_metadata', and the rest under 'add_to_replace_metadata', It will stay working. Thanks for the help.

JimmXinu · Yesterday, 09:34 AM

New Test Version Posted

2026-09-24
- Plugin: Fix make_safe_ini() for None

I'll look at RR today, but here's a quick fix for the snippet issue.

JimmXinu · Yesterday, 12:27 PM

New Test Version Posted

2026-09-24
- adapter_royalroadcom: Changes for chapter list in JS, Legacy UI only.
- Plugin: Fix make_safe_ini() for None

Quote:

Originally Posted by watani

Two issues to report:

First, RoyalRoad has rolled out an early access system that is causing book updates to fail even for new free chapters with an "element not found" error for each early access chapter it tries to get. You can bypass this for now with the `continue_on_chapter_error:true` option, but it does mean that it'll try to re-download the early access chapters every time you want to update it which results in a lot of unnecessary queries to the site.

Here's an example of a fic with this system: https://www.royalroad.com/fiction/164273

Major site changes are a pain. Especially when they have both old and new available at the same time.

For now, the answer to that part is to set your user to use the 'Legacy UI'. FFF generally only supports one version of any given site.

However, I also saw, even on 'Legacy' display, the site changed how they code chapter URLs. Such that only the first page of chapters (default 20) were visible to the FFF code.

Luckily, the full chapter data is embedded in the page's javascript. I've changed the adapter to use that chapter data.

I did not see any "early access chapters", so I haven't done anything about those. There's also new chapter flags in the JS chapter data that I don't know how to interpret, so it's possible we can use that.

Feedback from RR users is requested.

Czarcasm · Yesterday, 03:32 PM

I've been running into some issues downloading some stories. It goes through the normal process, but once it's done, some stories give me the following comment [as an example]: (Download epub completed, 39 failed chapters, 40 total chapters)

It seems to mainly be happening with questionable questing stories, this one in particular being (https://forum.questionablequesting.c...s-gacha.39705/)

I've been using flaresolverr, using browser cache as well as having it open the pages as needed, I also have the log in info in the default.ini.

JimmXinu · Yesterday, 04:18 PM

Quote:

Originally Posted by Czarcasm

I've been running into some issues downloading some stories. It goes through the normal process, but once it's done, some stories give me the following comment [as an example]: (Download epub completed, 39 failed chapters, 40 total chapters)

It seems to mainly be happening with questionable questing stories, this one in particular being (https://forum.questionablequesting.c...s-gacha.39705/)

I've been using flaresolverr, using browser cache as well as having it open the pages as needed, I also have the log in info in the default.ini.

Debug log?

I'm able to download from QQ fine directly without either flaresolverr or browser cache.

PeterT · Yesterday, 04:36 PM

I wonder if your plugin might be able to leverage the camufox engine added in the newest calibre preview build?

JimmXinu · Yesterday, 04:51 PM

The what now? Your post is the only mention of "camufox" MR search finds...

Czarcasm · Yesterday, 05:45 PM

Quote:

Originally Posted by JimmXinu

Debug log?

I'm able to download from QQ fine directly without either flaresolverr or browser cache.

Spoiler Log - Starting from download start

Spoiler:

JimmXinu · Yesterday, 07:07 PM

Quote:

Originally Posted by Czarcasm

Spoiler Log - Starting from download start

That partial log doesn't show any failures.

Best practice is to run Calibre in debug mode (Calibre Preferences drop down), run download, quit calibre, attach debug file txt file to post. But only if it failed.

watani · Yesterday, 07:13 PM

Quote:

Originally Posted by JimmXinu

New Test Version Posted

2026-09-24
- adapter_royalroadcom: Changes for chapter list in JS, Legacy UI only.
- Plugin: Fix make_safe_ini() for None

Major site changes are a pain. Especially when they have both old and new available at the same time.

For now, the answer to that part is to set your user to use the 'Legacy UI'. FFF generally only supports one version of any given site.

However, I also saw, even on 'Legacy' display, the site changed how they code chapter URLs. Such that only the first page of chapters (default 20) were visible to the FFF code.

Luckily, the full chapter data is embedded in the page's javascript. I've changed the adapter to use that chapter data.

I did not see any "early access chapters", so I haven't done anything about those. There's also new chapter flags in the JS chapter data that I don't know how to interpret, so it's possible we can use that.

Feedback from RR users is requested.

I'm still seeing early access chapters for the story I linked last time even in the legacy UI: (Edit: Screenshot deleted after fix completed)

And FFF is clearly trying to download those early access chapters when run from my Calibre:

Quote:

FFF: DEBUG: 2026-09-24 19:05:51,854: adapter_royalroadcom.py(306): Getting chapter text from: https://www.royalroad.com/fiction/16...790/090-encore
FFF: DEBUG: 2026-09-24 19:05:51,854: cache_basic.py(106):
========== MISS (GET) BasicCache
https://www.royalroad.com/fiction/16...790/090-encore
FFF: DEBUG: 2026-09-24 19:05:51,854: fetcher_requests.py(126):
---------- REQ (GET) RequestsFetcher
https://www.royalroad.com/fiction/16...790/090-encore
FFF: DEBUG: 2026-09-24 19:05:52,191: fetcher_requests.py(139): response code:200
FFF: DEBUG: 2026-09-24 19:05:52,191: decorators.py(117): fromcache:False
FFF: DEBUG: 2026-09-24 19:05:52,192: requestable.py(54): Encoding:utf8
FFF: INFO: 2026-09-24 19:05:52,327: base_adapter.py(516): continue_on_chapter_error: (https://www.royalroad.com/fiction/16...790/090-encore) Error downloading Chapter: https://www.royalroad.com/fiction/16...790/090-encore! Missing required element!
FFF: DEBUG: 2026-09-24 19:05:52,328: base_adapter.py(517): Traceback (most recent call last):
File "C:\Users\danle\AppData\Roaming\calibre\plugins\Fa nFicFare.zip\fanficfare\adapters\base_adapter.py", line 505, in getStory
File "C:\Users\danle\AppData\Roaming\calibre\plugins\Fa nFicFare.zip\fanficfare\adapters\base_adapter.py", line 710, in getChapterTextNum
File "C:\Users\danle\AppData\Roaming\calibre\plugins\Fa nFicFare.zip\fanficfare\adapters\adapter_royalroad com.py", line 320, in getChapterText
fanficfare.exceptions.FailedToDownload: Error downloading Chapter: https://www.royalroad.com/fiction/16...790/090-encore! Missing required element!

Edit: Maybe it's pulling the complete chapter list (including the early access chapters) from my browser's cache of the story page? I am seeing the following:

Quote:

FFF: DEBUG: 2026-09-24 19:16:22,870: adapter_royalroadcom.py(197): URL: https://www.royalroad.com/fiction/164273
FFF: DEBUG: 2026-09-24 19:16:22,871: cache_basic.py(106):
========== HIT (GET) BasicCache
https://www.royalroad.com/fiction/164273

Quote:

FFF: INFO: 2026-09-24 19:16:27,256: calibre_plugins.fanficfare_plugin.jobs(309): Do update - epub(89) vs url(104)

Czarcasm · Yesterday, 07:17 PM

Quote:

Originally Posted by JimmXinu

That partial log doesn't show any failures.

Best practice is to run Calibre in debug mode (Calibre Preferences drop down), run download, quit calibre, attach debug file txt file to post. But only if it failed.

Didn't realize there was a separate debug log until I exited, at which point I had already made my post. here's the post-exit log

Spoiler:

JimmXinu · Yesterday, 07:33 PM

New Test Version Posted

2026-09-24
- adapter_royalroadcom: More changes for chapter list in JS, Legacy UI only.

Quote:

Originally Posted by watani

I'm still seeing early access chapters for the story I linked last time even in the legacy UI: Screenshot

And FFF is clearly trying to download those early access chapters when run from my Calibre:

It didn't show me those before--I looked--now it does. FFF now using the 'isUnlocked' flag in the chapter list to only collect 'unlocked' chapters.

watani · Yesterday, 07:39 PM

That did it, thanks for the fix!

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
[GUI Plugin] KindleUnpack - The Plugin	DiapDealer	Plugins	546	05-21-2026 02:44 PM
[GUI Plugin] Open With	kiwidude	Plugins	405	02-09-2026 07:54 AM
[GUI Plugin] Marvin XD	Philantrop	Plugins	126	01-29-2017 12:48 PM
[GUI Plugin] KiNotes	-axel-	Plugins	0	07-14-2013 06:39 PM
[GUI Plugin] Plugin Updater Deprecated	kiwidude	Plugins	159	06-19-2011 12:27 PM

09-23-2026, 10:33 PM	#12496
JimmXinu Plugin Developer Posts: 7,628 Karma: 5010535 Join Date: Dec 2011 Location: Midwest USA Device: Kobo Clara Colour running KOReader	culytera is correct. If you have the same setting(keyword) listed more than once in a section, only the last applies. The same thing happens if it's under different copies of the same section. And the details of 'X' vs 'add_to_X' are documented here: https://github.com/JimmXinu/FanFicFa...add_to_keyword

09-23-2026, 11:53 PM	#12497
watani Connoisseur Posts: 58 Karma: 10 Join Date: Oct 2014 Device: Kindle Fire HD	Two issues to report: First, RoyalRoad has rolled out an early access system that is causing book updates to fail even for new free chapters with an "element not found" error for each early access chapter it tries to get. You can bypass this for now with the `continue_on_chapter_error:true` option, but it does mean that it'll try to re-download the early access chapters every time you want to update it which results in a lot of unnecessary queries to the site. Here's an example of a fic with this system: https://www.royalroad.com/fiction/164273 Could only test this with the latest stable because: Second, latest test version of FFF cannot update any books, giving the following error after selecting "OK" in the "Update Existing List" pop-up. calibre, version 9.15.0 ERROR: Unhandled exception: <b>TypeError</b>:expected string or bytes-like object, got 'NoneType' calibre 9.15 embedded-python: True Windows-10-10.0.19045-SP0 Windows ('64bit', 'WindowsPE') ('Windows', '10', '10.0.19045') Python 3.14.7 Windows: ('10', '10.0.19045', 'SP0', 'Multiprocessor Free') Interface language: None EXE path: C:\Program Files\Calibre2\calibre.exe Successfully initialized third party plugins: Count Pages (1, 15, 2) && EpubMerge (3, 3, 0) && EpubSplit (3, 12, 0) && FanFicFare (4, 61, 10) && Generate Cover (2, 4, 1) && Open With (1, 8, 5) && Resize Cover (1, 2, 2) && View Manager (1, 10, 5) Traceback (most recent call last): File "calibre_plugins.fanficfare_plugin.fff_plugin" , line 532, in plugin_button File "calibre_plugins.fanficfare_plugin.fff_plugin" , line 1121, in update_dialog File "calibre_plugins.fanficfare_plugin.dialogs", line 808, in LoopProgressDialog File "calibre_plugins.fanficfare_plugin.fff_plugin" , line 1152, in update_dialog_finish File "calibre_plugins.fanficfare_plugin.dialogs", line 1137, in get_fff_options File "calibre_plugins.fanficfare_plugin.dialogs", line 216, in get_ini_snippet_text File "calibre_plugins.fanficfare_plugin.fff_util", line 120, in make_safe_ini File "re\__init__.py", line 208, in sub TypeError: expected string or bytes-like object, got 'NoneType'

Yesterday, 06:31 AM	#12498
MrMental32 Junior Member Posts: 6 Karma: 10 Join Date: Sep 2026 Device: Calibre	Got it working now. Hopefully now that only the first section has 'replace_metadata', and the rest under 'add_to_replace_metadata', It will stay working. Thanks for the help.

Yesterday, 09:34 AM	#12499
JimmXinu Plugin Developer Posts: 7,628 Karma: 5010535 Join Date: Dec 2011 Location: Midwest USA Device: Kobo Clara Colour running KOReader	New Test Version Posted 2026-09-24 - Plugin: Fix make_safe_ini() for None I'll look at RR today, but here's a quick fix for the snippet issue.

Yesterday, 03:32 PM	#12501
Czarcasm Member Posts: 15 Karma: 16762 Join Date: Jul 2013 Device: Nook	I've been running into some issues downloading some stories. It goes through the normal process, but once it's done, some stories give me the following comment [as an example]: (Download epub completed, 39 failed chapters, 40 total chapters) It seems to mainly be happening with questionable questing stories, this one in particular being (https://forum.questionablequesting.c...s-gacha.39705/) I've been using flaresolverr, using browser cache as well as having it open the pages as needed, I also have the log in info in the default.ini.

Yesterday, 04:36 PM	#12503
PeterT Grand Sorcerer Posts: 14,141 Karma: 83479096 Join Date: Nov 2007 Location: Toronto Device: Libra H2O, Libra Colour	I wonder if your plugin might be able to leverage the camufox engine added in the newest calibre preview build?

Yesterday, 04:51 PM	#12504
JimmXinu Plugin Developer Posts: 7,628 Karma: 5010535 Join Date: Dec 2011 Location: Midwest USA Device: Kobo Clara Colour running KOReader	The what now? Your post is the only mention of "camufox" MR search finds...

Yesterday, 07:39 PM	#12510
watani Connoisseur Posts: 58 Karma: 10 Join Date: Oct 2014 Device: Kindle Fire HD	That did it, thanks for the fix!