OpenAudible Documentation

This Audio Book Manager lets you catalog and organize your audio book collection. It is optimized for Audible users, but can import MP3/M4A/M4B audio books as well.

Please respect copyright owners by not distributing files created with OpenAudible.

Quick Start

Here is a quick start guide to get you going.

  1. Download, install and launch OpenAudible
  2. Go to Edit: Preferences, and select M4B or MP3 encoding.
  3. Select: Controls: Connect to Audible and log onto your audible account.
  4. Your book list should be loaded, and the option to download and covert them all displayed.
  5. Click yes, or no if you want to manually download or convert your books.
  6. To find the converted book files, select one and right-click "Show MP3" or "Show M4B"
  7. Periodically run Controls: Quick Audible Library Sync to update your latest purchases!
  8. Full help is available under the About Menu (or by pressing F1)

Installation

Install the version for your platform. OpenAudible is an unsigned application. Only download from openaudible.org. You may need to 'approve' the running of OpenAudible from your operating system, and if you use anti-malware or anti-virus apps, you may need to learn how to run unsigned applications.

Choose one of the installers from the official download page. Only 64-bit architectures are supported on x86_64/AMD64, which is most modern computers.

Note: Mac users should open the OpenAudible.dmg file by selecting it in Finder and Control-Clicking the application, then select Open (right-click "Open"). This is due to our not being available in the Apple Store and/or not having a signing certificate. You may also need to update your GateKeeper settings to allow unsigned apps to run.

Connecting to Audible

Note: Before jumping in, its a good idea to set up your main Preferences where you can change the location of saved files, set the audio output format.

Getting your books from Audible is pretty simple. Books can be automatically downloaded and converted to a format that works with any audio player.

Initial Connect to Audible

OpenAudible can read and import your library automatically. OpenAudible uses the Amazon/Audible web browser to connect and never saves your user name or password. However, a credentials token is saved so you can stay connected until you decide to Controls: Log Out of Audible.

  1. Select Controls: Connect to Audible.
  2. Choose your audible region that you normally log into. If you're using an old Audible user name account that isn't an email address, check the box. Then click OK.
  3. Log in using the web browser, answering any CAPTCHAs and verifying account with 2-factor email or text messages to prove your humanity.

Once logged in to your audible account in the browser, your books will be loaded and shown in the OpenAudible window. The OpenAudible Library status should change to Connected: Yes.

After a library scan, you'll be asked if you want to download and convert your books. If you click No, you can manually select books to download and or convert.

Syncing your Library

When you purchase new audiobooks, you can select Controls: Quick Audible Library Sync which will add any newly added books.

You can select Controls: Full Audible Library Sync to get all of your books and update meta data that may have changed, such as ratings or book descriptions.

Downloading Audible Books

Books that were not automatically downloaded can be downloaded by selecting them selecting Action: Download.

Downloading a book can take several minutes. To see the progress click on the "Library Status:Downloads" panel item to see books currently downloading or waiting to be downloaded. Select a book and look at the "State" under the Book Info panel to see its download or conversion state.

Once a book is downloaded, it can be manually or automatically converted to the audio format of your choice.

Converting Audible Files

Convert your Audible AAX files to M4B or MP3 easily by selecting a book and selecting Action: Convert to ... or convert them all by Controls: Convert All to ... .

We recommend using M4B for most use cases. But if you have an MP3 player that doesn't support M4B files, you can choose to convert your audiobook files to MP3.

Audible files are kept in the AAX directory. Once converted, you may decide to delete the AAX files to save space.

Preferences

You can set a location for saved audiobooks, set the conversion output format, choose a language, or enable dark mode.

Use Edit: Preferences view and change the application preferences.

Main Window

From left to right, top to bottom, the OpenAudible main window has a search bar, version/news indicator, Library Status Panel, Audio Book Info, Summary Panel, and Audio Book table that lists your books.

Searching

The search bar at the top right of the app allows you to filter books by keywords. Use CTRL-F to activate the search. Use Escape to clear the search results and display all books.

To the right, a line of text displays the current version, and if there are any upgrades or news available.

Library Status

This shows your library stats.

These stats are updated periodically and reflect our best attempt at determining these values. For instance, Hours depends on being able to determine a book's duration.

Note: Click on any blue label to see books that match that filter. For instance, click 'Downloading' to see all books that are being downloaded or queued for downloading.

Audio Book Info

Information about a selected book is displayed here. This info is collected from web or meta tags and cannot (at this time) be edited.

The blue labels on the left side can be clicked on to filter books by title, author, narrator, genre, or publisher.

Clicking the blue text on the right side will open the browser to display the audible page for the title, author, narrator, genre, or publisher.

The info for each data element is self-explanatory. The State field shows any errors or tasks that can be performed. The ID contains the Product_ID/ASIN.

