Akimbo Audio

Book Player

Version 1.3
May 2011

Contents
Main Sections

Contents

Additional Data

Overview and Features ............... 2

Statistics ...................................... 18

Getting Started ............................ 3

Widget ......................................... 19

Player Screen ............................... 4

Technical Details .......................... 20

Accessibility ................................ 8

Factory Default Settings .............. 21

Library Screen ............................. 9

Covers .......................................... 22

Settings Screen ........................... 14

Advanced Information ................. 23

Credits and Support .................... 24

Page 1

Overview and Features

Akimbo Audio Book Player allows an easy and fun way to listen to audio books on your mobile or tablet.
While the player is designed specifically to provide optimal support for audio books, it is also a very
convenient tool for listening for any audio piece that is inherently episodic (such as music albums,
podcasts, and more).

Screens
The main screens available in the player are:

Player Screen
The player screen is the main screen you will use. It allows you to listen to the book and control its play.

Library Screen
The library screen allows you to view and manage your books and music. If contains several sub-screens:

Add File/Folder
This screen allows you to add a file or an entire folder (including its subfolders) to the library.

Book Edit
This screen allows you to edit the books information and add, remove or download its covers.

Book Info
This screen shows detailed information about a book along with its covers.

Settings Screen
The settings screen allows you to set your preferred configuration for the player.

Statistics Screen
The statistics screen shows some statistics about your listening history.

Help Screen
The help screen provides help about the player.

Features
A full detail of the features offered by the player is listed in this manual. Here are just a few of them:
Supports all major audio book formats (mp3, mp4, m4b, m4a) and other audio formats.
Recalls the last position and the volume level per book in the library.
Provides cover support for inherent covers as well as automatic download of book/album cover
(either per book, of for the entire library). Also allows you to add cover images of your own.
Offers a wide array of navigation options, including undoing position changes, going to any point or
chapter in the book, and rewinding or advancing the current position by configurable durations.
Includes a lock mode, which prevents accidental change to the currently played position.
Allows loading your entire audio book library folder in just one click.
Provides a full range of accessibility features for support of visually impaired people, or for use of
the player without looking at it (see Accessibility)
Shows usage statistics (duration of listening to audio in several interesting cross-sections).
If you have any issues or questions, see the troubleshooting section at
https://docs.google.com/document/d/1ZaoXiOZK0zlhw4gOq_bFmeihZvYj9f9_NwrhbCLlM9k/view?hl=en

Page 2

Getting Started
1. When you first open the application you will see an empty player screen (this is also the case
when your last played book reached its end). To play a book you need select it from the library.
Please press the menu button and select Library to open the library.
2. If this is your first time in the library, it will contain no books.
a. To load books press the Add File/Folder button on the top left (or choose the same
option from the menu). You will be shown a file explorer window. Navigate (by pressing
the folder names) until you see the folder or file you want to scan. If you need to go
back to a parent folder, press the Up to item at the beginning of the list. When you get
to the desired folder either perform a long press (press and hold it down for a few
seconds) on the items name, or click the green add button
next to it. The application
will scan the books in this location and add them to the library (this may take a few
minutes, depending on the amount of files in the folders).
3. To play a library book to play press its entry in the library; the application will go back to the
player screen and continue to play the book from its previous position.

Page 3

Player Screen
The main player screen is where youll spend most of your time listening to books. You can play your
book, pause it, seek within a chapter, jump to a different chapter, or step a predefined amount of time
forward or backward in the book.
any Step buttons configured
Player Overview
Next Chapter
to be lockable.
Press this button to switch to
Go-To
the beginning of the next
Press this button to open the
chapter. The button is
Go To dialog (see below),
disabled at the last chapter.
which enables you to quickly
Play / Pause
switch to any position or
Press Play to resume play.
chapter in the book.
Press pause to pause play.
Small Step Back
Note that you can switch
Press this button to quickly
between a normal-sized and
rewind play position a preset
a large Play/Pause button
short amount of time
(see Settings)
(default is 10 seconds).

Sleep Timer

Large Step Back

