OpenAudible Documentation

OpenAudible Documentation

This application lets Audible users enhance their experience maximizing their audible library.

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

Setup

Configure your working directory in the preferences. The working directory will contain Audible files (AAX), MP3 files, artwork, and other data.

The Web Dir can contain a web page listing of your audible content, a json version of your audiobook meta data, and an MP3 directory with titled audio books.

Connecting to Audible

Connecting to audible is done via a web browser. The first time you use the program you should log in to your audible account using the built-in web browser.
When connected, you should be logged in via the browser, and OpenAudible Library status should be Connected: Yes.

OpenAudible automatically imports the first page of your Audible library into the application. From there, books can be downloaded and converted.

Once connected, you can import the rest of your books by doing a full scan.

Downloading Files

Before converting or downloading files, you need to select one or more audible books in your library, then select either "Download" or "Convert to MP3" from the Action menu.

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

When viewing your library from the OpenAudible web browser, you should be able to download individual book files by clicking on a "Download" button from the Audible Library page.

Audible Settings

Audible has a setting you need to change if you have problems downloading books.

If you see a message about How To Listen or an alert about the need to change a setting, follow these instructions.

Ensure the Check for Audible Download Manager setting is unchecked, try downloading a file again.

Exporting

Your audible library can be exported as a web page or Excel list from the File menu

Menus

File

• Console - View error messages and technical logs
• Export Web Page - Creates a web page listing your books that you can host on a private server
• Export Book List - Saves a list of your books to Excel file
• Quit - Exits the application

Edit

• Preferences- Set application directory, audible region, and user name/password

Controls

• Connect to Audible - Attempts to log into your Audible account for content scraping
• Quick Library Sync - Looks for new books and adds them to your library.
• Full Library Sync - Does a complete scan of your library and updates ratings and book meta data.
• Download All from Audible - Downloads all audible books that haven't already been downloaded
• Convert All to MP3 - Converts downloaded files to MP3
• Show Browser - Opens internal browser. Connecting and logging in to Audible using this browser helps the app get past any "captchas".

Actions (acts on selected books)

• View In Audible - Opens the Browser to the book's Audible page, if available.
• Show MP3 - Opens Explorer/Finder to display the MP3 in the desktop.
• Play Audio Book - Opens MP3 using your system's default MP3 player.
• Download AAX - Downloads selected books from audible
• Convert to MP3 - Converts selected books to MP3
• Refresh Info - Gets missing book meta data from Audible web page and/or files. Downloads image if not found.
• Ignore Book - Permanently adds a book to the OpenAudible ignore list. This book will not be shown or exported.
  Note: The ignore.json preference file can be edited or deleted to remove one or all books.

Help

• Help - Opens the Browser to this page.
• Project Web Page- Goes to http://openaudible.com
• Check for Update- Checks with openaudible.org to see if a new version is available.
• Send Bug Report- After experiencing a problem, you may send a bug report to developers.
• About Open Audible - The about box and copyright info.

Additional Help

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

Submitting a bug report from the tools 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.

No technical support is provided. Open Source additions are welcome.

Suggestions welcome by creating an issue or submitting a pull request.