Add-on:AudioBooks: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
Line 71: Line 71:
:'''Highlight Completed Books And Chapters'''
:'''Highlight Completed Books And Chapters'''
::Indicate which books and chapters have been completed
::Indicate which books and chapters have been completed
:'''Default Book Cover Image'''
:'''Default AudioBook Cover Image'''
::The default cover image to use if there is no image available for the audiobook
::The default cover image to use if there is no image available for the audiobook
| [[File:AudioBooks-Settings1.JPG|400px]]
| [[File:AudioBooks-Settings1.JPG|400px]]
|}
|}
=== Operations ===
=== Operations ===
{| border="0"
{| border="0"

Revision as of 06:07, 24 September 2015

AudioBooks
https://raw.githubusercontent.com/robwebset/script.audiobooks/master/icon.png

Author: robwebset

Type: Program
Repo:

License: GPL v2.0
Source: Source code
Summary: Play AudioBooks
Home icon grey.png   ▶ Add-ons ▶ AudioBooks
Attention talk.png Need help with this add-on? See here.

Allows the playing of AudioBooks



Introduction

AudioBooks is an addon that allows you to list and play your AudioBooks using Kodi.

On installation of the AudioBooks addon it will need configuring to point to the directory that contains all of your AudioBook files. This can be done via the AudioBooks Settings, or if not set, you will be prompted on first use.

Basic Support

With the default configuration you can:

  • List all your AudioBooks (By filename)
  • Play your m4b AudioBooks
  • Resume your AudioBooks from the point it was last stopped



Advanced Support

In order to get features that include:

  • Display of AudioBook Titles
  • Display of AudioBook Cover Artwork
  • Listing of AudioBook Chapters
  • Starting playing from a given chapter marker

Then you will need to download ffmpeg to a location on your machine and then use the AudioBooks Addon Settings to point to the ffmpeg executable.

Note: If you previously loaded books without ffmpeg, then you will need to clear the cache via the settings - or the context menu to have the audiobooks rescanned.

AudioBook Listing

When entering the addon via the Music Addons Menu the available audiobooks will be listed. Any directories that exist will be displayed with their directory name and enclosed in square brackets. On selecting an audiobook, the chapters in that book will be displayed (Note: If ffmpeg support is not enabled then a link to play from the start of the book, or resume will be displayed).

Any audiobooks or chapters that have been marked previously as complete will start with an asterisk ("*").

Cover Art

The cover art for a given audiobook is retrieved in the following order:

  1. A jpg file in the same directory as the audiobook with the same name (i.e. an audiobook with the name myaudiobook.m4b and an image with the name myaudiobook.jpg)
  2. An image that has previously been cached from a book (Based on the file name of the book)
  3. Extracted internal image from the audiobook file (If ffmpeg enabled)
  4. The default cover image set in the AudioBooks settings screen.



Settings

General

AudioBooks Folder
The Location where the AudioBooks are stored
ffmpeg Location
The location of the ffmpeg executable
Highlight Completed Books And Chapters
Indicate which books and chapters have been completed
Default AudioBook Cover Image
The default cover image to use if there is no image available for the audiobook
AudioBooks-Settings1.JPG

Operations

Clean AudioBook Cover Cache
Removes any audiobook covers that have been cached
Clear AudioBook Details Cache
Clears any data cached about the audiobooks (inc. read markers)
Debugging
Enable debug logging
Enables TvTunes debug logging (Required if reporting a problem) - for this to work, system-wide Kodi logging must also be enabled
AudioBooks-Settings2.JPG



Debugging

If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:

  • Kodi logging from the main setting menu
  • AudioBooks debug from the AudioBooks addon settings menu

Please do not paste the log into the forum thread, just link to it.

Donations

If you have found the AudioBooks Addon useful and would like to help support future development and bug fixes, then please feel free to make a small donation.

Please use the link on the top of the AudioBooks Forum