The player screen is divided
into three main sections:
The top section mostly
shows information about the
played book. It also contains
the Lock and Go-To buttons.
The middle section contains
the books cover and the
step buttons (see below).
The bottom section contains
play control buttons.

Player Buttons
Lock / Unlock
Press lock to lock the player
and prevent accidental
position changes. When in
lock mode the following
buttons are disabled: Next
Chapter, Previous Chapter,
the Position Seek Bar, and

Press this button to quickly

rewind play position a preset
large amount of time
(default is 1 minute).

Small Step Forward

Press this button to quickly
advance play position a
preset short amount of time
(default is 10 seconds).

Large Step Forward

Press this button to quickly
advance play position a
preset large amount of time
(default is 1 minute).

Previous Chapter
Press this button to switch to
the previous chapter. If
pressed late in the chapter,
or during the first chapter,
the player will switch to the
start of the current chapter.

Page 4

The sleep timer button on

the left opens up the sleep
dialog. Set the number of
minutes until you go to
sleep, and the player will
automatically pause at this
point. If you choose End of
Chapter the player will
pause at the end of the
currently played chapter.
Press Cancel Timer to cancel
a previously set timer.

Bookmark
Long-press this button (press
and hold) to add a bookmark
to the book at the current
position.
Press this button to open the
bookmark dialog (see below),
which allows moving to a
previously bookmarked
place.

Player Seek Bar

The Player seek bar is located
at the bottom part of the top
section. It displays progress
along the currently played
chapter, and allows you to
drag its cyan thumb to
change the position within
the chapter.

Player Information
Book Information

The books information

appears at the top section,
between the Lock and Go To
buttons. It contains three
rows:
1. The books title
2. The books author
3. Chapter data: current
chapter number, total
number of chapters and
chapter name.

The amount of time left in

the current chapter appears
below Left in Book.

Cover
The books cover is shown at
the center of the player
screen. See Library Screen on
how to add or automatically
download covers.

Go To Dialog
Once you press the Go To
button a dialog will open,
allowing you to switch to any
position (top section) or any
chapter (bottom section) in
the book.

Step Configuration
For each step button you can
configure its size, whether it
may be locked, whether it is
shown in the player screen
and whether the text below
it is shown. See more in
Settings Screen

Go To Chapter
To switch to a specific
chapter in the book, set the
dial at the bottom part of the
dialog to the desired chapter
index, and press the button
below the dial.
The text on dial indicates the
chapters number, total
number of chapter, the
chapters position in the
book, and its name. For
example, if the sixth chapter
out of twelve, called The
Lamp, begins after an hour
and five minutes, its text will
read 6/9 (1:05:00): The
Lamp

Book Position
Position within the book
appears below the lock
button.

Chapter Position
Position within the current
chapter appears below the
book position.

Left in Book
The amount of time left in
the book appears below the
Go-To button.

Left in Chapter

Page 5

Go To Position

Bookmark Dialog

To switch to a specific
position in the book, set the
dials at the top part of the
dialog to the desired hour,
minute and second, and
press the button below the
dials.
Note that the minutes and
seconds dials are cyclic, so if
you scroll above 00, you will
go back to 59.
If you set a position that
exceeds the books duration,
the button will grow red and
become disabled (see image
below)

Once you press the

Bookmark button a dialog
will open, allowing you to
add a new bookmark, or go
to any previous bookmarked
position.

The title shows you the

position which an added
bookmark will point to. Press
the Add Bookmark button
to add a bookmark at the
position.
Below the button you will
see a list of previously
bookmarked position (sorted
by bookmarking date, from
last to first). Each item in the
list shows the position in the
book and the date in which
the bookmark was added.
Press an item to go to the
bookmarked position.
Perform a long-press on an
item to get a context menu
for this item. The context
menu allows you to delete
the item or go to the
bookmarked position.

Page 6

Player Screen Menu

The player screen menu (shown when you press your devices
Menu button) contains the following options:

Last Position

Library

Notification Icon

This is the undo button.

