OpenAudible Documentation

This Audiobook Manager lets you catalog and organize your audiobook collection. It is optimized for Audible users, but can import MP3/M4A/M4B audiobooks as well.

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

OpenAudible loves, but is unaffiliated with audible.com.

Quick Start

Here is a quick-start guide to get you going.

1. Download OpenAudible for Mac, Windows, or Linux from openaudible.org.
2. Install and launch OpenAudible
3. Go to Edit: Preferences, and select M4B or MP3 audio output format. M4B encoding is the recommended default setting, but MP3 can be set in the Preferences.
4. To use a custom directory for your audiobook library, use the File: Manage Libraries to move the library to a new location with a large drive capacity.
5. Select: Controls: Connect to Audible and log into your Audible account.
6. Your book list should be loaded, and the option to download and convert them should be displayed.
7. Click yes, or you can click no to manually download or convert your books.
8. To manually download or convert, select one or more books and use the Action Menu to download or convert the selected audiobooks.
9. Downloading and conversion can take a while. You'll need to be patient!
10. At any time, click on an audiobook and look at the Audiobook Info: State to see if it has been downloaded, converted, or is ready to play.
11. Click on the "Downloading" or "Converting" Library Status lines to see which books are downloading or converting. Click on one to see detailed progress.
12. To find the converted book files, select one and right-click "Show MP3" or "Show M4B"
13. Periodically run Controls: Quick Audible Library Sync to update your latest purchases!
14. Full help is available under the About Menu (or by pressing F1) which shows this document!

Installation

Install the version for your platform. OpenAudible for Windows and Mac is a digitally signed application.
You may be prompted that the application may not be safe to run; however, you can safely run it if the certificate shows it as valid.

Choose one of the installers from the official download page. OpenAudible supports 64-bit x86_64/AMD64 and Apple Intel/Silicon architectures.

• Mac Users: OpenAudible is a universal binary for Intel and Apple Silicon. Running on Apple Silicon is wicked fast.
  Open the DMG and drag OpenAudible to the Applications directory.
  Or via Homebrew: brew install --cask openaudible
• Windows Users: Double click installer and click through the panels.
  Or, install from the command line (helpful for the vision impaired):
  OpenAudible_win.exe -q -overwrite Or via Chocolatey: choco install openaudible
  Installing with is also an option.
• Linux Users: OpenAudible has an installer (.sh), .deb file, .rpm, and AppImage.
  One Line Install (quietly): wget -qO- https://openaudible.org/latest/OpenAudible_x86_64.sh | sh -s -- -q
  OpenAudible needs the following libraries: apt install libwebkit2gtk-4.1-0 libwebkit2gtk-4.1-dev
• Docker Users: Docker provides an experimental way to try OpenAudible from a web browser. It is not recommended for normal use, but it can be a way to try the software in a sandbox.

Note: Mac users may need to open the OpenAudible.dmg file by selecting it in Finder and Control-Clicking the application, then select Open (right-click "Open"). You may also need to update your GateKeeper settings to allow apps not from the App Store to run.

Connecting to Audible

Note > Before jumping in, it is a good idea to set up your main Preferences to set the audio output format and other settings.

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 username or password. However, a credentials token is saved so that 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 username 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 message 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 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 any metadata 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.

Some books include a PDF companion file. If available, those will be downloaded when the audio is downloaded.

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, as converting to mp3 will always add some loss and may increase the file size. But if you have an audio player that doesn't support M4B files, you can choose to convert your audiobook files to MP3.

Note: To convert your books to MP3 instead of the default M4B format, set the Audio Output Format to MP3 in the Preferences, which can be accessed by clicking on the icon in the upper right or by selecting Edit: Preferences.

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

Playing Audiobooks

Once an audiobook has an MP3 or M4B file associated with it, it is ready to play and will be marked with a green dot or folder icon meaning it is ready to use on most audio players.

Select an audiobook and click the Play icon at the top of the main window to play the Audiobook.

Select an audiobook from the main table and use the Action menu to act upon it, for instance to play or reveal it in the desktop. with a green icon and use the Action Menu to see and use the Action: Play to open the audio file in a media player (such as VLC or on Mac, the 'Books' application.).

