GithubHelp home page GithubHelp logo

cabalist / audiobooks.bundle Goto Github PK

View Code? Open in Web Editor NEW

This project forked from seanap/audiobooks.bundle

0.0 1.0 0.0 67 KB

My personal variation of macr0dev's Audiobook metadata agent for Plex

Python 100.00%

audiobooks.bundle's Introduction

SeaNap's Audiobook (Audible) metadata agent

What is this?

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

This agent sets metadata for your Plex Audiobook library, scraping data from Audible.com. It uses the Album Artist tag as the books Author and uses the Album Title tag as the Book Title. All audio files will need to be tagged correctly in order for this thing to do its job.

Differences between my version and Macr0dev's

  • The Narrator is mapped to Style.
  • Only Genres put in the Genre tag.
  • The series is currently pulled into AlbumSort tag.

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


Installation

  1. Download my repo by clicking Here.
    • Alternatively, click the green 'Code' dropdown button and select “Download 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 "-master" so you are left with the foldername “Audiobooks.bundle”
    • Bundles downloaded from GitHub will usually have extra identifiers appended to the bundle’s filename, such as “-master”.
  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. Restart Plex Media Server to make sure that the new plugin will be loaded.
Return to Guide

Plex Audiobook Guide


Metadata supplied to Plex:

id3 Tag Plex Tag
ALBUM Title
ALBUMARTIST Author
ALBUMSORT Sort Album
Genre1/Genre2 Genre1, Genre2
cover Poster
Scrapped by Audible Agent Plex Tag
Narrator Style
Release Date Originally Available
Publisher's Summary Review
Series Title Collection (not working atm)
Production Studio Record Label

Library Creation Options:

  • Create a BASIC MUSIC LIBRARY (not a premium Plex music library)
  • DO NOT check Use Embedded Tags
  • DO check Store Track Progress
  • Agent - Select Audiobooks

Agent Configuration Options:

If you're in the US and want to scrape from Audible.com - you're all set!

If you're NOT in the US, or just want more flexibility with your searches you have options:

  • Manually Select Audible Site: This option allows you to manually select which site you're going to scrape.

  • If this is not checked, the language you selected for the library, or the language selected for a manual match will be used to select which site to scrape from.

  • Select Audible site to use: This option is ignored if the Manually Select Audible Site box is not checked.

Tips for greatest success:

  • Use mp3tag to auto tag and rename files https://github.com/seanap/Audible.com-Search-by-Album
  • Set "Album" tag in audio file as the book title
  • Set "Artist" tag in audio file as the book author
  • Manual 'match' will use the Author/Artist field if it's present, but you cannot enter it manually. Only the title.
  • Make sure all the tracks have the same Albumartist and Album, and also have correct Track Number tags.
  • Store each in a folder %author% \ %series% \ %year% - %album% \ %album% (%year%) - pt(%track%)
  • If this agent matches two different books as the same book, which looks like a duplicate in Plex, Unmatch BOTH books and start by manually matching the incorrect book, then re-match the book that was correct.

Notes:

-Title data in parens () such as (Unabridged) is automatically removed before search. I've found this improves the results and matching.

-Currently, I don't have a great source for author data. What populates now (if any) is being done automatically from last.fm. You're welcome to go add some data there. This was kind of a happy accident.

-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

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

-Orignal and bulk of code by Macr0dev https://github.com/macr0dev/Audiobooks.bundle

audiobooks.bundle's People

Contributors

cabalist avatar gene1wood avatar seanap avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.