**The development and support of Librera is frozen for an unpredictable time, there is a big war in my country
Ukraine.**
[Russian invasion of Ukraine](https://en.wikipedia.org/wiki/2022_Russian_invasion_of_Ukraine)
# Librera Reader
Librera Reader is an e-book reader for Android devices;
it supports the following formats: PDF, EPUB, EPUB3, MOBI, DjVu, FB2, TXT, RTF, AZW, AZW3, HTML, CBZ, CBR, DOC, DOCX,
and OPDS Catalogs
# Download application
[Librera on Google Play](https://play.google.com/store/apps/details?id=com.foobnix.pdf.reader)
[Librera PRO on Google Play](https://play.google.com/store/apps/details?id=com.foobnix.pro.pdf.reader)
[Librera F-Droid](https://f-droid.org/en/packages/com.foobnix.pro.pdf.reader/)
### Other Librera Applications
[LibreraX](https://librera.app/librerax/)
[Librera1](https://librera.app/librera1/)
[LibreraCommander](https://librera.app/librera-commander/)
### Links
[FAQ](https://librera.mobi/faq/)
[Librera Community in Telegram](https://t.me/librera_reader_chat)
[Support on Patreon](https://www.patreon.com/librera)
[librera.reader@gmail.com](mailto:librera.reader@gmail.com)
## Required build libs
~~~~
mesa-common-dev libxcursor-dev libxrandr-dev libxinerama-dev libglu1-mesa-dev libxi-dev pkg-config libgl-dev
~~~~
You also need the Android NDK in version 20+
Please ensure to download it using android studio and add the NDK to your PATH.
## Create a keystore
Even if you do not plan to upload a version yourself you need a keystore with a certificate to build.
The keystore needs to be in PKCS12 format.
You can create a keystore in your actual directory using the following call
(replace ALIAS by your alias, it is just a name):
~~~~
keytool -genkey -v -storetype PKCS12 -keystore keystore.pkcs12 -alias ALIAS -keyalg RSA -keysize 2048 -validity 10000
~~~~
Now edit or create the file ~/.gradle/gradle.properties and set following values
(replacing PASSWD by the password you typed while creating the keystore, ALIAS as before and using the path to your
keystore):
~~~~
RELEASE_STORE_FILE=/PATH/TO/YOUR/keystore.pkcs12
RELEASE_STORE_PASSWORD=PASSWD
RELEASE_KEY_PASSWORD=PASSWD
RELEASE_KEY_ALIAS=ALIAS
~~~~
## Create Firebase Authentication file
To build with firebase support (all version but the ones for Fdroid) you need to get an
authentication file for firebase services offered by google. Therefore please follow
https://firebase.google.com/docs/android/setup to create your own project. You need to
register for the packages com.foobnix.pdf.info and com.foobnix.pdf.reader.a1. This way
you will get a google-services.json file that you have to place in the app folder of
the repository.
For this project only Analytics is used, so a spakling plan is all you need.
## Librera Build on MuPdf
~~~~
cd Builder
./link_to_mupdf_x.x.x.sh (Change the paths to mupdf and jniLibs folders)
cd ..
./gradlew assembleLibrera
~~~~
## Building for F-Droid for Android
If you wish to build for F-Droid (e.g. not using google services, Internet) you can run the build with
~~~~
cd Builder
./link_to_mupdf_x.x.x.sh
cd ..
./gradlew assembleFdroid
~~~~
F-Droid build does also not need a **google-services.json**
## What's new
See [CHANGELOG.md](CHANGELOG.md) for all changes.
Full release notes: https://github.com/foobnix/LibreraReader/releases
[Unreleased APK Direct Download](http://beta.librera.mobi)
## Android versions
| App Version | Librera PRO | Librera F-Droid | Release Date |
|-------------|--------------|-----------------|--------------|
| [9.5.7](https://github.com/foobnix/LibreraReader/releases/tag/9.5.7) | 7.0 (API 24) | 7.0 (API 24) | 2026-09-02 |
| [9.4.21](https://github.com/foobnix/LibreraReader/releases/tag/9.4.21) | 7.0 (API 24) | 7.0 (API 24) | 2026-07-21 |
| [9.4.8](https://github.com/foobnix/LibreraReader/releases/tag/9.4.8) | 7.0 (API 24) | 7.0 (API 24) | 2026-05-21 |
| [9.4.5](https://github.com/foobnix/LibreraReader/releases/tag/9.4.5) | 7.0 (API 24) | 7.0 (API 24) | 2026-05-19 |
| [9.3.75](https://github.com/foobnix/LibreraReader/releases/tag/9.3.75) | 7.0 (API 24) | 7.0 (API 24) | 2026-04-24 |
| [9.3.63](https://github.com/foobnix/LibreraReader/releases/tag/9.3.63) | 7.0 (API 24) | 7.0 (API 24) | 2026-03-02 |
| [9.3.55](https://github.com/foobnix/LibreraReader/releases/tag/9.3.55) | 7.0 (API 24) | 7.0 (API 24) | 2026-01-29 |
| [9.3.35](https://github.com/foobnix/LibreraReader/releases/tag/9.3.35) | 7.0 (API 24) | 7.0 (API 24) | 2026-01-23 |
| [9.3.19](https://github.com/foobnix/LibreraReader/releases/tag/9.3.19) | 7.0 (API 24) | 7.0 (API 24) | 2026-01-20 |
| [9.3.10](https://github.com/foobnix/LibreraReader/releases/tag/9.3.10) | 7.0 (API 24) | 7.0 (API 24) | 2026-01-15 |
| [9.3.1](https://github.com/foobnix/LibreraReader/releases/tag/9.3.1) | 7.0 (API 24) | 7.0 (API 24) | 2026-01-12 |
| [9.2.40](https://github.com/foobnix/LibreraReader/releases/tag/9.2.40) | 7.0 (API 24) | 7.0 (API 24) | 2026-01-08 |
| [9.2.31](https://github.com/foobnix/LibreraReader/releases/tag/9.2.31) | 7.0 (API 24) | 7.0 (API 24) | 2026-01-02 |
| [9.2.21](https://github.com/foobnix/LibreraReader/releases/tag/9.2.21) | 7.0 (API 24) | 7.0 (API 24) | 2025-12-30 |
| [9.2.4](https://github.com/foobnix/LibreraReader/releases/tag/9.2.4) | 7.0 (API 24) | 7.0 (API 24) | 2025-12-25 |
| [9.1.35](https://github.com/foobnix/LibreraReader/releases/tag/9.1.35) | 7.0 (API 24) | 5.0 (API 21) | 2025-12-08 |
| [9.1.29](https://github.com/foobnix/LibreraReader/releases/tag/9.1.29) | 7.0 (API 24) | 5.0 (API 21) | 2025-12-01 |
| [9.1.14](https://github.com/foobnix/LibreraReader/releases/tag/9.1.14) | 7.0 (API 24) | 4.1 (API 16) | 2025-11-27 |
| [9.1.7](https://github.com/foobnix/LibreraReader/releases/tag/9.1.7) | 7.0 (API 24) | 4.1 (API 16) | 2025-11-25 |
| [9.0.5](https://github.com/foobnix/LibreraReader/releases/tag/9.0.5) | 7.0 (API 24) | 4.1 (API 16) | 2025-07-10 |
| [9.0.1](https://github.com/foobnix/LibreraReader/releases/tag/9.0.1) | 7.0 (API 24) | 4.1 (API 16) | 2025-07-09 |
| [8.9.182](https://github.com/foobnix/LibreraReader/releases/tag/8.9.182) | 5.0 (API 21) | 4.1 (API 16) | 2024-11-06 |
| [8.9.181](https://github.com/foobnix/LibreraReader/releases/tag/8.9.181) | 5.0 (API 21) | 4.1 (API 16) | 2024-10-24 |
| [8.9.175](https://github.com/foobnix/LibreraReader/releases/tag/8.9.175) | 5.0 (API 21) | 4.1 (API 16) | 2024-05-13 |
| [8.9.170](https://github.com/foobnix/LibreraReader/releases/tag/8.9.170) | 5.0 (API 21) | 4.1 (API 16) | 2024-04-05 |
| [8.9.161](https://github.com/foobnix/LibreraReader/releases/tag/8.9.161) | 5.0 (API 21) | 4.1 (API 16) | 2024-03-12 |
| [8.9.158](https://github.com/foobnix/LibreraReader/releases/tag/8.9.158) | 5.0 (API 21) | 4.1 (API 16) | 2024-01-05 |
| [8.9.147](https://github.com/foobnix/LibreraReader/releases/tag/8.9.147) | 5.0 (API 21) | 4.1 (API 16) | 2023-12-29 |
| [8.9.133](https://github.com/foobnix/LibreraReader/releases/tag/8.9.133) | 5.0 (API 21) | 4.1 (API 16) | 2023-12-21 |
| [8.9.126](https://github.com/foobnix/LibreraReader/releases/tag/8.9.126) | 5.0 (API 21) | 4.1 (API 16) | 2023-12-18 |
## Librera depends on
| Library | Version | License |
|------------|------------------|----------------------|
| MuPDF | 1.28.5 (1.23.7) | AGPL-3.0 |
| DjVuLibre | 3.5.28 | GPL-2.0-or-later |
| antiword | 1.3.1 | GPL-2.0 |
| libmobi | 0.12 | LGPL-3.0-or-later |
| hqx | 1.2 | LGPL-2.1-or-later |
| LAME | 3.100 | LGPL-2.0-or-later |
| libwebp | 1.3.2 | BSD-3-Clause |
| libarchive | 3.8.10 | BSD-2-Clause |
| Component | License |
|-------------------------------------------|-------------------------------|
| EBookDroid (`org.ebookdroid`, `org.emdev`) | GPL-3.0 1 |
| wmf2svg (`net.arnx.wmf2svg`) | Apache-2.0 |
| PBKDF2 (`de.rtner`) | LGPL-2.1-or-later |
| opendocument.java (`at.stefl`) | not declared 1 |
| DragLinearLayout (`com.jmedeisis`) | Apache-2.0 1 |
| HSV colour picker (`com.buzzingandroid`) | Apache-2.0 1 |
| android-lame JNI (`com.github.axet`) | Apache-2.0 1 |
| Dependency | Version | License |
|---------------------------------------------|----------------|-----------------------------|
| androidx.appcompat:appcompat | 1.7.1 | Apache-2.0 |
| androidx.cardview:cardview | 1.0.0 | Apache-2.0 |
| androidx.legacy:legacy-support-v4 | 1.0.0 | Apache-2.0 |
| androidx.recyclerview:recyclerview | 1.4.0 | Apache-2.0 |
| androidx.work:work-runtime | 2.11.2 | Apache-2.0 |
| org.greenrobot:eventbus | 3.3.1 | Apache-2.0 |
| org.greenrobot:greendao | 3.3.0 | Apache-2.0 |
| org.greenrobot:greendao-api | 3.3.0 | Apache-2.0 |
| org.jsoup:jsoup | 1.22.2 | MIT |
| com.github.albfernandez:juniversalchardet | 2.5.0 | MPL-1.1 / GPL-3.0 / LGPL-3.0 |
| com.squareup.okhttp3:okhttp | 3.12.6 | Apache-2.0 |
| io.github.rburgst:okhttp-digest | 3.1.1 | Apache-2.0 |
| com.squareup.okio:okio | 1.17.6 | Apache-2.0 |
| com.github.joniles:rtfparserkit | 1.16.0 | Apache-2.0 |
| org.zwobble.mammoth:mammoth | 1.5.0 | BSD-2-Clause |
| javax.xml.stream:stax-api | 1.0-2 | CDDL-1.0 / GPL-2.0 |
| net.lingala.zip4j:zip4j | 2.11.6 | Apache-2.0 |
| com.github.bumptech.glide:glide | 4.16.0 | BSD-2-Clause and Apache-2.0 |
| commons-logging:commons-logging-api | 1.1 | Apache-2.0 |
| com.google.guava:guava | 33.6.0-android | Apache-2.0 |
| org.commonmark:commonmark | 0.29.0 | BSD-2-Clause |
| org.commonmark:commonmark-ext-gfm-tables | 0.29.0 | BSD-2-Clause |
Librera is distributed under the GPL v3
## License
See the [LICENSE](LICENSE.txt) file for license rights and limitations (GPL v.3).