Action: Play to open the audio file on your computer.

As of version 4.4, a built-in player is available. To use an external player, you can edit the player in the Preferences under Applications and Browsers.

Action: Reveal ... shows the list of files available for the book. Select the one for MP3 or M4B to show it in your desktop (Windows Explorer or macOS Finder).
From there, it can be imported into your favorite audio player.

All media players have a way to import a mp3 (or m4b) file from your computer if you know the file's location. We do not have instructions for any players at this time, a web search will give you plenty of resources.

OpenAudible supports Drag-and-Drop. You can drag an audiobook from the book table onto a directory or Drag-and-Drop ready application. To demonstrate, try dragging a book from OpenAudible to VLC and the book will start to play.

For iOS, we like MP3 Audiobook Player Pro and BookPlayer.

For Android, try Smart AudioBook Player and Google Play Books.

We are always looking for recommendations on good audiobook players and how-to guides on putting your audiobooks on other players. Please feel free to send us suggestions on which players you like and if there are any special steps required to get an audiobook loaded.

Preferences

You can set the conversion output format, choose a language, font or color theme.

Use Edit: Preferences view and change the application preferences.

To set the Library Location, use the Manage Libraries feature.

• Directories

  Some directories used by the application can be changed. The "Show" button will reveal the directory in the desktop file system.

  Choose a location for your book library and output web pages.

  • Web Directory: Where the optional web page is saved
  • Preferences: Where application preferences, logs, and temp files are saved. See below about this Advanced setting.

  Note: To change your Library Directory, go to the File: Manage Libraries menu.

  Advanced: To change the location of the OpenAudible preferences directory, quit the application, move the directory somewhere else, and set an environment variable named "OPENAUDIBLE_HOME" to point to the new location. When you re-launch, OpenAudible should display the new Preferences directory.

• Audio Output Format

  Your Audible books can be exported as either M4B (audiobook format) or MP3 (universal compressed audio format). M4A is also supported, but not recommended, since it is not a standard audiobook format.

  For the fastest conversion and best audio quality, we recommend using M4B, as it keeps the original encoding from Audible, and is supported by all major audiobook players. Use MP3 if your audio player doesn't support M4B.

  You can change the MP3 quality, which trades quality for file size. It is generally best to leave this alone unless you have a player with limited storage capacity. Again, for best quality, use M4B format.

  Because audiobooks do not typically contain music (or high frequencies), a medium bitrate setting will produce excellent results. Only the lowest quality settings will be obviously lower quality. High quality settings will result in a much larger file with little or no noticeable quality difference.

  Checking the VBR checkbox sets the encoder to use Variable Rate Encoding that typically provides better compression. VBR may be less compatible with some older mp3 players, as it is harder to determine how to skip around to different chapters exactly or find the exact end of a file. The VBR bitrates are estimates, based on measured output from sampling many audiobooks.

  If you decide you want to change the format after you've already converted some books, you can open the converted 'books' directory, throw the converted files into the trash (or move them), and use Controls: Refresh Files and the books will be ready to convert again.

• Automation

  Automation features should usually be enabled after becoming familiar with how the program works. It can save a little time when updating your library after purchasing new books.

  • Refresh library on application startup - Perform a Quick Library Sync on application startup
  • Automatically download books
  • Automatically convert
  • Automatically Update Web Page
  • Disable version checks. - Manually checking is always available under the About menu.

• Browser and Helper Application

  OpenAudible includes a built-in web browser for accessing help, book info pages, diagnostics, and purchase links.

  License upgrades purchased using the internal browser save you the step of having to copy and paste your license. But some users may prefer using their preferred web browser.

  Advanced users can set up a custom command to browse files, specify a web browser, or launch an audiobook player. Click More... to see advanced options.

  Helper applications are an advanced topic. If you run into trouble, use the File:Log Window to help determine any issues. Use the command line to attempt to recreate the functionality and you should be able to make it work. Ask your favorite LLM for help.

• Languages

  OpenAudible has been translated into many popular languages, including:

  English, Spanish, German, Hindi, Russian, Italian, Finnish, French, Portuguese, Japanese Arabic, and simplified Chinese.

  If you would like to help with translations, please contact us.

