Status: Full Catholic Bible (73 books, 34,827 verses) is bundled in the FAP—install and read with no SD card required. For catalog submission: add app screenshots (qFlipper) and see changelog. Details: Status Report.
A fully offline Catholic Bible application for the Flipper Zero, featuring the complete Douay-Rheims Bible (full Catholic canon), verse-level navigation, bookmarks, history, and fast indexed search.
This app turns the Flipper Zero into a portable Scripture reader:
- 📖 Full Catholic Bible (Douay-Rheims, public domain) - ✅ Bundled in FAP (optional SD override)
- 🔍 Fast verse-level indexed search (offline) - Planned (Phase 3)
- 🧭 Book → Chapter → Verse navigation - ✅ Implemented
- 🔖 Bookmarks and recent history - ✅ Implemented
- 💾 microSD-based content and updates - ✅ Infrastructure Ready
- 📴 Fully offline, reverent, distraction-free - ✅ Implemented
- ✝️ Catholic Devotional Features - ✅ UI Complete (Missal, Rosary, Prayers, Confession, Guides)
The design intentionally avoids commentary, notes, audio, or online features to keep focus on the text itself.
A one-page product site is in website/ and is deployed to GitHub Pages on push to main:
- URL (once enabled): https://flipper-catholic.github.io/flipper-catholic-bible/
- To enable: In this repo go to Settings → Pages. Set Source to GitHub Actions. The workflow
.github/workflows/deploy-pages.ymlwill run on each push tomainand publish thewebsite/folder.
- Navigation Structure: Full menu system (Menu → Books → Chapters → Verses)
- Book Metadata: All 73 Catholic canon books with chapter counts
- Chapter Pagination: Browse chapters with 40 chapters per page
- Reader View: ViewPort-based rendering, infinite scroll (Up/Down = prev/next verse), single-spaced full-width text
- Full Bible: 73 books, 34,827 verses bundled in FAP; optional SD
/apps_data/bible/override - Verse Counts: Accurate for Genesis (50 chapters); placeholder for other books
- SD Card Storage: Optional override; app works without SD
- Bookmarks: Full bookmark management; OK in reader toggles bookmark; Bookmarks menu lists all, tap to open verse
- History: Automatic history tracking and last-read verse; Last read menu item jumps to last verse; History menu lists recent verses, tap to open
- Devotional Features: UI structure for Missal, Rosary, Prayers, Confession; Guides (Order of Mass, OCIA, Lenten, Easter, Pentecost, Sacraments, Marrying Catholic) with scaffold content
- Verse Counts: Genesis complete; remaining 72 books use placeholder (Phase 1.3)
- Catalog: Add app screenshots (qFlipper) and submit manifest to Flipper Apps Catalog
- Full Catholic canon (73 books) - Phase 2
- Continuous reading with paging - Phase 1
- Structured picker navigation - ✅ Done
- Exact preservation of Scripture text - Phase 2
- Indexed full-text search - Phase 3
- Partial-word matching (prefix-based) - Phase 3
- AND / OR search logic - Phase 3
- Highlighted search matches - Phase 3
- Canonical or relevance-based result ordering - Phase 3
- Multiple bookmarks - ✅ Implemented
- Recent reading history - ✅ Implemented
- Automatic restore of last-read verse - ✅ Implemented
- Guided recovery if assets are missing or corrupted - Phase 5
- Optional advanced reindexing - Phase 5
- Deterministic, auditable asset files - Phase 2
- Requirements: Flipper Zero, microSD card, firmware that supports external apps.
- Install: Install the Catholic Bible FAP (from the Flipper app catalog or by building and sideloading). Put the microSD card in the Flipper.
- First launch: The app includes the full Douay-Rheims Bible (~35k verses). On first run, the system unpacks these assets to the SD card. No manual file copy is needed—just install the FAP and open the app.
- Optional manual copy: You can instead (or also) copy
bible_text.binandverse_index.binto the SD card at/apps_data/bible/; the app prefers that path if present.
python3 -m pip install --upgrade ufbt # if needed
ufbt build
# Deploy to attached device: connect Flipper via USB, then:
ufbt launchBuild note: If tools/verse_counts_generated.c exists and the build fails with duplicate-symbol errors, move it out of the build (e.g. mv tools/verse_counts_generated.c .build_exclude/) so only src/books_meta.c provides verse counts.
Deploy: With the Flipper connected via USB, run ufbt launch. The first time (or after a full build) it installs the FAP to the device; allow 2–3 minutes for the transfer (~7 MB at USB speed).
The repo includes pre-built assets in the files/ folder so that ufbt build produces a FAP that contains the full Bible. The app appears under Apps → Tools with the cross icon.
Reader: Up/Down scroll; at edges, Up/Down = previous/next verse. Left/Right change verse. OK = toggle bookmark. Back exits to chapter list.
Menu: Last read, Bookmarks, History as described above.
To use your own build of the assets (e.g. after editing assets/source/bible_source.json):
- Run
python3 tools/build_bible_assets.py(see docs/full-bible-acquisition-plan.md for the full Bible). - Copy
dist/apps_data/bible/bible_text.binandverse_index.binto the Flipper SD at/apps_data/bible/. - To refresh the bundled copy (so the next FAP you build includes it), also copy those two files into the project’s
files/folder and runufbt buildagain. Seefiles/README.md.
- Translation: Douay-Rheims
- License: Public Domain
- Canon: Full Catholic canon
Contributions are welcome:
- Bug fixes
- Performance improvements
- Documentation
- Asset tooling improvements
Please keep the UI minimal and reverent, and follow the existing architecture and specs.
See STATUS_REPORT.md for detailed implementation status, known issues, and roadmap.
Current Completion: ~45-55% of planned features
Marketplace Readiness:
Testing Status: ✅ Ready for device testing
Next Milestone: Expand SD assets (full Genesis/Bible); Phase 3 search (index + engine); Phase 5 error handling
- Code: MIT License (see LICENSE)
- Bible Text (Douay-Rheims): Public Domain