Registry / data / beets-audible

beets-audible

JSON →

library1.4.0pypypi✓ verified 84d ago

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

data

pip install beets-audible

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · BEETS-AUDIBLE

beets-audible

datapythonv1.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

audible

✓ from beetsplug import audible

✗ import beets_audible

The plugin is part of beets plugin namespace, not a standalone module.

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}")

Debug

Known issues

breakingRequires 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).

affects: 1.4.0

breakingRequires Python >=3.10. Dropped support for Python 3.9 in v1.3.0.

fix

Upgrade Python to 3.10+.

affects: >=1.3.0

gotchaThe 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.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'beets_audible'

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').

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

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.

audible.fetch.FetchError: No ASIN or ASINs found

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'.

Upgrade

Version history

1.4.0latest on PyPI · released Mar 22, 2026

Audit

Dependencies

beetsrequiredCore dependency; plugin requires Beets >=2.7.1,<2.8

mediafilerequiredRequired for file metadata manipulation; version <0.14.0 in v1.3.1

Agent activity

19 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Neurrone/beets-audible ↗

packagehttps://pypi.org/project/beets-audible/ ↗

docshttps://github.com/Neurrone/beets-audible ↗

changeloghttps://github.com/Neurrone/beets-audible/blob/main/CHANGELOG.md ↗