• Color Themes

  Themes Include:

  • System - The default theme, which will use the system colors. This theme may require an application restart to fully take effect.
  • Dark - A simple dark theme.
  • Light - A simple light theme.
  • A number of alternate themes including Dracula, Monokai, Pastels, Forest, Desert, Oceanic, Twilight, etc.

  You can select a theme to test it out. Switching from any theme to System requires an application restart to take effect.

• Fonts

  Click the "Set" button to choose a custom application font.

Manage Accounts

To link OpenAudible with your Audible accounts, use the File: Manage Accounts menu.

The Manage Accounts dialog allows you to add and remove linked accounts. Details about each account are included, including a status that can be "OK, Error, or Duplicate". Error and Duplicate accounts can be safely deleted.

Use the red "Trash Can" button to log out and delete the credentials for an account.

Use the "Add Audible Account" button to link a new account.

If you've used Libation, another Audible importer, you can click the Import Libation Accounts button to import your Libation accounts.

Note: Only accounts marked as "enabled" will be scanned during a library sync.

Manage Libraries

The File: Manage Libraries menu brings up a dialog where you can set or change your Library Directory, where your audiobook files (MP3, M4B, AAX, JPG) will be saved.

If you have a larger disk drive than your OS drive, you may want to change the library location, as audiobooks can take up a lot of file space. You can also use a network share, if you don't mind a little less performance.

The top of the dialog has a Library: which lists your known OpenAudible libraries. The buttons below are active if they can be used to move, copy, activate or delete a library.

Select a library and the information will fill in with the Path, Info, and Size.

A checkbox for enabling podcasts. See the section on podcasts.

A checkbox for enabling/disabling metadata updates on full rescan. If checked, modified tags can be overwritten with the latest metadata.

• Activate will change the active library to the library selected in the dropdown combo selector.
• Reveal will show the books.json file in the library's directory in your desktop's file manager (Finder/explorer/etc.).
• Copy allows you to copy the selected library to another disk location for backup purposes.
• Move will move the library from one location to another. It is the best way to move an existing library to a new disk.
• Delete will delete a library completely, the books.json, books, art, mp3, m4b, m4a directories. Use care, this is a permanent delete!

Before using any of these, read the confirmation dialogs carefully before continuing. Make sure none of the audiobook files are in use by another application.

Library Options

• Create New OpenAudible Library - Specify a new empty directory and your library will be set to that location.
• Open Existing OpenAudible Library - Select a 'books.json' file and switch to that library.
• Migrate OpenAudible Library - If shown, this option moves books from 'mp3' and 'm4b', and 'm4a' directories into the new 'books' directory for the current library.

All of these options include a dialog message showing what will be done with an option whether to proceed. Use care, and always back up your library manually before attempting a big change.

Main Window

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

Searching

The search bar at the top right of the app allows you to filter books by text or pre-defined filters. Type CTRL-F (Command-F) to activate the search. Start typing and all books that match will be shown. Use Escape to clear the search results and display all books.

Pro tips:

• Type the name of a boolean, such as "abridged" or "ayce" to show abridged or all you can listen books.
• Invert a search by prepending an exclamation mark (!) to the search-- !abridged will show all non-abridged books.
• Click on the blue headers in the Audiobook Info and Library Status page to search for the item you clicked.

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

Predefined Search Filters

The Search Combo also has a list of predefined search filters that can be helpful finding groups of books matching a characteristic.

Library Status

This shows your library statistics. These numbers are kept up to date and show important stats about your library and tasks.

Hint: 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.

Audiobook Info

Information about a selected book is displayed here. This info is collected from web or meta tags. Some metadata can be edited using the Get Info and tag editor.

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 information for each data element is self-explanatory.

The ID contains the Product_ID/ASIN.

The State field shows any errors or tasks that can be performed.

Audiobook Table

The list of your books. Click on a book and the book's information will populate into the "Audiobook Info" panel.

