Look and Feel¶
Video tutorial: Appearance, part 1: night mode, fonts and coloursComing soon Watch the preview video
Video tutorial: Appearance, part 2: global, workspace and window settingsComing soon Watch the preview video
The look and feel of AndBible can be configured at several levels: for the entire application, as global defaults, for specific workspaces, for individual windows, or, through the module's own CSS file, for particular modules.
Text display settings hierarchy¶
Text display settings (formatting, fonts, colors, etc.) follow a three-level hierarchy. Each level inherits from the one above it, so you only need to change a setting at the level where you want it to differ.
- Global defaults – apply to all workspaces and windows everywhere.
- Workspace settings – override global defaults for one workspace and all its windows.
- Window settings – override the workspace setting for one specific window.
When you change a setting at a higher level, all lower levels that have not been explicitly overridden will automatically follow the change. For example, if you set the global font size to 16 pt and a workspace has no font size of its own, it uses 16 pt. If you then change the global font size to 14 pt, that workspace (and all its windows) will switch to 14 pt as well.
A setting that has been explicitly set at a lower level is called an override. Overrides are not affected by changes at higher levels. For example, if you set a workspace font size to 18 pt, changing the global font size will not affect that workspace. You can remove an override at any time to go back to inheriting from the parent level.
Level labels in the text options screens show where each setting comes from. A small text label next to a setting names the level it is inherited from:
Workspace– the setting is inherited from the workspace settings.Global– the setting is inherited from the global defaults.- No label – the setting has been explicitly changed at this level (it overrides the parent).
You can navigate between levels directly from the text options screen. At the window level, links to the workspace and global settings are shown at the top. At the workspace level, a link to the global settings is shown. This makes it easy to see and adjust settings at every level without leaving the settings screen.
Application settings¶
To configure application-wide settings (which are not synced to other devices),
navigate to the top left main menu (☰) and click Application preferences. These
settings apply to the local device only and are separate from the text display
settings hierarchy described above.
The screen has a search icon for finding a setting by its name, and a reset icon at the top right that restores all the settings shown on the screen to their defaults (after a confirmation).
The settings are grouped into the categories Dictionaries, Application behavior,
Look & feel, E-ink settings, Settings for the persecuted, Features and
Advanced settings. The sections below follow the topics rather than the
categories. Language, notes format, the font size multiplier, fullscreen and
window display, one-tap actions and the Study Pad option are all in the
Look & feel category.
Single-choice settings such as Color mode, and the Strong's numbers options opened by long-pressing the reading toolbar button, show inset radio-button rows. Tap anywhere on an option's row, including the space beside the radio button, to select it.
Application behavior¶
- Keep screen on: Prevent the screen from sleeping while using the app. Not available on Windows and Linux; see Platform differences. Changes take effect when you return from settings to the reader; no app restart is needed.
-
Night mode switching: Control when the dark theme is used:
- System (default) – follow the Android system dark mode setting (Android 10+). iPhone, iPad and Mac follow the system too; on Windows and Linux you choose light or dark yourself (see Platform differences).
- Manual – toggle dark mode with
Night modein the three-dot menu (⋮). The menu item is greyed out unless this setting is Manual. - Automatic – on Android devices with a light sensor, switch based on ambient light. Enabling this mode starts monitoring immediately; no app restart is needed.
Dictionaries¶
The Dictionaries category (shown once you have dictionaries installed) lets you choose
which documents are used for Strongs Greek dictionary, Strongs Hebrew dictionary
and Robinson Greek morphology definitions, and which Word lookup dictionaries
are searched by Look up in dictionaries in the text selection menu.
Language, notes and theme¶
- Application language: Choose the language for the application interface
(dialogs, menus, settings), including controls inside the reading view.
Indonesian and both Serbian scripts (Cyrillic and Latin) are supported there;
Simplified and Traditional Chinese use their corresponding translations.
Any text not yet translated into the selected language falls back to English.
On iOS, formatted numeric values such as module
sizes use the selected language's decimal separator and digits (for example,
1,5 MBin Finnish). The file-installation instructions and supported-format list also follow language changes without restarting the app. - Format for new bookmark notes: Choose whether new notes
are created as
Rich text (HTML)orMarkdown. Existing notes keep the format they were created with.
Workspace theme. In Normal color mode, the app automatically derives
soft tones from your workspace color, keeping grey and black colors grey
and muted colors muted. Without a workspace color (or after resetting it
to default), the app uses its built-in Ink on paper theme: dark ink on warm
paper in light mode and light ink on a near-black background in dark mode,
with amber accents. There is no setting for choosing a palette style.
The Color settings screen is titled with the level it was opened at:
Color settings (Global), Color settings (Workspace) or
Color settings (Window). The extra Workspace color row appears only at the
workspace and global levels; it is the base color the theme above is derived from.
If you previously chose another Theme style, upgrading switches to this
fixed soft palette; restoring an old backup does not restore that style.
Reading-view controls also follow the workspace theme,
including bookmark editing buttons, note separators, editor selections,
study-pad drag highlights, and page and reading-progress badges. The active
window is marked by rounded corners in the theme color. Bookmark colors and correctness/error colors
keep their own meaning.
Use system colors (Material You). On Android 12 and newer, turn this on to use the colors your phone derives from your wallpaper instead of the built-in Ink on paper theme, in both light and dark mode. Change the wallpaper and AndBible follows it. It is off by default. A workspace color still takes precedence: the system colors apply only to workspaces without one. The Black & white, Color e-ink and Monochrome color modes also ignore it. The setting is not shown on older Android versions, iOS or desktop.
E-ink settings¶
-
Color mode: Choose how colors are displayed throughout the application:
- Normal – use the configured colors.
- Black & white – convert colors to grayscale, retaining shades of grey.
- Color e-ink – the same black-and-white look as Monochrome, except that bookmark highlights and underlines keep their label colors. Intended for color e-ink screens.
- Monochrome – use black ink on white paper, or white ink on black paper in the dark theme. Disabled controls and off states use one solid grey rather than faded shades. Highlighted bookmarks are shown in bold text instead of a background color; underlined bookmarks keep a black (or white) underline. Recommended for e-ink screens where lighter grey levels fade or disappear.
Monochrome is the default on Onyx devices when no Color mode has been chosen; other devices default to Normal. An existing saved choice is not changed, including Black & white on an Onyx device. Changing Color mode does not replace your configured colors; color-selection swatches still show those colors. Images are not restricted to black and white. In Monochrome and Color e-ink, the reading pane's native horizontal and vertical scrollbars are hidden on all Android versions; scrolling and autoscroll still work normally. Leaving these modes restores the previous scrollbar settings. Window buttons keep a paper background and ink text: the active window has a thicker outline, while minimised windows use solid grey text and a dashed outline. - Disable animations: Turns off smooth scrolling and transition animations, including sliding bottom sheets, dialogs, window popup menus, toolbar menus, and document filter dropdowns. Improves responsiveness on e-ink screens and very old devices. This is a separate setting; choosing a Color mode does not toggle it.
In Monochrome and Color e-ink, progress heatmaps use three states instead of a color gradient: grey means no activity or progress, outlined means partial progress or an intermediate activity level, and filled means full progress or the highest level. Ink and paper swap in the dark theme. In reading progress, a filled book cell means at least 100% read; in memorization progress, a filled cell means level 4/4. For reading counts and calendar activity, filled means the highest count bucket, not that all reading is complete. The legend explains these three states rather than showing a gradual color scale.
Exact values remain available: select a book to see its percentage below the
book grid. Chapter cells show the read count (for example, 17 x) or
memorization level (for example, 3/4) before you tap to open the chapter.
Select a calendar day to see its activity count below the heatmap, including
zero for a day with no activity; days with activity also open the day's history.
In the Black & white, Color e-ink and Monochrome color modes, the base interface stays grey (or black and white) for readable contrast, and a chosen workspace color is not used.
Color mode and Disable animations can be used together for an e-ink reading experience.
Font and Text¶
On iOS, the system Text Size setting scales the app interface independently of the document text. To change Bible text size, use the text display settings or the Font size multiplier below; increasing the system text size does not replace those controls. At large accessibility text sizes, long dialog titles and messages can be scrolled separately so the choices and confirmation buttons remain reachable on a phone.
- Font size multiplier: A global scaling factor (10%–500%) applied to all document text. Useful when you synchronize workspaces across devices with different screen sizes – the workspace font size is synced, but the multiplier is per-device. For example, setting 150% on a small phone while leaving 100% on a tablet keeps text proportional. Changes apply immediately to open reading windows, including on iOS and desktop, without reloading the chapter.
Fullscreen and Window Display¶
- Hide status bar: (Android) Hides the Android status bar (clock, notifications) while keeping AndBible's own toolbar visible. Useful for distraction-free reading and e-ink devices. Swipe from the top edge to reveal it temporarily. This is separate from fullscreen mode.
- Hide window button bar in fullscreen: Hides the bottom window buttons when in fullscreen mode for a distraction-free view.
- Hide window buttons: Hides the menu buttons at the top right of each window. You can still access the window menu by long-pressing the buttons in the bottom window bar.
- Hide Bible reference overlay: Hides the semi-transparent Bible reference indicator that appears near the bottom of the screen while scrolling in fullscreen mode. It disappears after scrolling stops; tapping the text does not show it.
- Show active window indicator: Highlights the corners of the active window with a colored border. Makes it easier to see which window is currently active when using multiple windows side by side.
Look & feel¶
- Show background activity in the menu: Shows downloads, sync, indexing progress, AI-agent runs and failures in the three-dot menu (⋮): a progress ring and a badge for failures or items needing attention on the button, and an activity list in the menu. Opening the menu clears unread failure badges, but an agent permission-wait badge remains until the request is resolved. On by default on desktop and iOS, off on Android, where the system notifications show the same information. See Background activity.
- System notifications: (Linux and Windows desktop, iOS, and the iOS app on a Mac) Shows a system notification when background work fails, and when a long download, install or index (over about 10 seconds) finishes while AndBible is in the background. Successful syncs never notify. If work you started fails while AndBible is in the foreground, only the in-app error dialog is shown, without a duplicate system notification. Background failures still notify even while you use the app; repeated occurrences update the same notification. A running job also shows a progress notification while AndBible is in the background: Windows updates a toast progress bar in place, KDE Plasma and several other Linux desktops show a progress bar, GNOME shows the percentage as text, and iOS shows no progress notifications. On Windows, use the MSI installation with its Start-menu shortcut. Clicking a notification brings AndBible to the front, and opens the activity list when "Show background activity in the menu" is on. On Windows, clicking a retained notification also starts AndBible if it has exited (MSI or MSIX installation). The activity list may be empty because completed work is not restored across app restarts. This separate setting is on by default. On iOS, AndBible asks for permission when you first start background work, such as installing a document, enabling sync, or choosing Sync now, not at launch. The permission prompt does not delay synchronization, and turning this setting off prevents the prompt. If permission is denied, use Open settings in this setting to open the notification settings (the app's settings on older iOS versions) and allow notifications; AndBible will not repeatedly ask. Your operating system's notification settings apply on top. On Linux, an AI agent waiting for permission also raises an urgent background notification; Android's agent foreground-service notification is unchanged. See Background activity.
One-Tap Actions¶
When you tap on a verse or text, a quick action bar appears. You can customize which buttons are shown in this bar:
- One-tap actions (Bibles): Configure which actions appear when tapping text in Bible documents. Available actions include: Bookmark, Bookmark with note, My Notes, Share, Compare, Speak, and Memorize.
- One-tap actions (Other documents): Configure which actions appear for non-Bible documents (commentaries, books, etc.). Available actions include: Bookmark, Bookmark with note, and Speak.
Study Pad¶
- Disable Study Pad click-to-edit: When enabled, notes in Study Pads can only be edited by tapping the edit button, not by clicking on the note text directly. This prevents accidental edits while reading.
Advanced settings¶
-
Experimental features: Choose which features still in development to switch on. They may change or be removed:
Bookmark edit actions– see Bookmarks.Add paragraph break bookmark– adds aParagraph breakitem to the text selection menu and aParagraphbutton to the verse menu.Use the literal workspace colour for the reading toolbar (instead of the theme colour)– the reading toolbar uses the workspace colour as it is, rather than a tone derived from it.- Import data from the previous app version: (iOS only) Shown only when data from the previous (pre-6.0) iOS app was found on the device. It replaces your current workspaces, bookmarks and other data with that old data. A copy of your current data is kept on the device. After you confirm, close the app and open it again to run the import.
Global text options¶
Global text options are the default text display settings for all workspaces. Any workspace or window that has not explicitly overridden a setting will use the global value.
To access global text options:
- From a workspace text options screen, tap the Global text options link at the top.
- From a window text options screen, tap the Global text options link at the top.
When you change a global setting, the change is immediately reflected in every workspace and window that is still inheriting that setting. Workspaces or windows that have their own override are not affected.
Global text options are synced across devices.
The available settings are the same as those described in the Formatting and Text Appearance sections below.
Workspace text options¶
To configure the look and feel of an individual workspace, click on the three
dot kebab menu on the top right of your workspace. From there click on
All text options.
Workspace text options override the global defaults for that workspace and all its windows. These settings are synced across devices.
Formatting
- Section titles: Show non-canonical section titles added by translators.
- Title scroll button: Show a small button next to section titles that scrolls to the top of the section when tapped.
- Verse numbers: Show or hide chapter and verse numbers.
- Footnotes: Show footnotes if available in the document. Optionally display them inline rather than in a popup.
- Cross references: Show cross-reference markers. With
Inline cross referenceson, the referenced text is shown inline instead of in a popup. - Strong’s numbers: Show links to Greek and Hebrew dictionary definitions.
- Morphological codes: Show Robinson’s Greek morphology codes.
- Italicize added words: Italicize words that do not have Strong’s numbers associated with them. Useful for translations like KJV where added words are traditionally shown in italics.
- Infinite scroll: Automatically load more content when you scroll to the end of a chapter. When you are at the top and try to scroll further up (dragging down or turning the mouse wheel up), the previous chapter or section is loaded.
Text Appearance
The font size, top margin, and line spacing sliders show the current value as you drag, including its unit. Tap OK to apply the value or Cancel to discard the change. The font size and line spacing sheets also show a short verse sample in the selected font family, updating as you drag. The sample has a limited height so the controls remain accessible even at large sizes; scroll the sample to read the rest. When you change the font size, font family, line spacing, or text scaling, the current reading verse stays at the same position in the window, including after restoring a database backup.
- Colors: Adjust text color, background color, and background noise (a subtle texture overlay on the background). The texture also extends behind the window buttons bar, using the same day or night noise setting as the reading area. You can also import a background image and select it separately for day and night mode. Imported images remain available after restarting the app; you do not need to import them again.
- Font size: Set the base text size in points.
- Font family: Change the typeface. Each name in the chooser is displayed
in its own font so you can preview it before selecting it. If a font file
cannot be loaded, its name uses the normal interface font instead.
Additional fonts can be installed via font add-on modules. With the default
sans-serifsetting, a font add-on such as FontPack may provide language-specific defaults for Greek or Hebrew. Choosing another font overrides those defaults for every language, but a module's own font (set in its custom CSS for that module) still applies to that module's text. - Margin size: Set the left and right margins independently, measured in millimeters. You can also set a maximum text width to prevent lines from becoming too long on wide screens. In the Android and iOS apps, tap the left or right margin to scroll one page up or down. A double tap in a margin that enters or leaves fullscreen does not scroll. Desktop app margin clicks do not scroll.
- Top margin: Add a margin at the top of the window (in millimeters). The reading position starts below this margin.
- Line spacing: Adjust the space between lines (multiplier from 1.0x to 2.0x).
- Paragraph spacing: Adjust the space between paragraphs (in millimeters).
- Red letter: Show the words of Christ in red.
- One verse per line: Display each verse on a separate line.
- Justify text: Align text to both left and right margins.
- Hyphenation: Automatically hyphenate words at line breaks (if supported by the language).
- Relative page number: Show a page number overlay indicating your position relative to where you started reading.
Page Scrolling
- Page scroll amount: How much of the page to scroll with page up/down.
- Scroll helper lines: Show horizontal guide lines at page scroll boundaries.
- Helper line style: Choose between
Thin dotted line,Thin solid lineandThick solid line. - Page scroll buttons: Show visible page up/down buttons on screen.
- Show ordinal numbers: Show ordinal position markers in text.
- Reading progress: Show how far through the book you are (percentage, page or chapter).
Bookmark & My Notes settings
- Show bookmarks: Untick to hide all bookmarks.
- Show My Note icons: Show an icon in verses that have a My Note.
- Show AI document markers: Show marker icons for AI-generated document pages linked to verses.
- Hide specified labels: Hide bookmarks that are marked with the chosen
label(s). It is a text display setting, so it can differ per window or workspace; the
per-label
Hiddenstyle is described in Labels.
Reading & Memorization
- Mark as read button, Auto-track reading and Memorization indicators (colored margin indicators for memorized and target verses). See Reading progress and Memorize.
Window text options¶
When using multiple windows, you can customize the text options of each individual window to override the workspace settings. To change window text options:
- Tap and hold the square window icon at the bottom for the window you would like to customize.
- Click
Text options, then clickAll text options.
All of the same options that you could configure at the workspace level can be overridden for the selected window.
In the screenshot below you can see that the window color settings are
overriding the workspace color settings (indicated by the missing Workspace
label). To reset all window settings back to the workspace defaults, you can
click the circular back arrow at the top right of the window settings screen.
From the window text options screen you can also navigate directly to the workspace or global text options using the links at the top of the screen.
Module¶
There is no settings screen for an individual document. For things that can not be changed through global, workspace, or window settings, like the color of certain text within a module, e.g. Headings or Strong’s numbers, you can code the color in the style.css file located within the module’s zip package. You can see some examples of this being implemented here:
For more details on how to create custom CSS modules, see Custom CSS and placement of this file, it should be located in the modules/texts/ztext/hisb/style directory.
Once the customized module is coded, you can follow the steps in Backup and Restore to load your customized module.