Menus

Importing/Exporting

Exporting JSON and CSV

To export a list of your books (not the audiobooks files), select File: Export Book List and set the "Save as Type:" to either JSON or CSV.

Your audible library can be exported as a web page, json file, or .csv (Excel) file from the File menu, so you'll have a list of all your books.

Exporting Web Page

This optional feature lets you export your books as a web page. if you want to access your books on your own personal web server. Please ensure that you password protect this file to prevent the unauthorized distribution of copyrighted works.

This feature is likely to change in the future. It creates a rather large copy of all the converted books, doubling the amount of space needed to save your books.

Importing

Importing is recommended when you can't download and import books directly from Audible using the Library Sync features.

Use the File: Import menu, or drag and drop "whole book audio files" of type MP3, M4B, M4A or AAX files onto the Library Status Panel of the OpenAudible application.

Note: Only import full books and not books split into multiple parts. To import a book that contains multiple audio files, please see Joining Files in the next section.

Splitting and Joining Audio Files

OpenAudible prefers 1 audio file per audio book. Its how our software was designed. However, many people prefer an audio book split by chapter.

Its also possible to download a book in a zip file that may contain multiple parts, that can be combined to create a whole book in a single audio file.

Join Audio Files

Some audio books contain multiple audio files. To import these into your library, or to simply have a single audio file for each book, you can use the Join Audio Files command, under the File Menu. To join audio files into a single mp3 file, choose "Join Audio Files" from the File menu. Select a directory that contains all the audio files. If an image file is present, it will be used as the cover art. Audio files in the directory will be sorted alphabetically and joined. Next, select a destination directory for the output file. It can be the OpenAudible's "temp" directory, or anywhere. After joining, you will be asked if you want to import (move) the file to your OpenAudible library.

Split By Chapter

You can now export a single book as a folder of mp3/m4a files. Do put split audio files into the OpenAudible working (mp3/m4a) directories or attempt to import them into OpenAudible, or you could end up with a mess.

  1. Select one or more books and select Action: Split by Chapter
  2. and set a destination directory.
  3. To Select a file not in your OpenAudible library, select File: Split by Chapter and select any MP3 file you wish to split.
  4. Select a destination directory location for the split book parts
  5. If chapter data is present, the audio book will be split into multiple chapters, leaving the original file untouched.

Do not import these files into OpenAudible-- OpenAudible is designed for 1 audio file per book.

Ignored Books

Some books in your library might be lame. Maybe you'd rather not download them. For those books, just select them and Action: Ignore Book to add it to the list of books to be ignored.

To restore ignored books

  1. Click on the "Ignored:" Library Status in the upper-left of the main window
  2. Your ignored books will be shown. Select one or more books and right-click or Action: Unignore Book(s) to remove the books from the ignored list.

Unsupported Books

OpenAudible works with the books you buy that Audible lets you download as "AAX" files. Podcasts, Romance Series, Amazon Prime, Audible Plus, free books, and books that have been returned cannot be downloaded.

AAX and AAXC files that have been downloaded from Android or Kindle devices cannot be converted. Instead, use OpenAudible to connect to your library and download what it can.

To check if your book is downloadable, open a regular web browser, click on your library, and search for the name of the book. If there is a "Download" button, it should be available to download. Without a download button, there is usually an explanation of why it can't be downloaded.

If you have an AAX file that won't convert, delete or move the file and re-download it using OpenAudible. You can verify if the book is downloadable by viewing your library in Audible web browser and see if there is a "download" button next to it.

License

OpenAudible requires a license to use all of its features. A low-cost license can be purchased from openaudible.org/purchase. One license can be used on up to 5 personal audible accounts. Not for commercial use. Use only for archiving and backing up your audio book purchases.

Activating the license is done through the About: License... menu. If the application is unable to create a license online, an offline license tool is available at openaudible.org/license.

If you exceed the limit of 5 audible accounts on one license, your license will not allow you to work with books from additional Audible accounts.

Uninstalling

Uninstalling uses common practices. If you used an installer, there will be an uninstaller.

Mac and AppImage users can toss the application into the trash.

Your settings files can be deleted, and are saved in the "Preferences Directory" displayed in the preferences. The default location on Windows is C:\Users\NAME\OpenAudible. On Mac it is /Users/NAME/Library/OpenAudible. On Linux ~/OpenAudible.

Additional Help

OpenAudible may stop working at any time, due to changes in Audible systems or web their site. If this happens, check for an update or open issues.

Submitting a bug report from the About menu will send diagnostic information to developers. For best results, restart OpenAudible, reproduce the problem, then fill in the bug report with as many details as possible and click send.

Please do not share your books. Any personal meta data in the audible files is copied to the output files.

Suggestions welcome by creating a github issue or by sending a bug report from the menu.

This software is copyright the authors of the software.