Whenever you change the
play position manually (by
using the buttons, the Go To
menu, or the seek bar), your
previous position is
recorded. Pressing this
button will take you back to
the previous position. Up to
ten previous positions are
kept in the player at a time.
This button is disabled if no
manual position change was
done.

Opens the library screen,

where you can manage your
books and choose which one
to play. See more at Library
Screen

When a book is loaded into

the player an icon will appear
in your devices notification
bar.

Close

The information attached to

the icon shows the currently
played book and chapter.
In addition, if you navigate
away from your player, this
icon can be pressed for a
quick shortcut to reopen the
player.

Next Position

Press More to see:

This is the redo button. If

youve pressed the Last
Position and changed your
mind, pressing this button
will take you back to the
position you were before.
This button is disabled if the
Last Position button was not
pressed after the latest
manual position change.

Settings
Opens the settings screen,
where you can control the
applications behavior and
settings. See more at
Settings Screen

If you press this you will be

prompted to close the
player. Press yes and the
application will shut down
(stopping and audio play at
progress) and be removed
from memory completely.

Statistics
Opens the statistics screen,
where you can see some
useful (or not) statistics. See
more at Statistics Screen

Help
Opens the help screen,
where you can get help on
how to use the application.

Page 7

Accessibility
The player mostly complies with accessibility recommendations suggested at eyes-free site.
If you are visually impaired it is strongly recommended to change the settings to use Spinners instead of
dials (see Settings Screen), as they are more accessible without sight.
In addition, the player offers a range of accessibility features. These features can be used for better
experience if you are visually impaired or using the application without looking at the screen.
All accessibility features are controlled by the Settings screen (see Settings Screen).

Text Indication

Voice Indication

Double Press Mode

When Text indications are

enabled, pressing any button
in the main screen (except
for Go-To) will flash a largefont indication just above the
bottom row of buttons.

When Voice indications are

enabled, pressing any button
in the main screen (except
for Go-To) will cause a
human voice indication of
the action to be played.
Voice indications will be used
if the accessibility mode (see
Settings Screen) is set to
either Voice or Text +
Voice.
Note that you can configure
the voice indications track
and volume in Settings
Screen.

When Double Press mode is

enabled, pressing any button
in the main screen (except
for Go-To) will not
immediately cause it to
execute its action. Instead,
you will be prompted to
press the button again to
perform the action. If you
press the button again within
five seconds, the original
action will take place;
otherwise, the action will be
cancelled.
This feature helps preventing
performing actions by
mistake.
When Text indications are
enabled you will be
prompted by the visual
message Press again for
followed by the relevant
action.

Text indications will be used

if the accessibility mode (see
Settings Screen) is set to
either Text or Text +
Voice.

When Voice indications are

enabled you will hear the
human voice message Press
again for followed by the
relevant action.

Page 8

Library Screen
The library screen allows you to manage your books, and choose which one to play.
To access the Library pull up the menu in the Player screen and select Library.

Overview
When you open the library
for the first time, it will be
empty. After youve added
some books (see Adding
Books) you will see a list of
your books. You can scroll
down the list to see more
books if the library exceeds a
single screen. You can also
filter the books shown in the
library (see Filtering Books)

At the left you will see the

books cover. Next to the
cover are the books main
details. To the right are two
buttons:

Book Layout

Edit button
Press it to edit the books
main details, manage its
covers, or remove it from the
library (see Editing a Book).

Each line in the list shows a

single book.

Filtering Books
You can filter the books
currently shown in the library
by entering text in the search
filter at the top.

Information button
Press this button to see a
vast array of information
about the book (see Book
Information).

Accessibility Note
If you are using the D-Pad to
scroll through the library,
long click an item to get a
context menu containing the
Edit and Information
screen options.

Playing a Book
To play a book click its entry
anywhere outside the two
buttons. The application will
switch to the Player Screen
and resume play of the book
from its last position. If you
press a book that is currently
playing you will simply go
back to the player screen.

Page 9

The books will be filtered to

show only items whose title
or author contains the search
string.
Reset the filter by pressing
the
button at the top
right. All your books will be
shown again.

