[BETA] Okuzukey - Metadata plugin for Books/Comics/Manga

[SoliFlix 42]

Hi all,

I’ve been building Okuzukey, a metadata plugin for Emby designed for books, comics, manga, and light novels.

What it does:
- Local metadata grabber: Supports NFO, Calibre metadata.opf (or an EPUB’s internal OPF if no sidecar exists), and ComicInfo.xml inside .cbz/.cbr.
- Covers: Uses local sidecar images if present; otherwise, it extracts them directly from inside .cbz/.cbr/.epub.
- Optional Komga integration: Connect to your own Komga server (opt-in, off by default) to fetch metadata and covers.
- Performance tweaks: Configurable logging levels and Komga request concurrency.

What it doesn’t do:
- No embedded metadata/covers for formats like PDF, MOBI, or AZW3 (though sidecar NFO/OPF/covers still work perfectly for them).
- No public online sources (Google Books, ComicVine, AniList, etc.) - dealing with rate limits and weak free-text matching wasn’t worth it for now.

Emby limitations (not by the plugin):
The Book item type in Emby currently has a limited field set. For example, it lacks a proper series name field or People/Authors display in the UI. While the plugin successfully parses writers and artists from your files, Emby simply doesn’t display them for books yet.

Here's a video of a metadata refresh with a bit over 2500 random books (epub, cbr, cbz) - everything local on Windows (both the server and the files), which is why the refresh took less than 25 seconds to read it all, including covers.

 

Tested on: Windows Emby Server 4.10.x

Installation:
1. Download the .dll
2. Copy it into your Emby Server's plugin folder
3. Restart your Emby Server

Emby.Okuzukey.dll

If you give it a try and see anything missing or wrong - a short feedback would be nice.

Thanks!

[Luke 43491]

Thanks for sharing.

[SoliFlix 42]

Okuzukey 1.0.2.0

Fixes:
- Descriptions stored as HTML are converted to plain text.
- EPUB3 ISBNs are recognized.

New:
- Popup for signed-in admins when Komga is unreachable, rejects the API key, or is selected in a library but not enabled.
- "Test connection" button in the Komga settings.

Spoiler

Spoiler

 

Emby.Okuzukey.dll

[SoliFlix 42]

Okuzukey 1.0.2.2

- Fixed: covers could go missing after an Emby restart (refresh the images of affected books once).
- Hardening: all metadata (titles, descriptions, genres, tags, …) is stored as plain text without HTML, only real image files are used as covers (SVGs are rejected), and XML files with embedded DTDs are rejected.

Okuzukey security measures:
- Book content is never executed. Okuzukey only reads metadata files and the cover image.
- Archives (CBZ/CBR/EPUB) are never extracted to disk, so path traversal and file overwrite are not possible.
- File sizes are limited, which protects against zip bombs and oversized files.
- XML is parsed safely: DTDs are ignored and no external files are ever loaded.
- All metadata is stored as plain text without HTML.
- Only real image files are used as covers. SVGs are rejected, as they can contain malicious code.
- The cover endpoint only serves covers of books in your Emby libraries, never arbitrary files.
- Your Komga API key is only sent to your configured Komga server and never appears in popups or logs.

Emby.Okuzukey.dll

 

[GrimEvil 109]

So far so good and all my eBooks now have covers