[WS] Audible via API

Florian · April 9, 2024, 10:02am

Audible API Tag Source

This Audible Tag Source allows for searching audiobooks via the external Audible API.

Download

Installation

Requires Mp3tag v3.22 or Mp3tag for Mac v1.8.6.

Windows

In Mp3tag, use File → Open configuration folder and extract the contents of the downloaded archive to data\sources\. I suggest using https://www.7-zip.org to extract the archive.

macOS

In Mp3tag, use Tag Sources → Open Tag Sources Folder and extract the contents of the downloaded archive.

Supported Fields

Mp3tag	Audible
`ALBUM`	Title
`ALBUMARTIST`	Author
`ALBUMARTISTS`	List of authors
`ALBUMSORT`	If `ALBUM` only, then Title, if `ALBUM` and `SUBTITLE`, then Title - Subtitle, if `SERIES`, then Series Series-Part - Title
`ARTIST`	Author, Narrator
`ASIN`	Amazon Standard Identification Number
`COMMENT`	Publisher's Summary (MP3)
`COMPOSER`	Narrator
`CONTENTGROUP`	Series, Book #
`COPYRIGHT`	Copyright
`DESCRIPTION`	Publisher's Summary (M4B)
`EXPLICIT`	Set to `1` if adult content
`FORMAT`	Format type, e.g., `unabridged`
`GENRE`	Genre1/Genre2 (using the configured delimiter for multiple values)
`ISBN`	International Standard Book Number
`ITUNESADVISORY`	Set to `1` if adult content, `2` if clean (M4B)
`ITUNESGAPLESS`	M4B Gapless album = 1
`ITUNESMEDIATYPE`	M4B Media type = Audiobook
`LANGUAGE`	Language
`MOVEMENT`	Series Book #
`MOVEMENTNAME`	Series
`PUBLISHER`	Publisher
`RATING WMP`	Audible Rating (MP3)
`RATING`	Audible Rating
`RELEASETIME`	Audiobook Release Date
`SERIES-PART`	Series Book #
`SERIES`	Series
`SHOWMOVEMENT`	M4B Movement, if Series then set to `1` otherwise left out
`SUBTITLE`	Subtitle
`TMP_GENRE1`	Genre 1 (if single genre only configuration setting is enabled)
`TMP_GENRE2`	Genre 2 (if single genre only configuration setting is enabled)
`WWWAUDIOFILE`	Audible Album URL
`YEAR`	Audiobook Release Year

I've tried to be as compatible to the existing Audible Tag Sources as possible. Let me know if there is something missing or can be changed to improve compatibility with existing systems.

Configuration Settings

Add narrator to artist

If enabled, the narrator is added to the artist field.

Add single album artist only

If enabled and the audiobook has multiple artists, only the first artist is added to the ALBUMARTIST field and the complete list of artists is stored in ALBUMARTISTS.

Add single genre only

If enabled and the audiobook has multiple genres, only the first genre is added to the GENRE field and TMP_GENRE1 and TMP_GENRE2 have additional genres.

Use full release date as year

If enabled, the full release date YYYY-MM-DD is used for the year field (otherwise it's YYYY only).

Delimiter for multiple values

The string to use as a delimiter for multiple genres.

Changelog

0.6.4 (2026-05-05) @Florian

Changed to use standard capitalization for format and language. (#71173)
Prevent use of empty SERIES-PART in ALBUMSORT and CONTENTGROUP. (#71175)
Prevent ARTIST to start with comma if only NARRATOR is provided. (#71175)

0.6.3 (2025-10-30) @bblatt

Added support for 2400x2400 px cover sizes if available.

0.6.2 (2025-09-06) @Florian

Added configuration option to use full release date for YEAR field.

0.6.1 (2025-05-16) @Florian

Changed to filter non-author roles (e.g., translators) from list of authors.

0.6.0 (2025-05-15) @bblatt @Florian

Added support for field COPYRIGHT.
Added support for field EXPLICIT and ITUNESADVISORY.
Added support for field FORMAT.
Added support for field ISBN.
Added support for field LANGUAGE.
Added support for field RATING WMP.
Added configuration setting to use first album artist only and store complete list in ALBUMARTISTS.
Added importing of additional genres to TMP_GENRE1 and TMP_GENRE2 if first genre only is stored in GENRE.
Added Tag Sources for audible.co.jp
Added Tag Sources for audible.com.au
Added Tag Sources for audible.com.br
Added Tag Sources for audible.es
Added Tag Sources for audible.it
Added Tag Sources to directly search by filename.
Changed to write TMP_GENRE1 and TMP_GENRE2 if single genre only configuration setting is enabled.
Fixed preview URL to use locale-specific URL.
Removed code duplication in Search by ASIN Tag Sources.
Added README