Adding Books
To add a book to the library
press the Add File/Folder
button at the top of the
library (or pull up the menu
and choose Add
File/Folder). This will open a
file explorer where you can
choose which books to add.
If you add files whose title
already exists in the library,
they can be merged into
these titles. You can control
merging options in the
Settings Screen (Library Tab)

File List
The main part of the screen
shows a list of the files and
subfolders in the current
folder. At the top of this list
you will always have an item
which will take you back to
the parent folder.
Each line in the explorer
contains either a file or a
folder (you can tell them
apart by the icon on the left).
To descend into a folder
press its name.
To add the file or folder to
the library either perform a
long press on the item, or
press the
green add
button.
After you add the book the
explorer screen will close,
and the file or folder will be
loaded to your library.
To leave the screen without
loading anything, press your
devices Back button.

Top Row
The explorers top row has
an indication of the current
folder at the left. At the right
of the top row is a button
allowing you to set the
current folder as root,
thereby causing future Add
actions to start from that
folder.

Page 10

Please note that only files

whose extensions appear in
Audio Extensions (see
Settings Screen Library
Tab) will be shown or added
to the library.
If you have a file of a format
that is playable by your
device (e.g., AWB or WAV),
add its extension to the
Audio Extensions list and it
will be available for adding to
the library.
Such files will use the folders
name as the title and the
files name as the chapter
name (in case there are
multiple files in the same
folder and they are merged
into a single book).

Editing a Book
Press a books
edit
button, or long-click the item
and select Edit to open the
Edit screen.

were added from image files

or downloaded from the
web, and not covers inherent
to the book.

Adding a Cover from a File

To add a cover from a file,
press the green
button on
the top left. This will launch a
file explorer window.

Disabling a Cover
You can disable or enable the
use of any cover by toggling
the button on the top right.
Disabled covers will be
partially masked to indicate
that they will not be used
(see more at Appendix C
Covers)

Actions
Saving your Changes
To save the changes you
made in the Edit screen press
the Submit button at the
bottom.

Discarding your Changes

The top part of the Edit

screen contains four book
properties which you might
edit. These are the books
title, author, genre and year
of publication.
Below the properties are the
books covers (rifle through
them by scrolling sideways).

Downloading a Cover
To automatically download a
books cover, press the
button on the bottom right.
This will launch an internet
search for suitable covers.
See more about covers at
Appendix C Covers

To leave the Edit screen

without saving your changes
press the Cancel button at
the bottom.

Removing a Book
Navigate the explorer into
the desired folder by
pressing folder names. To go
to the parent folder press
the Up to item at the top.
Image files will be shown
(depending on supported
cover formats, see Settings
Screen) with their thumbnail
on the left and a
green
button on the right. Perform
a long press on the item, or
press the button to add the
image to the books covers.

Deleting a Cover
To remove a books cover,
press the
button at the
bottom right. Note that you
can only remove covers that

Page 11

To remove a book from the

library press the Remove
button at the bottom.
To remove all the books from
the library or those whose
audio files are no longer
available, see the options in
the Library Screen Menu.
Note removing a book will
not remove any of your
audio of image files. The only
changes are to the players
internal database. Covers
which you have downloaded
from the internet and are no
longer in use will also be
removed at this time

Book Information
Press a books
info
button or long-click the item
and select Information to
open the Information
screen.

Table 1 Book Information Attributes

Attribute
Last Played
Position
Genre
Year
Format
Files
Bookmarks
Covers
Volume
Added to Library
Last Update
Internal Key

The top part of the screen

displays the books title,
author and duration.
Below it are the books
covers (rifle through them
by scrolling sideways).
At the bottom is a scrollable
list of the books attributes.

Page 12

Description
Date in which the book was last played
The books last play position
The books genre
The books publication year
The books audio format
Number of audio files comprising this book
Number of bookmarks set in this book
Number of cover images available for this book
The books audio volume (in a scale of 0 to 15)
Date in which the book was added
Date in which the book data was last changed
Internal book key. For advanced use only.

Library Screen Menu

The library screen menu (shown when you press your devices
Menu button) contains the following options:

Add File/Folder
Use this option to add books to the library. This is identical to the button at the top of the Library screen.

Download Covers
Use this option to automatically download covers to all the books in your library currently without a
cover. Pressing Download Covers will launch an internet search for suitable covers. You can determine
the number of covers to download in Settings Screen (the default is a single cover per book).
Note that the search will only encompass books without covers.

Sort
Use this option to change the order of the books in your library. This will open a dialog containing the
sort criteria. You can define up to three criteria, in decreasing priority. For each criterion you can select
whether to show the data in ascending order (A-Z) or descending order (Z-A).
Pressing a criterion button will open up a dialog allowing you to change it.
Table 2 Library Sort Criteria

Criterion Name
N/A
Added to Library
Duration
Last Played
Last Update
Title
Author
Genre
Year

Description
Do not use this criterion
The date and time in which the book was added to the library
The books duration
The date and time in which the book was last played
The date and time in which the book data was last changed
The books title
The books author/artist
The books genre
The books publication year

Rescan Library
Use this option to rescan your library, and remove any books whose audio files are missing. This is useful
in case you deleted some audio files from your storage space and want to remove all the redundant
library books at once (instead of going over them one-by-one).

Clear Library
Use this option to remove all the books, and clear the library altogether. After you press this you will be
prompted to approve removal of all the books from the library.
Note clearing the library will not remove any of your audio of image files. The only changes are to the
players internal database. Covers which you have downloaded from the internet and are no longer in
use will also be removed at this time.

Page 13

Settings Screen
The Settings screen allows you to configure the applications looks and behavior. To access the Settings
screen pull up the menu in the Player screen (press your devices menu button), and select Settings.
The Settings screen contains of three tabs: player, library and accessibility.

Player Tab
The left tab controls the
behavior of the main Player
Screen.

Determines whether to lock

the step in Lock mode.
Size
Determines the step size.
Press the button to change
the size.

Display Step Size

Determines whether the text
showing the step size is
displayed in the player below
the step button.

Big Play Button

Determines if the Play/Pause
button is large or normalsized.

Show Notification Icon

Determines whether to show
the icon and message in the
notification bar when a book
is playing.

Show Sleep Button

Step Configuration
The table at the top of the
Player allows you to
configure the visibility and
behavior of the Step buttons.
For each step button you can
configure the following:
Show
Determines whether the step
button will be available in
the player screen.
Lock

Determines whether to show

the sleep button in the
player screen.

Show Bookmark Button

Determines whether to show
the bookmark button in the
player screen.

Max. Bookmarks
Determines the maximum
number of bookmarks kept
per book.

On Startup
Determines behavior on
startup:

Page 14

No book loaded the player

screen will be empty.
Load Last Book loads the
last played book paused.
Resume Last Book loads
and plays the last played
book.

Volume per Book

Determines whether the
Player will maintain and use
the last used volume setting
per book.

Audio Stream
Determines the audio stream
through which the audio is
played. Normally this is the
devices Music stream, but
you can change it to Voice,
which will use the phones
voice-call stream (this may
help if you want to send the
audio over Bluetooth to the
headset).
Note: changing this requires
completely shutting down
and restarting the app.

Previous Chapter at
Determines how many
seconds must elapse in a
chapter in order for the
Previous Chapter button to
seek to the beginning of the
current chapter (and not to
the previous chapter).

Library Tab
The middle tab controls the
behavior of the Library
Screen.

the same title, but are each a

show in its own. To that end
you can configure the
librarys merging behavior.

Determines how many

covers per book will be
downloaded from the web.

Allow Merging by Title

Determines the initial folder

when adding books to the
library.

This will enable merging by

title (unless where
prohibited by the following
settings).

Allow Merging MP3

This will allow merging MP3
files (assuming Allow
Merging by Title is enabled).

Allow Merging
MP4/M4A/M4B
This will allow merging MP4
files including M4A and
M4B (assuming Allow
Merging by Title is enabled).

Allow Merging Podcasts

At the top of the tab you can

