https://github.com/Acclorite/book-story
Book's Story — Material You eBook reader built with Jetpack Compose. Free & Open source & Ad-free, with extensive customization options and support for multiple file formats.
https://github.com/Acclorite/book-story
android app application book-reader epub epub-reader fb2 fb2-reader fdroid foss izzyondroid jetpack-compose kotlin material-you pdf pdf-reader reading txt txt-reader
Last synced: about 1 month ago
JSON representation
Book's Story — Material You eBook reader built with Jetpack Compose. Free & Open source & Ad-free, with extensive customization options and support for multiple file formats.
- Host: GitHub
- URL: https://github.com/Acclorite/book-story
- Owner: Acclorite
- License: gpl-3.0
- Created: 2023-12-29T22:20:50.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-09T17:18:52.000Z (about 2 months ago)
- Last Synced: 2025-03-09T18:25:04.830Z (about 2 months ago)
- Topics: android, app, application, book-reader, epub, epub-reader, fb2, fb2-reader, fdroid, foss, izzyondroid, jetpack-compose, kotlin, material-you, pdf, pdf-reader, reading, txt, txt-reader
- Language: Kotlin
- Homepage:
- Size: 65 MB
- Stars: 661
- Watchers: 9
- Forks: 37
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Book's Story
Material You eBook Reader for Android
Dive into the world of adventure as you discover your favorite book's story!
---
[](https://github.com/Acclorite/book-story/releases)
[](https://gitlab.com/Acclorite/book-story/-/releases)
[](https://codeberg.org/Acclorite/book-story/releases)
[](https://f-droid.org/packages/ua.acclorite.book_story/)
[](https://apt.izzysoft.de/fdroid/index/apk/ua.acclorite.book_story)
[](https://hosted.weblate.org/engage/book-story/)
[](https://matrix.to/#/#book-story:matrix.org)
[](LICENSE)
Overview
Enjoy a sleek, customizable **reading app** with modern design, built with Jetpack Compose. It’s
open-source, offering you a personalized, ad-free journey through your favorite books!
---
## 🖌️ Screenshots
---
## ✨ Features
- Storage Access Framework
- 7 supported file formats(.pdf, .txt, .epub, .fb2, .html, .htm, .md)
- Material You design with unique themes and color presets
- Organized Library with categories and chapters in Reader
- Highly customizable
---
## ✈️ Download
- _Please note, that the app supports Android versions only from Android 8.0_
[
](https://github.com/Acclorite/book-story/releases/latest)
[
](https://gitlab.com/Acclorite/book-story/-/releases)
[
](https://codeberg.org/Acclorite/book-story/releases)
[
](https://f-droid.org/en/packages/ua.acclorite.book_story/)
[
](https://apt.izzysoft.de/fdroid/index/apk/ua.acclorite.book_story)
---
### 📲 How to download and install
- _**Installing from GitHub, GitLab, Codeberg**_: Click the "Get it on ..." badge above, select
desired release, scroll down, and download
**book-story.apk**. Once downloaded, locate the APK file and install it.
- _**Installing from F-Droid**_: Click the "Get it on F-Droid" badge above, scroll down, and click "
Download APK" under your desired release version to download the APK file. Once downloaded, locate
the file and install it.
- _**Installing from IzzyOnDroid**_: Click the "Get it on IzzyOnDroid" badge above, scroll down, and
click "Download" to get the latest APK from IzzyOnDroid. Once downloaded, locate the file and
install it.
- If you're unsure how to install an APK file,
follow [this](https://www.lifewire.com/install-apk-on-android-4177185) guide.
---
### 🧭 Afterwards
Open the app and follow the basic instructions. If you're unsure how to use the app, refer to the
Help screen (accessible via: Library, History, Browse → Three Dots → Help). If you still have
questions, feel free to ask me anywhere (for example, *Discussions*
or [Matrix server](https://matrix.to/#/#book-story:matrix.org)).
---
## 🌐 Translation
[
](https://hosted.weblate.org/engage/book-story/)
_Help translate the app on [Hosted Weblate](https://hosted.weblate.org/engage/book-story/)._
---
## 🤝 How to contribute
- **The most important thing is that I do not want anyone else's code.** This project is maintained
solely by me, and I intend to keep it that way. Pull/merge requests will likely be closed, as they
don’t align with the project's vision.
- **Submit your suggestions on Issues.** Feel free to share your thoughts!
- **Join the Matrix server** to share your ideas, report bugs, or just chat with me
on [this server](https://matrix.to/#/#book-story:matrix.org)!
- **Share your ideas and suggestions.** If you’re missing a feature or have an interesting idea,
feel free to create a new *Issue*.
- **Report bugs.** Encountered a crash or something went wrong? Create a new *Issue* with as much
detail as possible to help resolve it.
- **Translate the app.** You can help make the app accessible in multiple languages. To contribute,
visit [Hosted Weblate](https://hosted.weblate.org/engage/book-story/).
- **Enjoy the app.** The best contribution is simply using and enjoying the app I spent so much time
on!
---
## 🤗 Credits
- [Tachiyomi (Mihon)](https://github.com/mihonapp/mihon) (GitHub)
- [Kitsune](https://github.com/Drumber/Kitsune) (GitHub)
- [Voyager](https://voyager.adriel.cafe/) (Voyager Website)
- [Material Design Icons](https://fonts.google.com/icons) (Google Fonts)
- [Material Design Fonts](https://fonts.google.com) (Google Fonts)
- [Weblate Translators](https://hosted.weblate.org/projects/book-story) (Hosted Weblate)
- [Censorship / GitLab Badge](https://censorship.no/en/index.html) (Censorship Website)
- [GitHub Badge](https://github.com/Kunzisoft/Github-badge) (GitHub)
- [Codeberg Badge](https://codeberg.org/Codeberg/GetItOnCodeberg) (Codeberg)
- Also listed in About > Credits.
---
## 🧾 License
Book's Story — free and open-source Material You eBook reader.
Copyright (C) 2024-2025 Acclorite
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .