Navigation¶
Video tutorial: Finding your wayComing soon Watch the preview video
Opening Bible References¶
To open a bible reference, simply click on the book name at the top of the screen:
The Book Chooser will open where you can select any book that is available in the current document. For example, in regular Bible documents you will be able to see all 66 books of the Bible, but if you go to the Book Chooser when the active window is a smaller commentary, it will only show the books that are available in that commentary.
After you select the book, it will take you to the next screen where you can select the chapter. When you pick the book you are reading, the chapter you are reading (and, on the verse screen, the verse) is highlighted and scrolled into view, so a long book such as Psalms opens near your place:
After selecting a book and then a chapter it will take you back to the Bible screen and open the Bible to the selected reference.
Book Chooser Customizations¶
A few customization options are available in the top right vertical three-dot menu of the Book Chooser screen:
- Alphabetical Order: Enabling this option will display the books in alphabetical order. (Starting with numbers - i.e. 1 Chronicles)
- Order books horizontally: Enabling this option will list the books from left to right then from top to bottom. When disabled in portrait orientation, ungrouped book, chapter and verse grids fill each column from top to bottom before moving to the next column. An incomplete final column leaves empty cells below its last item; for example, John's 21 chapters place 1-5 in the first column and 21 at the top of the fifth column.
- Group books by category: Enabling this option will automatically enable the Order books horizontally setting but will additionally group books by their category (i.e. Law, History, Poetry, Prophets, etc.)
- Show long book name: Enabling this option will additionally show the full book name under its abbreviation.
Opening Deuterocanonical Books¶
When your active window is a Bible version that contains deuterocanonical books, there will be a plus (+) icon in the Book Chooser. By clicking on the plus (+) icon, you will see a list of the included deuterocanonical books. For example, when opening the KJVA Bible, you can click the “Book Chooser” and you should see the plus (+) menu icon in the top right. Clicking the plus icon (+) will display the deuterocanonical books in the list:
Navigating Directly To Verse¶
If you would like to choose a specific verse number (in addition to the book and chapter), you can enable the Navigate to verse option in Application preferences:
- Click on the main menu (☰) on top left of the screen,
- Click Application preferences
- Find and enable the Navigate to verse setting.
Now after selecting the chapter number, you will be prompted to choose the exact verse number you would like to open.
The Reading Toolbar¶
The toolbar at the top of the reading screen has these parts, from left to right:
- Menu (☰) opens the main menu.
- The title shows the current reference and document. Tap it to open the Book Chooser (see Opening Bible References). Long-press it to open the document sheet. Swipe down on it to open the workspace selector, or swipe left or right on it to go to the previous or next workspace.
- Quick buttons. How many fit depends on the width of the screen (at most about half of the
toolbar); on a narrow screen the last ones are left out. They are:
- Bible and Commentary: open the document sheets, see Opening Documents below.
- Strong's numbers, shown only when the current document has Strong's numbers. Each press
cycles the Strong's mode of the active window:
Hidden Links,Links,Text and Links. Long-press it to open the Strong's numbers setting for that window. See Dictionaries. - Find and Speak (the one you used last comes first).
- Find: opens the search field, see Search. Shown only when the page can be searched.
- Speak: shows the speak bar. It is shown when the document can be spoken and speech is stopped. Long-press it to open the speak settings. See Speak.
- Workspaces: opens the workspace selector.
- More options (⋮) is always shown. Its menu has Fullscreen, Night mode (see Look and Feel), Workspaces, Tilt to scroll (on devices with a motion sensor, so not on Windows and Linux), Reversed split mode (when several windows are open), Window pinning, Label settings, AI Actions (when an AI provider is set up), Sync now (when sync is set up), the text options you used most recently and All text options. See also Background activity.
Moving Between Documents¶
Opening Documents¶
To open a document, click on either the Bible or Commentary icons in the top navigation bar.
- Clicking on the Bible icon will show a list of installed Bibles that you can open.
- Clicking on the Commentary icon will show a list of other installed documents you can open ( i.e. Commentaries, Dictionaries, Generic books, etc).
By default each button opens a sheet. The Bible button lists your Bibles. The other button is titled Commentary and lists commentaries, general books and dictionaries. The tabs are Recent, This verse and All, and All documents… at the bottom opens the full document list. A tab with no documents is not shown. If only two Bibles (or books) are available for the current verse, the button switches directly to the other one instead; if none are, it opens the full document list.
Long-pressing the title at the top of the screen opens the same kind of sheet for all documents. Its tabs are Recent, This verse and Last filter (the documents that match the language and type filter you last used in the document list).
Note: This will open the document in the currently active window. To open a document in a new window, see Windows.
When you switch Bibles, the window keeps the current reference. If the selected Bible does not contain that book or chapter, a notice names the missing reference and the document (for example, "Romans 8 was not found in document OSHB."). Open the Book Chooser to select a reference available in that Bible.
The Bible and Commentary toolbar buttons can also be customized. To customize the actions, go to the top left main menu (☰) and click Application preferences. Click Action for toolbar button press to configure the custom button actions:
- Press to open menu, long press for documents screen (default)
- Press to open next document, long press to open menu
- Press to open next document, long press for documents screen
Here "menu" means the document sheet described above (Press to open menu), and "documents screen" means the full document list.
Closing Documents¶
To close a document, open its window menu and click Close. The window menu opens from the ☰ button over the window, or by long-pressing the window's button in the window button bar at the bottom right.
Maximizing/Minimizing Document Windows¶
To maximize or minimize a window, click on the window icon in the bottom right window button bar. Clicking on a window that is visible will minimize the window and clicking on a window that is minimized will maximize it. The window button of a minimized window has a dashed outline. The window button that is highlighted indicates the active window:
For more on managing windows, see Windows.
Moving Between Workspaces¶
Open the workspaces dialog¶
To open the workspace dialog, simply swipe down from the book reference section of the top main toolbar. Alternatively, click the top right three-dot menu and click Workspaces.
Go to the next workspace¶
To navigate directly to the next/previous workspace, you can swipe right or left on the book reference section of the top main toolbar:
For more information about managing workspaces, see Workspaces.
Background activity¶
When sync is configured, Sync now is the first row of this section.
On desktop and iOS (including iOS on a Mac) the top right three-dot menu (⋮) can show what the app is doing in the background, such as downloads, search indexing and sync. On Android the same information is shown as system notifications, so this is off by default there. Turn it on or off with Show background activity in the menu in the Look & feel section of the application settings (see Look and Feel).
When the setting is on:
- While a download or install, search indexing or sync is running, a thin progress ring is drawn around the ⋮ button. The ring shows real progress when exactly one item reports a percentage.
- A failure shows a small count badge on the ⋮ button. The small sync icon next to the title is not shown, because the ring already covers sync.
- Opening the ⋮ menu shows an activity section at the top with up to three rows: items needing attention first, then other running items and failures. Each row has a progress bar or a message. Opening the menu marks failures as read, but does not clear a permission-waiting agent's attention badge; that badge remains until the permission request is resolved. Use the dismiss button on a failed or interrupted row to remove it without closing the menu.
- Show all (N) opens the Background activity list, with a Running and a Recent section. Running items that can be stopped have Cancel, finished items have Dismiss, and Clear finished removes all finished items. Tap a download row to open the download screen, or a sync failure to open the sync settings. On wide windows the list is a dialog, on phones a bottom sheet.
- An AI-agent run appears as one activity for its workspace. Its title includes the workspace name when available, and otherwise uses the generic AI agent title. While it runs, the row can show its latest log message; if it is waiting for your permission, the row says which tool needs approval and is kept at the top of the menu activity section as an item needing attention. Tapping the row switches to that workspace and opens the agent log. Cancel stops only that run. A failed run stays in the list until dismissed or the app restarts; opening the menu marks it as read. A completed run stays for one minute, and a cancelled run is removed.
- On desktop and iOS, a background sync error appears as a short message ("... see menu") and a row in the list instead of an error dialog.
Reportable failed rows also have a Report action, which opens the existing bug-report flow with the failure attached; reporting does not dismiss the row. Expected sync errors, such as authentication or quota errors, do not offer Report.
Successful items stay in the list for one minute, and a successful sync is not listed. Failures stay until you dismiss them or restart the app. Very short jobs (under a second) are not shown.
Gestures and Shortcuts¶
AndBible supports a variety of gestures and shortcuts for efficient navigation.
Keyboard Shortcuts¶
With a hardware keyboard, the reading view understands the shortcuts below. They work in the reading view, not in text fields or in the note editor (see the notes under Keyboard Search).
| Keys | Action | Platforms |
|---|---|---|
| Ctrl+F (Cmd+F on iOS) | Open the search field | All |
| Ctrl+B (Cmd+B on iOS) | Open the Book Chooser | All |
| Ctrl+L | Open the Book Chooser ("go to reference") | Desktop |
| Ctrl+B with text selected | Bookmark the selection | Desktop |
| Ctrl+C | Copy the selected text | All |
| Ctrl+W | Open the workspace selector | All |
| Alt+M | Open the main menu | All |
| Alt+O | Open the ⋮ menu | All |
| Alt+Up, Alt+Down | Switch to the previous / next window | All |
| Alt+Left, Alt+Right | Switch to the previous / next window | Android, iOS |
| Alt+Left | Go back (same as Esc, see below); Alt+Right does nothing | Desktop |
| Mouse back button | Go back | Desktop |
| Ctrl+Tab, Ctrl+Shift+Tab | Switch to the next / previous window | Desktop |
| Ctrl+Plus, Ctrl+Minus, Ctrl+0 | Larger text, smaller text, default text size | Desktop |
| Ctrl + mouse wheel | Larger or smaller text | Desktop |
| Ctrl+, | Open Application preferences | Desktop |
| Ctrl+S (Cmd+S on macOS) | Run Sync now, or open Device synchronization settings if not set up; left to focused editors | Desktop |
| F11 | Toggle fullscreen | Desktop |
| Esc | Go back, see below | iOS, desktop |
| Up / Down | Scroll the text | All |
| Space | Pause or resume speaking, while speech is not stopped | All |
When you tap a verse and its action menu is open, B adds a bookmark, N adds a note and Space speaks the verse. See Verse Action Dialog.
Keyboard Search¶
With the reading view open, Ctrl+F opens the in-place search field, including on iPhone and iPad with a connected keyboard. On iOS, Cmd+F also opens search, and Cmd+B performs the same reading action as Ctrl+B. You can also open the same search from Find in the main menu. Other Command-key combinations are not reading shortcuts. Press Ctrl+F again (Cmd+F on iOS) to focus the search field and select the whole query; typing replaces the old query without running it again. While a native text field has focus, its own keyboard commands take precedence over reading shortcuts. In the Bible text's note editor, Ctrl+C copies and Ctrl+B stays with the editor. Alt+arrow keys and Alt+M/O do not trigger reading actions while editing, on Android and other platforms as well as iOS. On iOS, the editor also owns Control shortcuts such as Ctrl+B and Ctrl+F for caret navigation, and Option+arrow navigation.
Esc Key as Back¶
With a hardware keyboard on iPhone, iPad, the iOS app on a Mac, and the desktop app, Esc works like the Back button. Each press closes the topmost open thing first: a dialog, popup or sheet, then the main menu, then the search results and finally Find (the search field in the toolbar). On a screen opened over the Bible text, such as the settings or the Bible chooser, Esc returns to the previous screen. On the desktop reading screen, Esc also exits fullscreen; otherwise, with nothing open, it does nothing.
On iPhone, iPad and the iOS app on a Mac, while you type in a text field, the first Esc only leaves the field (and hides the on-screen keyboard); press Esc again to go back. Esc that a note editor or an input method uses itself, for example to cancel a composition, never also counts as Back.
Swipe from the Edge to Open the Main Menu¶
On a touch screen, you can open the main menu (☰) by swiping inwards from the left edge of the reading view (the right edge in right-to-left languages). The menu follows your finger; let go past halfway, or with a quick flick, to keep it open. Swipe it back or tap outside it to close it. Swipes that start further from the edge keep their usual effect on the Bible text.
On Android with gesture navigation, a swipe from the screen edge is also the system Back gesture. Android lets an app take over only a limited part of the edge, so the edge swipe opens the menu in the upper part of the screen and works as Back elsewhere. With three-button navigation it works along the whole edge. In the desktop app, open the menu with ☰.
Swipe Left/Right on Bible Text¶
You can swipe left or right on the Bible text to navigate. The behavior can be
configured in Settings > Application behavior > Action for swipe
left/right gesture:
- Chapter (default) – Navigate to the next or previous chapter.
- Page – Scroll by one page (like tapping the margin in the Android or iOS app).
- Disabled – Swiping has no effect on the Bible text.
Double-Tap to Fullscreen¶
On Android, iPhone, and iPad, double-tap the Bible text to enter fullscreen mode,
which hides the toolbar and status bar for distraction-free reading. Double-tap
again to exit fullscreen. Entering fullscreen this way is enabled by default on
mobile, but disabled by default when running the iPad app on a Mac. Change it in
Settings > Application behavior > Double-tap to fullscreen. Your saved
choice is kept. Double-tapping still exits fullscreen when the setting is off.
The text stays where it was when you enter or leave fullscreen, also when you
double-tap the left or right margin, where a single tap scrolls one page.
On iPhone and iPad, you can also tap the exit-fullscreen button at the upper right.
In the desktop app, double-click does not toggle fullscreen and the double-tap setting is not shown. Choose Fullscreen in the top right three-dot menu (⋮) or press F11 to toggle fullscreen. To exit, you can also click the exit-fullscreen button at the upper right or press Esc. When a dialog or page editor is open, close it first.
On iPhone, iPad, and desktop, fullscreen hides the floating pane menu buttons so they do not overlap the exit-fullscreen button. Exit fullscreen to use the pane menus again. The fullscreen hint disappears when you exit.
Fullscreen by Scrolling¶
When enabled, the app automatically enters fullscreen mode when you start scrolling the text, and exits fullscreen when you scroll back to the top.
To enable: Settings > Application behavior > Fullscreen by
scrolling.
Volume Keys Scrolling¶
Volume-key scrolling works on Android only; see Platform differences.
By default, the device volume buttons scroll the Bible text up and down instead of adjusting the system volume. This is useful for hands-free reading.
To disable: Settings > Application behavior > Volume keys scroll.
Long-Press Actions¶
Several buttons support long-press for quick access to additional features:
- Speak toolbar button – Open speak settings directly.
- Window button (in the bottom bar) – Open the window menu (see Windows).
- Verse location title (top of screen) – Open the document sheet.
- Links (Android) – Open a menu with Open link here or Open link in special window (whichever is not what a plain tap does, depending on the Links window setting), Open link in new window and, for Bible reference links, Copy link to clipboard.
The navigation history list is in the main menu as History.