see the Library sort criteria.
Set them to determine the
order in which books are
shown in the library (see
Library Screen Menu).

This will allow merging

podcast files (assuming Allow
Merging by Title is enabled).
A file will be identified as a
podcast if anywhere in its
parent directories the string
podcast appears (caseinsensitive). For example:
/sdcard/podcasts/file.mp3
/sdcard/my_podcast/3.mp3

Merging Options

Data Storage

You can merge files with the

same title into a single library
entry. This is very useful if
you have a folder containing
a book in multiple files.
However, there may be
times when you dont want
to merge by title. For
example, when you are
loading podcasts, which have

This determines whether the

players metadata (library,
images, etc.) will be kept on
the phones internal storage
or on the SD Card.
If you change this the library
will be moved to the new
location after you exit the
settings screen.

Library Sort

Covers to Download

Page 15

Audio Root Folder

Covers Root Folder

Determines the initial folder
when adding book covers
from a file.

Audio Extensions
Advanced. Contains a
semicolon-separated list of
known extensions of files to
be added to the library. Edit
this if you have files which
you think should be played
but their extension is not in
the list.

Cover Extensions
Advanced. Contains a
semicolon-separated list of
extensions to be considered
when adding a cover from a
file. Edit this if you have
images which you think
should be loaded but their
extension is not in the list.

Accessibility Tab

Controls Tab

Headset Play/Pause

The accessibility tab controls

the behavior of accessibility
features (see Accessibility)

The controls tab sets

preferences for player
external controls.

Customizes the action taken

when the headset
play/pause button is pressed.

Headset Stop
Customizes the action taken
when the headset
play/pause button is pressed.

Headset Prev
Customizes the action taken
when the headset previous
button is pressed.

Headset Next
Customizes the action taken
when the headset next
button is pressed.

Headset Rewind
Mode
Determines the accessibility
mode.

Voice Track
Determines the voice track
(male or female) when voice
indications are used.

Voice Volume
Determines the voice volume
when voice indications are
used.

Double Press
Enables or disables double
press mode, which requires
pressing a player button
twice to invoke its action.

Use Spinners
Enables or disables the use
of spinners instead of dials
throughout the player.
Spinners offer better
accessibility for visually
impaired people.

You can customize the

actions taken for various
headset buttons and the
widgets left button. The list
of supported actions is:
Disabled (no action)
Pause audio play
Toggle pause/play
Switch to next chapter
Switch to previous
chapter
Skip a small step forward
Skip a small step back
Add a bookmark

Headset Control
This enables or disables your
ability to control the player
using a headset.

Headset Hook
Customizes the action taken
when the headset hook (to
answer or hang up calls) is
pressed.

Page 16

Customizes the action taken

when the headset rewind
button is pressed.

Headset FF
Customizes the action taken
when the headset fast
forward button is pressed.

Widget Left Button

Customizes the action taken
when the widgets left
button is pressed while a
book is loaded.

Actions
Saving your Changes
To save your settings
changes press the Save
button at the bottom right.

Discarding your Changes

To discard your settings
changes press the Cancel
button at the bottom left.

Resetting to Default
To reset the settings to the
factory defaults (see
Appendix B Settings
Factory Defaults) press the
Reset button on the
bottom. The reset changes
are only saved if you press
Save afterwards.

Page 17

Statistics Screen
The Statistics screen shows some statistics about your audiobook listening history. It also allows you to
reset or disable statistics collection.
If any event, the data collected is only saved locally (in the devices internal storage) and is never
broadcast outside your device. The statistical data is anonymous and doesnt contain any book specific
information (such as title or author), but only the duration of listening per day.

Statistics
The main part of the
statistics screen shows
various statistics in four
sections:

General

Actions

The general section shows

the following information:

The bottom section contains

two buttons that control the
statistics.

Total listening duration

Number of listening days
Todays listening
duration (so far)
Daily average duration
(counting only days in
which the app was used)
Listening duration since
the beginning of the
current month.
Listening duration since
the beginning of the
current year.

Past Week
This section shows the
listening duration for each of
the past 7 days.

