Metadata and cover plugin for ranobedb. Data comes from https://ranobedb.org/api/v0 (/books, /book/{id}, /release/{id}, /releases for ISBN-related lookup). Mapped calibre fields include title, authors, series, series index, publisher, tags, comments, pubdate, languages, identifiers, and cover when the API provides an image URL (images.ranobedb.org).
- calibre ≥ 5.0.0 (per plugin
minimum_calibre_version) - network access to
ranobedb.organdimages.ranobedb.org
- Download the zip from the releases.
- calibre: Preferences → Plugins → Load plugin from file.
- Enable the source under metadata download settings if it is disabled.
- Metadata download: select this source in calibre’s metadata download flow; supports single books and bulk.
- Book URL: URLs matching
https://ranobedb.org/book/<id>yield aranobedbidentifier viaid_from_url. - ISBN:
identifier:isbntriggers release search; matching releases load linked books. - Title: title search uses the configured preferred language and
max_resultscap.
If ranobedb is set, the plugin fetches that book first. The id is used when match_score is under 1000, or when both title and ISBN are absent from the request. Otherwise the plugin removes ranobedb from the working identifiers and continues with ISBN and/or title search (identify in __init__.py).
Stored under plugins/ranobedb (JSONConfig). Defaults in config.py:
| key | default | description |
|---|---|---|
preferred_lang |
en |
language filter for API search (en, ja, ko, zh-Hans, zh-Hant, es, de, pl, or empty for any) |
use_romaji_title |
false |
use romanized titles when available |
max_results |
5 |
maximum books returned from search / trimming |
ranobedb— book idranobedb-series— series identifier when present in the API responseisbn— read for release lookup
Cover URLs are cached per ranobedb id when a cover is resolved (cache_identifier_to_cover_url).
HTTP failures and exceptions are logged via calibre’s job log (log.info / log.exception in the plugin and API layer).