[GUI Plugin] FanFicFare

[ownedbycats]

Is the chapter range documented anywhere in docs? I sometimes forget how to use it and searching forum thread is slow.

EDIT: Doesn't seem to be. Any objections if I add to FAQ?

[ownedbycats]

Random feature request that I don't know if possible: An option in personal.ini editor to open second window with defaults.ini. Make easier to look up things.

[JimmXinu]

Go ahead.

It's in the tooltip for the URL box, but that one says [1,2] and I usually use [1-2]. Both work.

[JimmXinu]

Originally Posted by ownedbycats

Random feature request that I don't know if possible: An option in personal.ini editor to open second window with defaults.ini. Make easier to look up things.

Only by making both non-modal.

Would that be useful for anyone else?

I always have them open in emacs, but you can view in github too:
https://github.com/JimmXinu/FanFicFa...n-defaults.ini

[ownedbycats]

Thanks.

Question: Is there a good way to apply update to a ranged fic to apply includes or replace_metadatas to title page?

Update Existing Fanfic retrieves all chapters. However, if I use Download With Fic and have multiple books with the same URL (as I prefer to separate them into oneshots) it not always get right one.

Deleting and re-downloading seems only option, or just updating metadata and editing the titlepage by hand.

[ownedbycats]

Originally Posted by JimmXinu

Only by making both non-modal.

Would that be useful for anyone else?

Another alternative, not sure if more trouble, is make them both one dialog switchable tabs.

[JimmXinu]

Originally Posted by ownedbycats

Question: Is there a good way to apply update to a ranged fic to apply includes or replace_metadatas to title page?

Update Existing Fanfic retrieves all chapters. However, if I use Download With Fic and have multiple books with the same URL (as I prefer to separate them into oneshots) it not always get right one.

first_chapter and last_chapter are undocumented settings equivalent to using a chapter range.

But if you have more than one story in your library with the same storyUrl in Calibre's identifier:url, you'd need to change personal.ini for each one. Personally, I remove the storyUrl identifier:url from splits to avoid accidents.

I suppose that's arguably a justification for per-story ini settings by custom column.

Honestly, a major reason I've not wanted to add that is to avoid having to help users troubleshoot issues when using both personal.ini and an ini custom column. I foresee there would a lot of cases users forgetting they'd set one or the other.

[JimmXinu]

New Test Version Posted

2025-10-02
- Fix tuple vs grouping vs list, closes #1254

[LittleBit]

Originally Posted by JimmXinu

