Android experimental releases

We are happy to introduce our new Experimental Release stage. It lets you be a part of the early stages of testing new features and help us improve functionality and polish developer experience.

4.2.1-experimental.2025041101 (2025-04-11)

API Docs

This version is based on the previously released 4.2.1.

New features

Added the new renderer Renderer.ContinuousScroll that shows all documents in a single vertical scrolling view.

4.0.0-experimental.2 (2023-11-02)

API Docs

Overview

We are pleased to finally invite you to try out our new native Audiobook support.

New in the Experimental 2 release is the ability to open EPUB3 with MO as audio only, with the option to synchronize with the ReaderView at any time if you wish.

For now we support playing from a LPF package, which is just a zipped up Audiobook. Support for HTTP streaming of "un-packaged" Audiobooks is coming in a future release. Support for additional formats will be added in upcoming releases.

Includes all changes and fixes introduced in framework version 3.8.0.

Breaking changes

Changed minimum Android version to 6.
ReaderView.visiblePages now returns List<VisiblePage> instead of List<VisiblePageData>
ReaderView.fetchRectsForVisibleContent has been removed. Please use VisiblePage.fetchRectsForVisibleContent instead.
SyncMediaPlayer.approximateElapsedTime has been renamed to SyncMediaPlayer.approximateElapsedTimeMs.
ContentLocation.fetchNavigationItemReferences onSuccess callback is now called with FetchNavigationItemReferencesResult instead of FetchNavigationItemReferencesResultData. Properties in FetchNavigationItemReferencesResult return List<ReaderPublicationNavigationItemReference> instead of List<ReaderPublicationNavigationItemReferenceData>.
The following suspend functions now return a ColibrioResult object:
- ContentLocationContentResolver.fetchTextContent
- ContentLocationContentResolver.fetchTextContentAfter
- ContentLocationContentResolver.fetchTextContentBefore
ColibrioMediaSessionMetadata.smallIconResId is now mandatory. It cannot be set to null.

Bug fixes

Fixed an issue where publicationHashSignature was calculated differently compared to the Web framework.
Fixed several issues where the playback state was not synced correctly when creating a SyncMediaPlayer from a ColibrioAudioPlayer for synchronization with a ReaderView.
Fixed several issues where the playback state was not synced correctly when destroying a SyncMediaPlayer that was synchronized with a ReaderView.
Fixed an issue where ColibrioAudioPlayer.approximateElapsedTimeMs did not update immediately when seeking.
Fixed an issue where ColibrioAudioPlayer.totalDurationMs returned 0 for a short amount of time when the ColibrioAudioPlayer was created.

New features

Added ColibrioAudioPlayer.buffering which is equivalent to calling !ColibrioAudioPlayer.ready && !ColibrioAudioPlayer.waitingForReaderViewSynchronization

4.0.0-experimental.1

API Docs

Overview

In this first experimental release we are very proud to let you play around with the our native Audiobook player!

The new ColibrioAudioPlayer is based on SyncMediaPlayer API that you already know. It moves the responsibility for all audio playback to the respective native platform.

A fully working demo application source is available in a public Bitbucket repository.

https://bitbucket.org/colibrio/colibrio-android-samples/src/main/AudioSample/

Check out the API documentation at https://api-docs.colibrio.com/android/4.0.0-experimental-1/colibrio-reader-framework/com.colibrio.readingsystem.audio/-colibrio-media-service/index.html for how to configure your app to use the new audio playback capability.

Major new features

New native ColibrioAudioPlayer class that handles playback of audio using the ExoPlayer library.
Support for audio playback of LPF packaged W3C Audiobooks and EPUB with Media Overlays.
Playback is handled through a service which allows it to continue in the background.
Full integration with the Android’s MediaSession features. This means that you can control the playback from any connected device that supports Media Session playback controls, such as Android Auto, Wear OS etc.

Upcoming features

Synchronisation with the Colibrio ReaderView . This feature will automatically synchronise the Audiobook player with the Reader View whenever you wish to both read and listen.
Support for additional, common audiobook formats. We want your feedback on this.