seanap / Audiobooks.bundle

Audiobook metadata agent for Plex
133 stars 10 forks source link

:bangbang:Updated to new agent Audnexus:bangbang:

Audiobook (Audible) metadata agent

CodeFactor

What is this?

A Plex Metadata Agent for Audiobooks stored in a music library.

This agent sets metadata for your Plex Audiobook library by pulling directly from the internal Audible API. It uses the Album Artist file tag as the books Author and uses the Album Title file tag as the Book Title. All audio files will need to have these two tags tagged correctly in order for this thing to do its job.

Differences between Audnexus and Macr0dev's

This version allows for better filtering and cleaner browsing in plex and various audiobook apps (such as PlexAmp, BookCamp, Prologue), a must have for large libraries. Everything else is the same.


Installation

  1. Download the plug-in by clicking Here.
    • https://github.com/djdembeck/Audnexus.bundle/archive/refs/heads/main.zip
  2. The plug-in bundle will be located within a zip archive. Unzip the archive.
  3. Edit the bundle’s folder name and remove "-main" so you are left with the foldername “Audnexus.bundle”
    • Bundles downloaded from GitHub will usually have extra identifiers appended to the bundle’s filename, such as “-master”, it is importaint that the folder name ends in .bundle
  4. Copy or move the plug-in bundle into the Plug-Ins folder on the computer running Plex Media Server
    • Windows: %LOCALAPPDATA%\Plex Media Server\Plug-ins
    • macOS: ~/Library/Application Support/Plex Media Server/Plug-ins
    • Linux: $PLEX_HOME/Library/Application Support/Plex Media Server/Plug-ins
  5. Go you your Audiobook Library > Edit > Advanced - This will load the plug in, return to guide for initial config settings.
    Return to Guide

    Plex Audiobook Guide


Metadata supplied to Plex:

id3 Tag Plex Tag
ALBUM Title
ALBUMARTIST Author of Album
ALBUMSORT Sort Album
ALBUMARTISTSORT Sort Name [Not used]
Genre1/Genre2 Genre1, Genre2 [Not used]
cover Poster [Not used]
ARTIST Artists on Track
Set by Audible Agent Plex Tag
Narrators Style
Series Mood
Release Date Publication Date
Publisher's Summary Review
Production Studio Record Label
Genres Genre
Rating :star::star::star::star::star:

Library Creation Options:

Tips for greatest success:

Notes:

-Title data in parens () such as (Unabridged) is automatically removed before search.

-The first two genre tags show up in the top right when viewing the album/book. Genre tags are listed in the following order: Genre1, Genre2, Genre3... etc.

-You can filter by the various tags that are added to each book. Be it author, series, narrator, etc.

-Orignal code by djdembeck