Weekday Average
This section shows the
listening duration for each
weekday (counting only days
in which the app was used).

Weekday Average
This section shows the
listening duration for each
year.

Page 18

Reset
The Reset button allows
you to delete all the statistics
collected so far. Pressing the
button show a dialog.
Approve the action to delete
all the statistical information
(warning, this cannot be
undone).

Stats Collection
The Stats Collection button
toggle stats collection mode.
When it is enabled (green
checkmark) statistics are
being collected. When it is
disabled (red cross mark)
statistics are not being
collected.

Widget
Akimbo Player comes equipped with a widget that allows basic play control from the home screen.

Installing the Widget

To install the widget perform a long press on an empty place in the home screen. Select Widgets from
the opened menu, and select Akimbo Player this will install the widget. You can also configure
widgets by pressing the menu button in the home screen and selecting Add.
Note that you can set the widget to any of the home screens on your device.

Using the Widget

The widget contains three sections.

Left Widget Button

The left section contains a button whose action is configurable (in Settings/Controls). When a book is
loaded, pressing this button will perform the configured action the default action is to rewind play
position a preset amount of time (equivalent to pressing the Small Step Back button in the player).
When a book is not loaded pressing this button will open the player.

Play/Pause
The right section contains the play/pause button. When a book is loaded pressing this button pauses or
resumes audio play (according to the state of the button). When a book is not loaded pressing this
button will open the player.

Book Information
The middle section shows the books title and author (or indicates that no book is loaded). Pressing it
will open the player.

Removing the Widget

To remove the widget click and hold it. After several seconds a recycle bin will appear at the bottom of
the screen. Drag the widget to the recycle bin to remove it.

Page 19

Appendix A Technical Details

Audio Formats

Chapters

Covers

The player natively parses

and supports the following
audio formats:

The player supports most

chaptering methods in audio
book files (M4A, M4B). If
chaptering is not supported
the player will treat each file
as a single chapter (without
impeding audio play).

The player supports most

inherent audio book file
covers. In addition you can
add covers from image files
or download covers
automatically from the web.

MP3 audio files

MP4 audio files
M4A (Apple Lossless
Audio File)
M4B (MPEG-4 Audio Book
File)
Vorbis (.ogg) audio files
Two more formats are
supported by the parser, but
you may need to download
additional software so that
your device can play them:
FLAC (Free Lossless Audio
Codec)
WMA (Windows Media
Audio)
In addition, any other format
supported on your device
may be played. It will be
parsed using the folder name
as the title, and the file name
as the chapter name.

Page 20

Appendix B Settings Factory Defaults

Following is a list of the factory defaults to all the attributes shown in the settings screen. Pressing
Reset button will revert to these values.
Table 3 Settings Factory Defaults

Tab
Player
Player
Player
Player
Player
Player
Player
Player
Player
Player
Player
Player
Library
Library
Library
Library
Library
Library
Library
Library
Library
Library
Library
Library
Library
Accessibility
Accessibility
Accessibility
Accessibility
Controls
Controls
Controls
Controls
Controls
Controls
Controls
Controls
Controls

Parameter
Show Step
Lock Step
Step Size
Display Step Size
Big Play Button
Display Notification Icon
Display Sleep Button
Display Bookmark Button
Max. Bookmarks
Startup Mode
Volume per Book
Previous Chapter at
Sort Criterion #1
Sort Criterion #2
Sort Criterion #3
Allow Merging by Title
Allow Merging MP3
Allow Merging MP4/M4B/M4A
Allow Merging Podcasts
Data Storage
Covers to Download
Audio Root Folder
Covers Root Folder
Audio Extensions
Cover Extensions
Mode
Voice Track
Voice Volume
Double Press
Headset
Headset Hook
Headset Play/Pause
Headset Stop
Headset Prev
Headset Next
Headset Rewind
Headset FF
Widget Left Button

