Running the service
Scripture
Set up Bible translations, look up a reference, and understand how a passage splits into slides.
On this page
This page covers which Bible translations KERYX can show, the ESV API key setting, adding a reading to a service, and how a passage becomes slides.
Bibles and translations
Settings → Slides & Bibles → Bibles sets the Default translation — the version the scripture picker opens on and falls back to.
KERYX gets translations two ways:
- ESV is looked up live from api.esv.org and cached locally after the first lookup. It works out of the box — KERYX ships with a working key so a fresh install can look up ESV immediately — but you can paste your own free key from api.esv.org into ESV API key if you'd rather use your church's own.
- Public-domain translations download once and then work completely offline. Settings → Slides & Bibles → Translations lists them with a Download button each; once downloaded they show Installed:
| Translation | Note |
|---|---|
| World English Bible (WEB) | Modern, readable — recommended |
| American Standard Version (ASV) | Classic literal (1901) |
| Bible in Basic English (BBE) | Simple English |
| Young's Literal Translation (YLT) | Very literal |
| Darby Translation | Literal (1890) |
Adding scripture to a service
From Add to Service → Scripture:
- Type a reference into the field — it tolerates typos and abbreviations (e.g. "romns 8:28-30" or "jn 3:16") and suggests the matching book, chapter, or verse as you type.
- Pick a translation from the version dropdown, or leave it on the default.
- Click Look up (or press Enter). KERYX shows a preview of every slide the passage will produce.
- Click + Add [reference] to service to drop it into the running order.
The same lookup is available from the companion's + Scripture button — see Companion.
How verses split into slides
A looked-up passage is broken into slide-sized chunks automatically: KERYX packs whole sentences onto a slide up to about 42 words, breaking on sentence boundaries rather than mid-thought wherever it can (a single very long sentence is split on a word boundary as a last resort). A passage that fits in one chunk is one slide; a longer reading becomes several, labelled like "John 3 (1/2)", "John 3 (2/2)".