[Metadata Source Plugin] Romance.io

[plain-cover]

This plugin adds Romance.io as a metadata source in Calibre. Romance.io is a community site for romance novels with detailed reader tags (tropes, themes, settings, etc.), steam ratings, and user star ratings.

When you download metadata for a book, Calibre will search Romance.io, and if there is a match, the plugin:

• Finds the Romance.io book ID and shows a link to the book's Romance.io page in the book details panel
• Offers Romance.io cover art as a download option alongside other sources
• Fills in series, series number, and publication date metadata from Romance.io
• Maps Romance.io genre tags (e.g. time travel, enemies to lovers, small town, nerdy hero) to Calibre tags via a configurable table

The stored romanceio identifier is also used by the companion Romance.io Fields plugin to fetch ratings and tags into custom columns.

For more detailed instructions, see the plugin's GitHub.

Installation:
In Calibre: Preferences > Plugins > Get new plugins, search for "Romance.io", and click Install. Or download the zip from GitHub and install via Preferences > Plugins > Load plugin from file.

Usage:

1. After installing, go to Preferences > Metadata download and check the box next to Romance.io to enable it as a source.
2. Select a book in your library, click Edit metadata, then click Download metadata. If a match is found on Romance.io, you'll see "See at: Romance.io" in the results. Click OK to link your Calibre library book with the book found on Romance.io and download metadata.

Configuration:
Preferences > Metadata download > Romance.io > Configure selected source

• Metadata fields to download - choose which fields to pull (cover, series, tags, date, etc.)
• Tag mappings - map Romance.io tags to Calibre tags. Only mapped tags are imported.

Wrong book matched? If your title or author in Calibre differs from Romance.io (different edition name, spelling, etc.), the automatic search may not work. You can still manually link the book: open the book's detail page on Romance.io (URL contains /books/, not the series page), copy the ID from the URL (e.g. 5484ecd47a5936fb0405756c), then in Calibre open Edit metadata > Ids and add romanceio:5484ecd47a5936fb0405756c.

Notes:

• The plugin tries the Romance.io JSON API first (fast, no browser). If the API returns no result, it falls back to loading the page in the browser. If a browser window opens, ignore it - it will close automatically.
• Only English is supported for now.

Source code, documentation, & issue reporting: GitHub

If you find this plugin useful, a small donation is appreciated!
Donate via PayPal

[plain-cover]

Development Builds

If you want to test the latest unreleased changes before they make it into an official release, development builds are available on GitHub.

Development builds may contain bugs. If you encounter an issue with a development build, please report it on GitHub Issues with:

• The version number of the development build you are using (shown in Preferences > Plugins)
• Steps to reproduce the issue
• Any error messages or logs (right-click the Preferences gear icon and choose Restart in debug mode for verbose output; or click the job count in the bottom-right of Calibre, select the failed job, and click Show job details)

To install a development build: download the zip from GitHub and install via Preferences > Plugins > Load plugin from file.

[scarlettruin]

I have tried using this and successfully brought the tags into a field, but when you map them via preferences>metadata download>romance.io plugin ot doesn't do anything. It seems to be because it pulls through fields as a continuous single option instead of a list of tags. It only shows as a single 'tag' even when there's 20+ tropes from romance.io

[plain-cover]

Originally Posted by scarlettruin

I have tried using this and successfully brought the tags into a field, but when you map them via preferences>metadata download>romance.io plugin ot doesn't do anything. It seems to be because it pulls through fields as a continuous single option instead of a list of tags. It only shows as a single 'tag' even when there's 20+ tropes from romance.io

Thank you for trying out the plugin! I can't seem to replicate your issue. From my machine, I can go through the steps in the screenshots below and get the tag mapping working for multiple fields. We must be doing something differently!

I did find a setting that might be related and I just updated the plugin to 1.0.3 in case that addresses your issue (it should be available in Calibre shortly), as well as making the Readme more clear. Can you try it out and, if it's still not working, give me some additional info:

• If you are doing any steps differently than I am in the attached screenshots, or if not, where your results are different from mine
• The Romance.io link to the book you're using
• The exact values for "Romance.io Genre" and "Maps to Calibre Tag" that aren't working
• What result you're getting vs. what result you expected

With that info I should be able to figure out what's going wrong!