Free/libre software for Kobo ebook readers

Go to file

Cosmin Gorgovan 3e437f26ff Koreader: open /mnt at startup instead of /mnt/onboard		2016-04-26 20:12:54 +01:00
files	Koreader: don't reset the frontlight brightness when waking up from suspend	2016-04-26 19:46:16 +01:00
src	Koreader: open /mnt at startup instead of /mnt/onboard	2016-04-26 20:12:54 +01:00
.gitignore	Add kobo_hwconfig build files to .gitignore	2016-01-06 11:37:31 +00:00
.gitmodules	Build u-boot	2016-01-04 02:13:58 +00:00
build_rootfs.sh	Koreader: open /mnt at startup instead of /mnt/onboard	2016-04-26 20:12:54 +01:00
build.sh	Koreader: open /mnt at startup instead of /mnt/onboard	2016-04-26 20:12:54 +01:00
fetch.sh	Rename fetch_sources to fetch	2015-02-10 21:40:44 +00:00
README.md	Add some basic information to the README.	2016-01-03 01:20:35 +00:00

README.md

okreader

Free/libre firmware for Kobo ebook readers. No proprietary software (except firmware for the WiFi adapter), no spyware and no DRM. Based on koreader and Debian.

Supported hardware

Tested on:

Kobo Touch
Kobo Aura

okreader is also expected to work on Kobo Glo out of the box.

There seem to be multiple hardware revisions with different WiFi adapters. The firmware-okreader package only provides the required firmware for the adapters in the devices I've tested.

Usage

Note: The build system is intended to run on Debian or Ubuntu, on ARM. Cross-building should also be possible with little effort, but it's not implemented. If you don't have access to an ARM system, you could try using QEMU.

Fetch all resources:

git clone https://github.com/lgeek/okreader.git
cd okreader
git submodule init
git submodule update
./fetch.sh all

Build all packages:

./build.sh all

...or, alternatively, one at a time:

./build.sh linux-image
./build.sh linux-modules
./build.sh firmware-okreader
./build.sh koreader

Prepare a Debian rootfs:

./build_rootfs.sh

Installation on the device

To be documented...