Readium-2

A repo for storing documents and discussing Readium-2.

Readium-2 is the new major project of the Readium Foundation. It defines a set of native software modules dedicated to digital reading apps, optimized for the following platforms:

• iOS
• Android
• Windows
• Linux
• macOS

Modules are written in different programming languages, with a common model and architecture.

This is different from the initial Readium SDK approach where a monolithic core is written in C++ and called from native apps (in e.g. Objective-C or Java).

This flexible architecture can be used for standalone apps, server apps and Web apps.

Keeping Track

There are multiple ways to keep track of the on-going activity and participate:

• discussions on the issue tracker
• action items and epics on the project board
• weekly calls with our archive of meeting notes and recordings
• multiple channels on the Slack team for Readium (#readium-2, #r2-swift and #r2-java)

Readium-2 Architecture

All Readium-2 implementations (mobile, desktop or Web app) are split in two main modules, which use HTTP for exchanging data, may therefore be running on different systems, and may be written in different languages.

One module contains a parser for packaged publications (EPUB or CBZ today), generates a Readium Web Publication Manifest and exposes every resource of the publication via an HTTP server; we call it a "streamer", as it exposes the individual resources of the publication.

Another module processes the Web Publication Manifest, renders the publication (usually on screen) and handles user navigation; we call it a "navigator".

Modules

Main Modules

• Streamer
• Navigator
• Web Publication Manifest
• Readium CSS
• Locators

Services

• Location Resolver
• Media Overlay
• Positions List
• Search

Active Projects

iOS / Swift

For an overview of how Readium-2 on iOS works, we highly recommend taking a look at the iOS Test App.

The Test App integrates the following modules into a single iOS application:

• Shared Model
• Streamer
• Navigator

This app is currently tested on TestFlight by a first batch of alpha testers.

Android

On Android, things are going to be changing a lot until the end of the year (2017).

The only active project is a Java implementation of the streamer.

The current plan is to port all iOS modules to Kotlin in Q4 2017.

JavaScript

EDRLab is actively working on a production app called Readium Desktop built on top of a Typescript-based implementation of the streamer.

There are also two projects implementing a JS-based navigator:

• webpub-viewer - An iframe-based navigator, written in TypeScript (NYPL)
• epub.js - Support for the streamer is in development as part of the v0.3 release (Future Press)

Go

The first implementation of a streamer was written in Go, mostly for server-side deployment.

This project is active and hosted on this organization.

Prototypes

• webpub-viewer - An iframe based navigator, written in JS (Hadrien Gardeur)
• comics-viewer - An img based navigator for comics, written in JS (Hadrien Gardeur)
• audiobook-player - An audio based navigator for audiobooks, written in JS (Hadrien Gardeur)