How to use it
Two ways in — read the ready-made Bible, or build your own.
There’s nothing to sign up for and nothing runs in the cloud. Pick the path that fits you: download the finished Ethiopian Tewahedo Study Bible and start reading, or install the free desktop program and assemble an edition that’s exactly yours.
Path 1 — Read the Ready-Made Ethiopian Bible
The fastest way in. The full Ethiopian Tewahedo Study Bible is a single ebook file — the complete canon in English, with the whole study apparatus and the original languages built in. No program required; it opens in any e-reader.
Step 1 — Download the File
On the Releases page, pick the version for your reader:
- Apple Books, Google Play Books, and most readers → the plain
.epub(YHWH-Ethiopian-Bible-v0.1.0.epub). - Kobo → the
.kepub.epub. It’s the same Bible, packaged so that tapping a verse opens its notes and original languages as a pop-up — Kobo only does that for the.kepubform.
Step 2 — Open It on Your Device
A walk-through for each kind of device:
- iPhone / iPad / Mac (Apple Books). Open the
.epuband it’s added to your library — or email it to yourself and tap “Copy to Books.” Tap any ◈ marker in the text and the study notes open in a pop-up panel; the verse’s own marker opens its original languages. - Kobo e-reader. Connect the Kobo to your computer with its USB cable, copy the
.kepub.epubinto the Kobo’s drive (or its.kobofolder), and eject. The book appears in your library after a moment. Tapping a ◈ marker opens the notes as a quick-look popup. For Hebrew, Greek, Geʽez, and Arabic in those popups, add the free font pack — one step, described below. - Android phone or tablet. Open the
.epubin any reading app — Google Play Books (add it at play.google.com/books or open the file directly), Moon+ Reader, or any standards-compliant EPUB app. - Computer (Windows / macOS / Linux). Any desktop EPUB reader works — for example the free Thorium Reader, or Calibre’s built-in viewer. On a Mac, Apple Books opens it directly.
- Kindle. Not yet — the current release does not convert cleanly through Amazon’s
Send to Kindle, and a Kindle-ready build is in progress. Until it ships, a Kindle tablet
(Fire) can read the
.epubin an Android reading app.
Step 3 — Read, and Tap for More
Read normally. Where a verse carries study notes, you’ll see a small ◈ diamond with a count beside it — ◈16 means sixteen distinct notes. Tap it and the notes open in a single tidy panel, gathered into a cascade that reads like the Bible itself: verse, then category, then source, then the notes.
Each kind of note opens its own labelled group, in a fixed most-useful-first order — every group heading pairs the category’s manuscript symbol with its name spelled out, and a thin coloured stripe down its left edge marks the category at a glance (the structure holds even on a black-and-white e-ink screen). Inside a group, each source is named once — a short line in italics, such as Easton’s Illustrated Bible Dictionary (1897) — with its notes stepped in beneath, and the topical indexes merged into one de-duplicated line at the end. Nothing is dropped; the notes are only grouped and tidied. The full symbol legend is on the home page.
A separate marker opens the verse in its original languages (Hebrew, Greek, Latin, Arabic). Use the reader’s own table of contents to move between books and chapters, and the reader’s controls for font size, spacing, and theme — the Bible follows your reader’s settings.
Tip. On Kobo, if pop-ups don’t open, make sure you sideloaded the
.kepub.epub (not the plain .epub).
Optional — The Kobo Font Pack
Kobo’s quick-look popup uses the device’s own reading font — which usually
can’t draw Hebrew, Greek, Geʽez, or Arabic. The fix is one step: download the free
font
pack (five open-licensed fonts), unzip it, and copy the font files into a folder named
fonts at the top of your Kobo’s drive while it’s connected by USB. Then, on the
device, pick Cardo (or any of the pack’s fonts) as your reading font — the
popups follow it, and the ancient scripts render properly.
Path 2 — Build Your Own Edition
The desktop program lets you shape your own study Bible from one big storehouse of Scripture and study — choose the books, the notes, the languages, and the look — then export a clean ebook. It runs entirely on your own computer: no account, no cloud, and no internet connection needed once it’s installed.
Step 1 — Install the Program
From the Releases page, download the build for your system:
- Windows — run the
.exeinstaller and follow the prompts. It’s code-signed, so it should open without a warning; if Windows SmartScreen ever appears, choose More info → Run anyway. - macOS — open the
.dmgand drag YHWH into your Applications folder. It’s notarized by Apple; if Gatekeeper hesitates, right-click the app and choose Open the first time. - Linux — make the
.AppImageexecutable (chmod +xor Properties → Permissions) and run it; no installation needed.
Step 2 — Launch It
Open the program. It runs locally in its own window — there’s no website to log into and no data leaves your machine. You’ll start from the full storehouse and narrow it down to your edition.
Step 3 — Choose Your Starting Edition
Nine ready-made editions ship with the program. Each is a complete, working recipe — pick the one nearest to the Bible you want, then adjust anything about it (or build from the full storehouse instead):
- The Ethiopian Tewahedo Study Bible — the full 83-book canon with the complete apparatus; the same Bible as the ready-made download in Path 1.
- The Catholic Study Bible — Ethiopian Edition — the Catholic canon, with the Catholic commentary stream featured.
- The Eastern Orthodox Study Bible — the Orthodox canon, with patristic and Orthodox commentary featured.
- The Coptic Orthodox Study Bible — the full canon read with the Coptic Orthodox tradition featured.
- The Anglican Study Bible — BCP Edition — the broader canon with the Apocrypha, read in the Book of Common Prayer tradition.
- The Lutheran Confessional Study Bible — the 66-book Protestant canon, with the confessional Lutheran stream featured.
- The Reformed Study Bible — Expanded Canon — the Protestant canon with Reformed/Evangelical commentary featured.
- The Jewish Study Tanakh — Expanded — the 39 books of the Tanakh, read in the Jewish tradition.
- The Annotated Ethiopian Bible — Scholar’s Edition — the full 83-book canon with the apparatus tuned for academic study.
Step 4 — Work Through Your Edition
The builder follows the shape of a Bible, so you set things at whatever level you like — the whole Bible, a single book, a chapter, or one verse. Take it in this order:
- Confirm your canon & tradition. Your starting edition already set the books; change the canon here if you want a different shape — anything from the Tanakh up to the full Ethiopian Tewahedo canon.
- Choose your notes. Turn whole families of study notes on or off — cross-references, Hebrew & Greek word studies, historical and cultural background, literary analysis, commentary by tradition, topical indexes, and more. The rule is most specific wins: switch a family off across the whole Bible but back on just in Genesis, or flip a single note by hand.
- Choose the original-language popups. Pick which verse pop-ups appear — Hebrew (Westminster Leningrad Codex), Greek (Septuagint and Byzantine New Testament), Latin (Clementine Vulgate), and Arabic (Van Dyck) — for the whole Bible or down to a single verse.
- Make it yours. Pick a theme, set your cover and title pages, and fill in your own title, publisher name, copyright, and any editors’ names.
- Add reading plans (optional). Daily or monthly reading schedules appear as navigation aids in the finished book.
Step 5 — Export Your Ebook
When your edition is ready, export it. The program assembles a standards-compliant EPUB 3 and validates it against the W3C epubcheck tool to zero errors and zero warnings. The finished file opens with a “Your Edition” page that lists exactly what’s inside — the real note counts and the languages you kept.
Step 6 — Read It on Your Device
Move the exported file to your reader exactly as in Path 1, Step 2 above —
the plain .epub for Apple Books, Android apps, and computer readers. For tap-to-read
pop-ups on a Kobo, convert your export to the .kepub form first — the
free kepubify tool does it in one step (the same step the ready-made Kobo file uses).
Verify your download
Every release is posted with a SHA256SUMS.txt, and comparing the checksum
confirms your copy arrived complete and unaltered. The commands for each system are on the
Releases page.
It’s free, it runs on your own computer, and it never asks you to turn off any protection. Something confusing or wrong? Tell me on the feedback page.