Default Value
Enabled for all steps
Enabled for all except Small Step Back
10 seconds for small steps, 1 minute for large steps
Enabled
Enabled
Enabled
Enabled
Enabled
5
Resume Last Book
Enabled
3 seconds
Author in ascending order
Title in ascending order
N/A
Enabled
Enabled
Enabled
Disabled
Internal Storage
1
/sdcard/
/sdcard/
MP4;M4A;M4B;MP3;OGG;WMA;FLAC;
JPG;JPEG;BMP;GIF;PNG;
None
Male voice track
8
Disabled
Disabled
Disabled
Toggle Play/Pause
Pause
Previous Chapter
Next Chapter
Step Back
Step Forward
Step Back

Page 21

Appendix C Covers
When you press the cover search button in the Book Editing screen, or select the Download Covers
option in the Library screen, Akimbo App will initiate a web search to download suitable covers.
The search is based on each books updated Title and Author.
You can configure the number of covers to load for each book in the Settings screen.
When the Download Covers option for the entire library is chosen, only books without covers
will take part in the search.
The search automatically ignores numbers at the beginning of the books title. For example, if
your title is 04 Harry Potter and the Goblet of Fire, the search will actually be for Harry Potter
and the Goblet of Fire.
You can disable or enable any cover of a book (see Library Screen, Editing a Book).
The icon shown next to a book in the library screen will be the first enabled cover.
In the Player screen covers cycle with each chapter. If the chapter has an inherent cover it will be shown.
Otherwise, a cover from the list of the books enabled cover will be shown.

Page 22

Appendix D Advanced Information

Important: access the applications internal data at your own risk, and only if you know what you are
doing. Always take care to back up any data you may irrevocably harm.
When using the phones internal storage, the applications internal files are kept in the devices data
folder (this is usually /data/data), under com.akimbo.abp/app_audiobookplayer subfolder. When using
the SD card they are kept in /sdcard/.Akimbo

Library

Book User Data

Images

The library is kept in the file

library.dat.
This is an internal
serialization of java objects,
and should not be opened or
modified manually. If you
have a problem with your
library file, send it to
akimboapp@gmail.com and
we will do our best to try and
assist you.

Any user data information

(last played, last position,
volume, etc.) is kept per
book inside the userdata
folder. Each books user data
is kept in a file called
####.dat, where #### is the
books internal key (which
you can see in Book
Information). If you delete a
user file, the application will
revert to use the default user
data for the corresponding
book.
Each file is an internal
serialization of java objects,
and should not be opened or
modified manually. If you
have a problem with your
library file, send it to
akimboapp@gmail.com and
we will do our best to try and
assist you.

Downloaded images and

images extracted from inside
audio files are kept in the
images folder. The file name
is made of the images length
(in bytes), followed by an
underscore and the image
data MD5 hash.

Page 23

Credits and Support

Credits
This software was developed by Akimbo App, copyright 2011.
Special thanks to HK for advice, testing and support.
Development was done using JetBrains IntelliJ IDEA Community Edition
(http://www.jetbrains.com/idea/)
Thanks to J. J. Meddaugh and eyes-free (http://code.google.com/p/eyes-free/) for accessibility
suggestions and support.
Audio metadata parsing is based on Jaudiotagger (http://www.jthink.net/jaudiotagger/)
Icons by http://dryicons.com
Wheel widget design uses android-wheel (http://code.google.com/p/android-wheel/)

Troubleshooting
The troubleshooting section was moved to
https://docs.google.com/document/d/1ZaoXiOZK0zlhw4gOq_bFmeihZvYj9f9_NwrhbCLlM9k/view?hl=en

Support
Bugs, feature requests, and any other matters can be reported by e-mail to
akimbo.app@gmail.com. Please try to be as specific and explicit as possible in your mail, and
provide the application version and all the relevant information.
Visit Akimbo App Facebook page at http://www.facebook.com/pages/AkimboApp/191241390898010

Version Changes
Added statistics screen
Added big Play/Pause button
Added bookmark to headset actions
Added control of widgets left button
Added option to disable selected covers
Fixed bug of not saving bookmark/position until the library is saved for the first time after
update.
Added prefix removal to cover image downloader.
Fixed some issues with the Pause on call received feature.

Page 24