Plugin: Abs2Emby — AudioBookShelf Local Metadata Plugin for Emby

[Jdiesel 1460]

Abs2Emby — AudioBookShelf Local Metadata Plugin for Emby

I wrote a server plugin that lets Emby read metadata and cover art directly from AudioBookShelf's sidecar files — no internet, no API keys, just the metadata.json and cover.jpg that ABS already generates beside your audiobook files.

GitHub: https://github.com/Jdiesel87/Abs2Emby

What it does

Drop the plugin DLL into your Emby plugins folder, enable the providers in your library settings, and on the next library scan Emby reads the ABS sidecar files and populates your audiobooks with metadata and covers.

It works with both library types:

• Books library → Book entity (authors as people credits, narrators as actors)
• Audio Books library → MusicAlbum + Audio (authors map to Artists/AlbumArtists, narrators map to Composers)

Field mapping highlights

ABS field	Maps to
title	Name + Album
subtitle	Tagline
description	Overview
authors[]	PersonInfo{Writer} (Book) or Artists/AlbumArtists (MusicAlbum/Audio)
narrators[]	PersonInfo{Actor} (Book) or Composers (MusicAlbum/Audio)
series[]/seriesName	Appended to Name as " - Series Name #N"
publishedYear	ProductionYear
isbn/asin	ProviderId
publisher	Studio
genres[]/tags[]	Genres/Tags
cover files	Primary image

When a series is present, Name becomes something like "The Fellowship of the Ring - The Lord of the Rings #1". The Album field always holds the raw title.

Config toggles

Three settings in Dashboard → Plugins → ABS Import → Settings, all default on:

• MapAuthorsAsAlbumArtists — write authors to Artists/AlbumArtists on album/audio items
• MapNarratorsAsComposers — write narrators to Composers on album/audio items
• EnableNfoFallback — try .nfo/desc.txt/reader.txt if metadata.json is absent

Expected file layout

Author Name/
  Book Title (1994)/
    metadata.json      ← generated by AudioBookShelf
    cover.jpg           ← optional, used as primary art
    audiobook.m4b

 

Why

I use AudioBookShelf to manage my audiobooks, but also want them in Emby for the wider media experience. ABS already writes sidecar files — this plugin just picks them up so I don't have to maintain metadata in two places.

---

Looking for testers

This is early but functional. If you use both ABS and Emby, I'd appreciate any feedback:

• Does metadata apply correctly for your library type (Books vs Audio Books)?
• Any issues with the sidecar file format (older ABS versions use different JSON shapes — I've tried to handle the variants but there may be edge cases)
• Cover art showing up as expected?
• Settings page working in the dashboard?

Open an issue on GitHub or reply here. Thanks for taking a look.

ABS_Import.dll