beets-audible

raw JSON →

1.4.0 verified Sat May 09 auth: no python

Beets plugin for audiobook management. Version 1.4.0 requires Beets 2.7.1–2.7.x, Python ≥3.10. Released occasionally.

pip install beets-audible

Common errors

error ModuleNotFoundError: No module named 'beets_audible' ↓

cause Trying to import 'beets_audible' directly, but the plugin is loaded by beets via its plugin system.

fix

Do not import the module directly. Enable 'audible' in your beets config and run beets commands (e.g., 'beet fetch').

error beets.config.ConfigError: Error loading plugin audible: cannot import name 'audible' from 'beetsplug' ↓

cause Plugin not installed or wrong Python environment; or conflicting beets version.

fix

Ensure 'beets-audible' is installed in the same Python environment as beets (e.g., 'pip install beets-audible'). Check beets version compatibility.

error audible.fetch.FetchError: No ASIN or ASINs found ↓

cause Album ID not provided or incorrect; fetch command requires an album ID (ASIN or Audible URL).

fix

Provide a valid album ID as argument: 'beet fetch -a B0EXAMPLE'.

Warnings

breaking Requires Beets >=2.7.1,<2.8. Older versions of beets-audible (<=1.3.x) require different Beets version ranges (2.6.1–2.6.x). ↓

fix Ensure beets is pinned to 2.7.x (e.g., beets==2.7.1).

breaking Requires Python >=3.10. Dropped support for Python 3.9 in v1.3.0. ↓

fix Upgrade Python to 3.10+.

gotcha The plugin must be enabled in beets config as 'audible' (not 'beets-audible'). Common mistake: adding the PyPI package name instead of the plugin name. ↓

fix Edit beets config.yaml, add 'audible' to the plugins list.

Imports

audible
wrong
```
import beets_audible
```
correct
```
from beetsplug import audible
```
The plugin is part of beets plugin namespace, not a standalone module.

Quickstart

Enable the plugin by adding 'audible' to your beets plugins list, then use the fetch command.

# Add 'audible' to your beets config.yaml plugins list
# Example: plugins: audible
# Then run: beet fetch -a [album_id]
import os
album_id = os.environ.get('ALBUM_ID', 'B0EXAMPLE')
print(f"Configure plugin and run: beet fetch -a {album_id}")