Readium Swift Toolkit

Readium Mobile is a toolkit for ebooks, audiobooks and comics written in Swift & Kotlin.

[!TIP] Take a look at the guide to quickly get started. A Test App demonstrates how to integrate the Readium Swift toolkit in your own reading app.

Features

✅ Implemented      🚧 Partially implemented      📆 Planned      👀 Want to do      ❌ Not planned

Formats

Ebook and Document Formats

Audiobook Formats

Comic Formats

Features

A number of features are implemented only for some publication formats.

OPDS Support

DRM Support

User Guides

Guides are available to help you make the most of the toolkit.

Publication

• Opening a publication – parse a publication package (EPUB, PDF, etc.) or manifest (RWPM) into Readium Publication models
• Extracting the content of a publication – API to extract the text content of a publication for searching or indexing it
• Searching a publication – search the textual content of a publication and navigate to matching results
• Text-to-speech – read aloud the content of a textual publication using speech synthesis
• Accessibility – inspect accessibility metadata and present it to users

Navigator

• Navigator - an overview of the Navigator to render a Publication's content to the user
• Configuring the Navigator – setup and render Navigator user preferences (font size, colors, etc.)
• Integrating the Navigator with SwiftUI – glue to setup the Navigator in a SwiftUI application
• Implementing Highlights – add and manage highlights in a publication
• Font families in the EPUB navigator – support custom font families with reflowable EPUB publications
• EPUB image preview – detect tapped images and present an image detail view

DRM

• Supporting Readium LCP – open and render LCP DRM protected publications

Setting up the Readium Swift toolkit

Minimum Requirements

Dependencies

The toolkit's libraries are distributed with Swift Package Manager (recommended) and CocoaPods. It's also possible to clone the repository (or a fork) and depend on the libraries locally.

The Test App contains examples on how to use all these dependency managers.

Swift Package Manager

From Xcode, open File > Add Packages and use Readium's GitHub repository for the package URL: https://github.com/readium/swift-toolkit.git.

You are then free to add one or more Readium libraries to your application. They are designed to work independently.

If you're stuck, find more information at developer.apple.com.

CocoaPods

Add the following pod statements to your Podfile for the Readium libraries you want to use:

source 'https://github.com/readium/podspecs'
source 'https://cdn.cocoapods.org/'

pod 'ReadiumShared', '~> 4.0.0-alpha.1'
pod 'ReadiumStreamer', '~> 4.0.0-alpha.1'
pod 'ReadiumNavigator', '~> 4.0.0-alpha.1'
pod 'ReadiumOPDS', '~> 4.0.0-alpha.1'
pod 'ReadiumLCP', '~> 4.0.0-alpha.1'

Take a look at CocoaPods's documentation for more information.

Local Git Clone

You may prefer to use a local Git clone if you want to contribute to Readium, or if you are using your own fork.

First, add the repository as a Git submodule of your app repository, then checkout the desired branch or tag:

git submodule add https://github.com/readium/swift-toolkit.git

Next, drag and drop the whole swift-toolkit folder into your project to import Readium as a Swift Package.

Finally, add the Readium libraries you want to use to your app target from the General tab, section Frameworks, Libraries, and Embedded Content.

Building with Readium LCP

Using the toolkit with Readium LCP requires additional dependencies, including the framework R2LCPClient.framework provided by EDRLab. Contact EDRLab to request your private R2LCPClient.framework and the setup instructions.

Credits

This project is tested with BrowserStack.