[ChatterChats]

Many people use calibre to manage fanfiction in their library, but getting clean metadata onto those fics can still be a chore.

This plugin adds a FicHub-powered metadata source to calibre so you can pull story information directly into your library from supported story URLs.

Main Features of FicHub Metadata Source:

• Download fanfiction metadata into calibre from supported story URLs using FicHub.
• Works especially well with Archive of Our Own and FanFiction.net.
• Fills in useful book details such as title, author, tags, series, published date, language, publisher, comments, and source IDs.
• Recognizes AO3 and FanFiction.net story IDs for cleaner matching inside calibre.
• Adds a richer comments/summary section with story details and stats when available.
• Retries temporary connection problems automatically.

Supported Story Sources:

• Archive of Our Own
• FanFiction.net
• Other story URLs supported by FicHub

Special Notes:

• Minimum supported calibre version: 6.0.0
• This plugin is for metadata download. It does not download the story text itself.
• An internet connection is required while fetching metadata.

How To Use It:

• Install the plugin ZIP in calibre using Preferences -> Plugins -> Load plugin from file.
• Restart calibre.
• Enable FicHub under Preferences -> Metadata download -> Customize metadata sources.
• If not already present, add a story URL as an identifier for a book, for example:
  

  url:https://archiveofourown.org/works/12345678

  url:https://www.fanfiction.net/s/1234567/1/Story-Title

• Select the book and use Download metadata.

Installation:

Download the latest plugin ZIP from:
Github: chatterchats/fichub-calibre-metadata@latest

Then install it in calibre from:
Preferences -> Plugins -> Load plugin from file

Project Home:
Github: chatterchats/fichub-calibre-metadata

Current Version History:

Spoiler:

Version 0.1.2 - 2026-04-11
- Fixed a metadata lookup issue that could cause calibre lookups to fail after metadata was successfully found.
- Improved release packaging and workflow reliability.

Version 0.1.1 - 2026-04-11
- Improved calibre integration for story URL handling.
- Better matching for AO3 and FanFiction.net story links.
- Improved metadata handling and general reliability.

Version 0.1.0 - 2026-03-10
- Initial public release.

Troubleshooting:

• If calibre says no matches were found, first make sure the story URL works in your browser, and isn't a restricted work that requires an account to view.
• Using a url: identifier is the most reliable option.
• If you notice that FicHub is giving out of date information, you can request a data refresh for that specific fic on FicHub's discord, otherwise it may take some time for it to get updated automatically.