(I just dump all my Calibre books(6700+) into one directory on the device. I used {id} to name them, but I'd use {uuid} if I did it again from scratch.)

I think I would die if I did that. I'm relatively allergic to collections and navigate mostly by directory. So having folders: fandom/series/story is easier for me to find with less set up on my part. Unless I'm doing things wrong. I only recently started using KOreader and my Kindle to read fanfiction. I'm still working out the kinks on a lot of things. I use {id} as well, what did you think are the benefits of using {uuid}?

Originally Posted by JimmXinu

That would be easier. I'd suggest doing it as a Calibre Custom column instead of doing it in FFF. That way if you manually change the value in your multi-fandom column for a story, the single fandom column will update appropriately.

That did seem like the easier way. I would probably still use FFF to populate the column but just manually switch out crossovers. My brain says there should be a way to program it to change the data I want changed, but I don't know enough about the language to make it work. I was playing with a composite column and using switch and switch_if but it either it errors (should have even/odd arguments) or changes everything for some reason. I imagine if/else would work if I could figure it out.

[LittleBit]

Originally Posted by JimmXinu

As a fellow KOReader user (on Kobo), I do it a different way: KOReader has a 'Calibre metadata search' feature you can use if you have a Calibre metadata.calibre file available. That works well for me because I put category(fandom) and genre in Calibre's Tags.

Whether you do or not have that available depends how you're getting your books onto the device.

Somehow I missed this part (probably something to do with the shock of having that many files in one location). I probably could set it up like that but idk. I like opening my home page and having the fandom folders right there. No searching required. Especially once I make it all pretty to look at with mosaic, instead of the info dump it currently is.

[JimmXinu]

Originally Posted by LittleBit

I think I would die if I did that. I'm relatively allergic to collections and navigate mostly by directory. So having folders: fandom/series/story is easier for me to find with less set up on my part. Unless I'm doing things wrong. I only recently started using KOreader and my Kindle to read fanfiction. I'm still working out the kinks on a lot of things. I use {id} as well, what did you think are the benefits of using {uuid}?

KOReader is largely designed for users who organize by folders. I'm the one doing things oddly, honestly.

Calibre's {id} is library unique--basically just an increasing integer--while {uuid} is a made up universally unique string (example: calibre:dcf61b0b-c049-4f23-ac2f-663eed3eb9d6).

So if you keep books in more than one library, you could end up with conflicting {id} values, but not with {uuid}.

[famewolf]

Anyone else having problems with the latest version of fanficfare? It's failing on grabbing a royalroad story and worked fine the day before update.

Spoiler:

---------- REQ (GET) RequestsFetcher
https://www.royalroad.com/fiction/13...518/chapter-20
FFF: DEBUG: 2025-10-03 11:48:31,096: fetcher_requests.py(127): response code:200
FFF: DEBUG: 2025-10-03 11:48:31,096: decorators.py(118): fromcache:False
FFF: DEBUG: 2025-10-03 11:48:31,097: requestable.py(55): Encoding:utf8
FFF: DEBUG: 2025-10-03 11:48:31,196: story.py(1560): addImgUrl(parenturl=https://www.royalroad.com/fiction/132460/loopbreaker-a-timeloop-litrpg-book-1-completely/chapter/2622518/chapter-20,url=https://i.imgur.com/3AwYIpk.gif,cover=None,coverexclusion=(imgur.com/dzOACJf.png|/forum/images/smilies/)
FFF: DEBUG: 2025-10-03 11:48:31,196: cache_basic.py(117):
========== MISS (GET) BasicCache
https://i.imgur.com/3AwYIpk.gif
FFF: DEBUG: 2025-10-03 11:48:31,196: fetcher_requests.py(114):
---------- REQ (GET) RequestsFetcher
https://i.imgur.com/3AwYIpk.gif

FFF: DEBUG: 2025-10-03 11:48:37,184: fetcher_requests.py(127): response code:200
FFF: DEBUG: 2025-10-03 11:48:37,184: decorators.py(118): fromcache:False
FFF: DEBUG: 2025-10-03 11:48:37,184: story.py(1658): Doing image processing on (https://i.imgur.com/3AwYIpk.gif)
FFF: INFO: 2025-10-03 11:48:37,255: calibre_plugins.fanficfare_plugin.jobs(381): Exception: {'title': 'Loopbreaker - A timeloop LitRPG - Book 1 (Completely Written 192k Words - 1 Chapter 7 days a week)', 'author_sort': ['Dads Bedtime Stories'], 'author': ['Dads Bedtime Stories'], 'comments': '<div class="hidden-content">\n <p>The hardest part of being a noble’s first son? Nothing—you inherit most of it.<br/>Being the ninth son means you inherit war.<br/><br/>Drafted to the front, Francis Lancaster has one purpose: keep his half-brother Michael alive on the blood-soaked fields of Reevotort, where six months of fighting the Beastkin army has taken its toll on the kingdom. When Francis steps into his brother’s punishment, that moment changes everything. <br/><br/>Now, whenever Francis dies, he wakes a few days before his death, every skill and stat he gained, kept.<br/><br/>Curse or blessing, the loop is a weapon—if he can stand the cost. To save his brother and himself, Francis must map patterns, stack skills, and turn each loss into a better opening move…before the next death makes him repeat everything again.<br/><br/>*****<br/>Book 1 is complete. 192,000 words. Working on book 2.<br/><br/>Chapters 1-12 will drop Day 1 (Sept 15th), with a single chapter a day 7 days a week.<br/><br/></p>\n </div>', 'good': False, 'status': 'Error', 'showerror': True, 'calibre_id': None, 'begin': None, 'end': None, 'comment': "'NoneType' object does not support item assignment", 'url': 'https://www.royalroad.com/fiction/132460', 'site': 'www.royalroad.com', 'series': '', 'added': False, 'pubdate': datetime.datetime(2025, 9, 15, 9, 0, 7, tzinfo=datetime.timezone(datetime.timedelta(days=-1, seconds=72000), 'EDT')), 'publisher': 'www.royalroad.com', 'uniqueurl': 'https://www.royalroad.com/fiction/132460[None-None]', 'listorder': 0, 'collision': 'Update EPUB if New Chapters', 'is_adult': False, 'username': 'NoneGiven', 'password': '', 'totp': None, 'icon': 'dialog_error.png', 'all_metadata': {'category': 'Original', 'genre': 'Action, Adventure, Anti-Hero Lead, Drama, Fantasy, LitRPG, Magic, Male Lead, Reincarnation, Time Loop, Time Travel, War and Military', 'characters': '', 'ships': '', 'warnings': 'Graphic Violence, Profanity', 'extratags': '', 'author': 'Dads Bedtime Stories', 'authorId': '359521', 'authorUrl': 'https://www.royalroad.com/user/profile/359521', 'lastupdate': 'Last Update Year/Month: 2025/10, Last Update: 2025/10/03', 'series': '', 'seriesUrl': '', 'language': '', 'status': 'In-Progress', 'datePublished': '2025-09-15', 'dateUpdated': '2025-10-03', 'dateCreated': '2025-10-03 11:48:19', 'rating': '', 'numChapters': '30', 'numWords': '73,825', 'words_added': '', 'site': 'www.royalroad.com', 'publisher': 'www.royalroad.com', 'storyId': '132460', 'title': 'Loopbreaker - A timeloop LitRPG - Book 1 (Completely Written 192k Words - 1 Chapter 7 days a week)', 'titleHTML': "<a class='titlelink' href='https://www.royalroad.com/fiction/132460'>Loopbreaker - A timeloop LitRPG - Book 1 (Completely Written 192k Words - 1 Chapter 7 days a week)</a>", 'storyUrl': 'https://www.royalroad.com/fiction/132460', 'sectionUrl': 'https://www.royalroad.com/fiction/132460', 'description': '<div class="hidden-content">\n <p>The hardest part of being a noble’s first son? Nothing—you inherit most of it.<br/>Being the ninth son means you inherit war.<br/><br/>Drafted to the front, Francis Lancaster has one purpose: keep his half-brother Michael alive on the blood-soaked fields of Reevotort, where six months of fighting the Beastkin army has taken its toll on the kingdom. When Francis steps into his brother’s punishment, that moment changes everything. <br/><br/>Now, whenever Francis dies, he wakes a few days before his death, every skill and stat he gained, kept.<br/><br/>Curse or blessing, the loop is a weapon—if he can stand the cost. To save his brother and himself, Francis must map patterns, stack skills, and turn each loss into a better opening move…before the next death makes him repeat everything again.<br/><br/>*****<br/>Book 1 is complete. 192,000 words. Working on book 2.<br/><br/>Chapters 1-12 will drop Day 1 (Sept 15th), with a single chapter a day 7 days a week.<br/><br/></p>\n </div>', 'formatname': '', 'formatext': '', 'siteabbrev': 'rylrdl', 'version': 'FanFicFare v4.49.0', 'authorHTML': "<a class='authorlink' href='https://www.royalroad.com/user/profile/359521'>Dads Bedtime Stories</a>", 'seriesHTML': '', 'langcode': '', 'output_css': '', 'cover_image': 'specific', 'newforanthology': '', 'stars': '4.625'}, 'tags': ['Action', 'Adventure', 'Anti-Hero Lead', 'Drama', 'Fantasy', 'LitRPG', 'Magic', 'Male Lead', 'Reincarnation', 'Time Loop', 'Time Travel', 'War and Military', 'Original', 'In-Progress'], 'updatedate': datetime.datetime(2025, 10, 3, 9, 4, 6, tzinfo=datetime.timezone(datetime.timedelta(days=-1, seconds=72000), 'EDT')), 'timestamp': datetime.datetime(2025, 10, 3, 11, 48, 21, 745825, tzinfo=datetime.timezone(datetime.timedelta(days=-1, seconds=72000), 'EDT')), 'calibre_columns': {}, 'outfile': '/tmp/calibre-55rzagjp/fanficfare_zwujsovt/Loopbreaker - A timeloop LitRPG - Book 1 (Completely Written 192k Words - 1 Chapter 7 days a week)-D175eqtud.epub'}:'NoneType' object does not support item assignment
Traceback (most recent call last):
File "calibre_plugins.fanficfare_plugin.jobs", line 249, in do_download_for_worker
writer.writeStory(outfilename=outfile,
~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^
forceOverwrite=True,
^^^^^^^^^^^^^^^^^^^^
notification=notification)
^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/famewolf/.config/calibre/plugins/FanFicFare.zip/fanficfare/writers/base_writer.py", line 215, in writeStory
self.story = self.adapter.getStory(notification)
~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^
File "/home/famewolf/.config/calibre/plugins/FanFicFare.zip/fanficfare/adapters/base_adapter.py", line 293, in getStory
data = self.getChapterTextNum(url,index)
File "/home/famewolf/.config/calibre/plugins/FanFicFare.zip/fanficfare/adapters/base_adapter.py", line 479, in getChapterTextNum
return self.getChapterText(url)
~~~~~~~~~~~~~~~~~~~^^^^^
File "/home/famewolf/.config/calibre/plugins/FanFicFare.zip/fanficfare/adapters/adapter_royalroadcom.py", line 338, in getChapterText
return self.utf8FromSoup(url,div)
~~~~~~~~~~~~~~~~~^^^^^^^^^
File "/home/famewolf/.config/calibre/plugins/FanFicFare.zip/fanficfare/adapters/base_adapter.py", line 668, in utf8FromSoup
retval = self._do_utf8FromSoup(url,soup,fetch,allow_replace _br_with_p)
File "/home/famewolf/.config/calibre/plugins/FanFicFare.zip/fanficfare/adapters/base_adapter.py", line 851, in _do_utf8FromSoup
t['class']=t.name
~^^^^^^^^^
File "/usr/lib/python3.13/site-packages/bs4/element.py", line 2421, in __setitem__
self.attrs[key] = value
~~~~~~~~~~^^^^^
TypeError: 'NoneType' object does not support item assignment
FFF: INFO: 2025-10-03 11:48:37,258: calibre_plugins.fanficfare_plugin.jobs(77):
Download Results:
Error https://www.royalroad.com/fiction/132460 'NoneType' object does not support item assignment

FFF: INFO: 2025-10-03 11:48:37,258: calibre_plugins.fanficfare_plugin.jobs(102):
Error
https://www.royalroad.com/fiction/132460

[JimmXinu]

Originally Posted by famewolf

Anyone else having problems with the latest version of fanficfare? It's failing on grabbing a royalroad story and worked fine the day before update.

Fixed yesterday in the test version. I didn't call it out as originating from royalroad, I'll go back and add that.