An icon on the left side shows the book's status. The following status icons are available:

	Audiobook is available as an MP3 or M4B audiobook file
	Audiobook is ready to download
	Audiobook is missing and has no download link. May need to be deleted. This can happen if you import a book and delete the audio file.
	Audiobook is ready to be converted from AAX to MP3 or M4B
	Audiobook is being converted to MP3 or M4B. Click on the book to see the progress in the Audiobook Info Panel.
	Audiobook is in the conversion queue and is scheduled to be converted.
	Audiobook is being downloaded. Click on the book to see the progress in the Audiobook Info Panel.
	Audiobook is in the download queue and is scheduled to be downloaded.
	Audiobook is a directory containing one or more audiobook files.
	Audiobook is a directory that is no longer found on disk.

To sort by a column, click the column header once. To sort in the reverse direction, click it again. Click it a 3rd time to go back to default sorting.

Table columns can be rearranged by clicking the header and dragging to a new location.

Additional table columns options are available, including hiding columns and adding new ones. Right-click the table and a menu will show, then select the submenu called 'Table Settings'. To restore the Book Table to default items and sorting, select 'Reset Table' from the 'Table Settings' submenu.

Menus

• File
  • Log Window View error messages and technical logs. Can be helpful if you see an error message or something isn't working as expected.
  • Manage Libraries Switch between different libraries.
  • Manage Accounts Set up multiple Audible accounts to connect to.
  • Import Books Existing audio files (MP3,M4A,M4B,AAX) files can be imported into the application.
  • Import URL Paste a http/https URL to download and add a book.
  • Export Web Page ; Creates a web page listing your books that you can host on a private server
  • Export Book List Select either "CSV" or "JSON" to choose the output format.
  • Export Cover Art Poster ; Creates an image file showing selected audiobook cover art.
  • Join Audio Files Combines 2 or more audio files into a single audio file.
  • Split by Chapter Utility to split an audio file into multiple files, one audio file per chapter.
  • Quit Exits the application
• Edit
  • Preferences Set application directories, encoding format, and language preferences. Mac users can also use the Settings menu.
• Controls
  • Connect to Audible Log into your Audible account
  • Quick Audible Library Sync Looks for new books and adds them to your library.
  • Full Audible Library Sync Does a complete scan of your library and updates ratings and book metadata.
  • Download All from Audible Downloads all audible books that haven't already been downloaded
  • Convert All to... Converts downloaded files to your selected audio format
  • Refresh Files Scans your library for new audio files
  • Cancel All Jobs... Cancels all download and conversion jobs
  • Log Out of Audible menu has been removed. Use the File: Manage Accounts menu.
  • Controls: Show Job StatusShows the progress status of current download and conversion jobs.
• Actions (acts on selected books)
  • Get Info Opens the Audiobook Viewer and Tag Editor. See information about tags, chapters, file information and generate a full "book report" showing all meta data.
  • View Web Page Opens a Browser to the book's Audible web page, if available.
  • Reveal A submenu that allows you to reveal or open any of the related files in the desktop file manager.
  • Download AAX Downloads selected books from audible
  • Convert to MP3 Converts selected books to mp3 audio format
  • Convert to M4B Converts selected books to mp3 audio format
  • Get PDF Downloads any associated PDF or other media.
  • Play Starts playing the audiobook in the OpenAudible integrated player. Or will open audiobook using your system's default audio player if the preferences disable the internal player.
  • Cancel Job Removes selected books from download and/or convert queues
  • Split Selected Books Allows bulk splitting of selected books by chapter
  • Ignore Book Removes book from getting displayed or exported
  • Rename Book Allows you to rename the files associated with a book
  • Delete Book Deletes the book and all files from your library
  • Set Read Status Select one or more books and set the "read status" of your book, such as Finished, Unread, Want to read or Did not finish.
  • Table Settings (Right-click from table) Allows you to add or remove columns from being displayed in the Book Table.
• About
  • Help Opens a web browser to this page.
  • OpenAudible Web Page Goes to https://openaudible.org
  • Check for Update Checks with openaudible.org to see if a new version is available.
  • License Enter or view your OpenAudible license code.
  • Send Bug Report After experiencing a problem, you may send a bug report to developers. Recent .html, book lists, and tmp files will be collected to assist
  • Diagnostics
  • About Open Audible The About Box and copyright info.

Importing/Exporting

Simple Copy and Paste

