Skip to content

Neurrone/beets-audible

Repository files navigation

Beets-audible: Organize Your Audiobook Collection With Beets

This is a plugin that allows Beets to manage audiobook collections.

It fetches audiobook metadata via the Audible and Audnex API. With this data, it ensures books have the correct tags and makes the collection ready to be served by Plex, Audiobookshelf or Booksonic.

Motivation

seanap's audiobook organization guide describes a workflow for adding tags to audiobooks and moving the files to the right folders.

However, it relies on using Mp3tag, a gui tool which does not lend itself to automation. Mp3tag works only on Windows.

This Beets plugin solves both problems.

Installation

  1. Install via pip: pip install beets-audible beets-copyartifacts3 (copyartifacts is optional but recommended). See the next section instead if you're running Beets in Docker (highly recommended as it makes it easier to maintain a separate Beets installation dedicated to audiobooks).

  2. Use a separate beets config and database for managing audiobooks. This is the recommended Beets config for this plugin:

    # add audible to the list of plugins
    # copyartifacts is optional but recommended if you're manually specifying metadata via metadata.yml, see the "Importing non-audible content" section
    # also add the "web" plugin if using the docker image
    plugins: audible copyartifacts edit fromfilename scrub
    
    directory: /audiobooks
    
    # Place books in their own folders to be compatible with Booksonic and Audiobookshelf servers
    paths: