{"id":27609,"library":"beets-audible","title":"beets-audible","description":"Beets plugin for audiobook management. Version 1.4.0 requires Beets 2.7.1–2.7.x, Python ≥3.10. Released occasionally.","status":"active","version":"1.4.0","language":"python","source_language":"en","source_url":"https://github.com/Neurrone/beets-audible","tags":["beets","plugin","audible","audiobook","metadata"],"install":[{"cmd":"pip install beets-audible","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Core dependency; plugin requires Beets >=2.7.1,<2.8","package":"beets","optional":false},{"reason":"Required for file metadata manipulation; version <0.14.0 in v1.3.1","package":"mediafile","optional":false}],"imports":[{"note":"The plugin is part of beets plugin namespace, not a standalone module.","wrong":"import beets_audible","symbol":"audible","correct":"from beetsplug import audible"}],"quickstart":{"code":"# Add 'audible' to your beets config.yaml plugins list\n# Example: plugins: audible\n# Then run: beet fetch -a [album_id]\nimport os\nalbum_id = os.environ.get('ALBUM_ID', 'B0EXAMPLE')\nprint(f\"Configure plugin and run: beet fetch -a {album_id}\")","lang":"python","description":"Enable the plugin by adding 'audible' to your beets plugins list, then use the fetch command."},"warnings":[{"fix":"Ensure beets is pinned to 2.7.x (e.g., beets==2.7.1).","message":"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).","severity":"breaking","affected_versions":"1.4.0"},{"fix":"Upgrade Python to 3.10+.","message":"Requires Python >=3.10. Dropped support for Python 3.9 in v1.3.0.","severity":"breaking","affected_versions":">=1.3.0"},{"fix":"Edit beets config.yaml, add 'audible' to the plugins list.","message":"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.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Do not import the module directly. Enable 'audible' in your beets config and run beets commands (e.g., 'beet fetch').","cause":"Trying to import 'beets_audible' directly, but the plugin is loaded by beets via its plugin system.","error":"ModuleNotFoundError: No module named 'beets_audible'"},{"fix":"Ensure 'beets-audible' is installed in the same Python environment as beets (e.g., 'pip install beets-audible'). Check beets version compatibility.","cause":"Plugin not installed or wrong Python environment; or conflicting beets version.","error":"beets.config.ConfigError: Error loading plugin audible: cannot import name 'audible' from 'beetsplug'"},{"fix":"Provide a valid album ID as argument: 'beet fetch -a B0EXAMPLE'.","cause":"Album ID not provided or incorrect; fetch command requires an album ID (ASIN or Audible URL).","error":"audible.fetch.FetchError: No ASIN or ASINs found"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}