You can select one or more books in the Book Table and select Edit: Copy and paste it into any document (Google sheets, Excel, or text document).

Only the items in the table will be copied.

Exporting All Audiobook Data

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, csv, xlsx. OpenAudible also keeps an updated "books.json" that can be used in read-only mode by other applications.

Your audible library can be exported as a web page, json, .csv, or .xlst (Excel/Numbers) 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.

Exporting Cover Art Poster

This feature lets you create a collage poster image showing your audiobook cover artwork. When selected, a dialog appears showing options for different image sizes and layouts.

Depending on the number of audiobooks in your library, this can take a while and/or create large images. The images are saved in the temporary directory and will be shown in a image viewer window. Use the scroll wheel to zoom in or out. Use the "Save As" button to save the PNG image to a location of your choice.

Note, some cover artwork may be copyrighted, so please use accordingly.

You can change the size of the poster, number of rows and columns, and shuffle or sort them in your library table.

Drag Files to Desktop

You can drag a "Green" audiobook from the Book Table directly to the desktop, directory folder, or other application that accepts drag and drop.

If you drag to the desktop or directory, a copy of the converted audiobook will be copied to that location.

Dragging an audiobook from OpenAudible to an application, such as VLC, will either add the file to a playlist or start playing the book.

Back Up OpenAudible Library

To back up or export your entire OpenAudible library to another directory location, use the Copy Library button under the File: Manage Libraries menu.

This can be used to save a backup copy to a cloud disk, external drive, or when you want to move your library to a new directory. See more at: Manage Libraries.

Importing

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

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

Zip files are a special case, and somewhat experimental. The idea is you can download zip files from Librivox and drag them onto OpenAudible. If the zip file contains at least one audio file and an optional image file, the book will be automatically "joined". The audio files need to be alphabetically sorted to join correctly. If you experience problems, you may need to unzip the files and manually add them. This is an experimental feature.

Directories are similarly handled; we assume a directory needs to be "joined".

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, or import from a zip file.

Import from URL is a feature that lets you download a book from a web URL and add it directly into your library. If you send a link to an HTML page, we will look for a zip file or audio file and import that. Please use with care, as this is an experimental feature. You don't want to accidentally add a bunch of audio files that aren't books to your library.

Splitting & Joining Audiobooks

OpenAudible prefers 1 audio file per audiobook. It's how our software was designed. However, many people prefer an audiobook split by chapter.

It is 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. See Importing zip files above.

Join Audio Files

Some audiobooks 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 must be sorted alphabetically in the order you want them joined. (Be careful, Chapter 11 will sort alphabetically before Chapter 2, so you may need to add leading zeros to make Chapter 01, Chapter 02...). 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.

Pro tip: You can drag and drop one or more book directories onto OpenAudible to import books into your library as a single mp3 or m4b file.
Each directory should contain one audiobook, with one or more audio files and 1 optional JPG or PNG cover image file. All parts of the book must be in the correct order alphabetically, so be careful if you have a book that is chapter 1, chapter 2... chapter 11, as those may sort chapter 11 after chapter 1.

Split By Chapter

We do not recommend splitting books in most cases. Instead, use a good audiobook program that can handle chapter metadata and keep track of where you are listening across all your devices. However, some players have limited storage or may not manage playback position well. In those rare cases, splitting may be useful.

To split a book by chapter:

1. Select one or more books in the OpenAudible book table and select Action: Split by Chapter.

   If you selected one book, it will be shown in the file explorer after splitting. If you selected multiple books to split, a report will show the results of the split.

   As of OpenAudible 3.9, split books will be added directly to your library and show with a green 'folder' icon.

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

Note: If you have a full MP3 and M4B version of the book, OpenAudible will split the book as your preferred output format.

Tag Editing and Auto-Fill

OpenAudible includes a tag editor to allow you to update the metadata associated with your audiobooks.

To access, select one book and use the Action: Get Info menu.

Podcasts

OpenAudible can manage your saved Podcast episodes. Use the File: Manage Libraries menu to check or uncheck the "Enable Podcasts" feature.

Enabling this feature will add a "podcasts" directory alongside your "books" directory.

If you subscribe to a lot of podcasts, use care when enabling this feature with the automatic download feature turned on. You can see how many episodes are available by looking at the Library Status panel.

Note: To view all podcasts, select "Podcasts" from the search menu, or click the "Podcasts" link on the Library Status Panel.

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.

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.

Read Status

Each book can have a "read status" which can be set from the Action: Set Read Status.

Options are:

• None (not set)
• Read
• Finished
• Want to read
• Did not finish

You can also set a custom value by selecting the Get Info menu and editing the value in the Read Status field.

Chapter Names

Chapter names are available for some books. When they are available, they will be added to the output file and available in audiobook players that recognize standard chapter metadata.

If you have converted files created before version 3.1, your output books may be missing chapter names. To add chapter names to these books, you'll need to perform a Controls: Full Audible Library Sync, then manually delete the mp3/m4b files, select Control: Rescan Files, then re-encode the files.

File Names

Currently, file naming is handled by OpenAudible. You can rename the filename under the Controls: Rename Book.

A future version should allow you to customize the filename format by author, series, genre, etc., but this commonly requested feature is still "in progress."

Duplicate Books

Detecting duplicate audiobooks and removing them is a challenge. OpenAudible includes several methods to detect and compare possible duplicate books. Generally OpenAudible will not allow duplicates if the ASIN or Product ID match. But in some cases, you may want the title to match -- for instance the same audiobook with different narrators or translations.

Selecting "Possible Duplicates" from the Find dropdown menu will show all possible duplicates.

Selecting any two books from the Book Table will compare the two books and display a short report about their differences in the Summary Panel. You can decide to delete one of the books, or ignore the differences. Use care when deleting a book that you know which files are associated with each book-- you do not want to delete a book that has an audio file associated with it that you want to keep.

Unsupported Books

AAXC files that have been downloaded from Android or Kindle are not supported. (However, these can be downloaded using OpenAudible.)

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.

License and Demo Mode

OpenAudible is shareware and can be tried before buying. To use all the features, a low-cost license is required.

A license can be purchased from openaudible.org/purchase or from within the application About: 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 audiobook purchases.

Activating the license is done through the About: License... menu. More details about the license and order lookup are available at openaudible.org/license.

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

A license entitles you to one year of free updates. After 1 year, an upgrade can be purchased through the application that will give you another year of software updates. But you can always use a version of the software that was created before the annual expiration date.

Log Window

Getting an error or something doesn't seem right? Use the menu File: Log Window to open the OpenAudible Log Window. Here you can view startup messages and see details about errors and events.

Troubleshooting

Here are some common problems and how to solve them.

Often opening the File: Log Window and looking at the last few lines can show an error, and often the error has a description that might help you figure out what happened.

If you are having trouble downloading or converting a specific book, select the book at look at the Audiobook Info Panel at the State line.

The State field shows the current state of the book, including:
ready to download, downloading, ready to convert, converting, error or OK.

Login Errors

Logging into Audible from OpenAudible can fail for a few reasons.

• Let your antivirus and firewall software that the application OpenAudible needs network access.
• Check your firewall. Test network access by using the menu About > Check for Update which should not produce an error.
• You selected the wrong audible region. Make sure you select your audible region. Unless you have a very old account with a username (and not email), make sure the "Legacy Account" checkbox is unchecked.
• You made a typo on the username or password
• From your regular web browser, go to audible and if needed log out. Then log back in and make sure your credentials are correct and what you expected. Write them down and use them to connect to audible from the OpenAudible application.
• If you can log in with OpenAudible on another computer, you can copy the credentials.json file from that machine to your machine or import it from the File: Manage Accounts.

Download Errors

There are a few reasons why a download might fail.

First, select the book and look at the Audiobook Info Panel State information. That will give the status.

• If a book is already in the download queue, you won't be able to convert it or add it to be downloaded until it has finished downloading. You may need to be patient. Clicking on the book will show the state of the conversion in the Audio Book Info panel.
• Out of disk space. Make sure the destination drive has disk space. Use the Manage Libraries to show you how much disk space remains. Your system volume also needs some free space.
• You are logged into the wrong account. If you have multiple accounts, you need to be connected to it before a download will work.
• Some books become unavailable. Check that the audiobook is available in the Audible mobile app and/or Audible web page and can be played.
• Rate limit exceeded. Try disabling automatic downloads and waiting a little before trying again.
• Check your account in the File: Manage Accounts using the Test All button.
• If the audiobook still shows "red dot" error, you can select and Action:Delete the book and do a Controls: Full Audible Library Sync, then retry downloading.
• Upgrade to the latest version. Some issues have been addressed in later versions of OpenAudible.

It is always best to back up your files as soon as possible.

Conversion Errors

To troubleshoot an audiobook not converting, select the book and look at the state in the Book Info Panel.

Conversion can fail if...

• The file wasn't downloaded using OpenAudible.
• You are out of disk space. Make sure the destination and settings directories have enough disk space.
• You've exceeded the personal use limit of 5 accounts.
• You have an antivirus program blocking the internal ffmpeg/ffprobe applications.
• Upgrade to the latest version. Some issues have been addressed in later versions of OpenAudible.
• Are your books already green? Then they are already converted! Convert and download options will be unavailable.
  If not green, select a book and look at the state in the Audiobook Info Panel.
• Is the book red? There may be a human-readable error message in the Audio Book Info Panel under "State".
• Conversion in progress? Converting an audiobook with a 10-hour duration to mp3 takes about 280 seconds (128X!) and about 18 seconds for m4b. Performance can be impacted by memory, CPU speed, and disk throughput. Watch the Library Status: Converting queue indicator, which might Converting 3 of 10. Click on the Converting line to see which books are converting and then select each book to see the state. Books that are converting will have a progress indicator under Audiobook Info: State that should show conversion go to 100%. Each successful conversion will turn the book color indicator green and decrement the queue. If all books were queued, it can be hard to tell that conversions are happening in the background. Again, clicking on the book will show the state of the conversion in the Audio Book Info panel.

You may need to Action:Delete Book and do a Controls: Full Audible Library Sync, download and convert.

Compatibility Issues

OpenAudible is for Mac, Windows (AMD/Intel x64), and Linux (AMD/Intel x64). OpenAudible does not run on Android, iOS (iPhone + iPad), or Chromebooks.

If the application does not run correctly on startup (quickly fails), check that your antivirus allows OpenAudible to run. In the OpenAudible application directory are command line scripts that can also be used to debug startup problems.

• Windows: Launch cmd.exe then paste: "C:\Program Files\OpenAudible\debug_win.bat"
• Mac: Launch Terminal.app and paste: "/Applications/OpenAudible/debug_mac.sh"
• Linux: From terminal, cd to the OpenAudible application directory, then ./debug_linux.sh

The error displayed should give some indication of the issue. If not, send it to us using our contact form, and we can take a look.

Missing Audiobooks

Having trouble finding an audiobook that was in your library? Here are some things to check.

• Use the Find field at the top of the window and enter the name of the book or the author's name.
• Ensure you are connected to your library. If you have multiple libraries, ensure you've connected to the right one.
• See if it is still in your Audible library on the web browser and on your mobile device. Unfortunately, books can be removed from Audible's catalog.
• Do a Controls: Full Audible Library Sync. If still not found, open the Log Window and copy and paste into a text editor and search for the name of the book. OpenAudible will print a log message if a book is skipped during the library scanning process for any reason.
• Check that the book wasn't Ignored. Click on "Ignored" on the Library Status Panel to show any books that were hidden. (If it says Ignored: 0, there are no ignored books.)
• Make sure the book is still in your Audible account and playable from your mobile device. Books can become unavailable and are removed from your library without warning. Back up early and often!

Additional Help

OpenAudible may stop working at any time, due to changes in Audible systems or API. 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. A valid GitHub issue number is required— either create a new issue, or use the number of a similar issue. Add a comment to the issue on GitHub if you have more information.

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.

Credits

This software gratefully uses FFmpeg under the LGPL built using ffmpeg-build from acoustid.

Please do not share your books. Any personal metadata in the audible files are copied to the output files.

Use of this software for piracy or on file sharing sites is strictly prohibited. Violating these terms will result in us canceling your account and banning you.

This software is copyright the authors of the software.