Welcome to the AndBible: Bible Study’s documentation!

The Bible Study App is a free, opensource application provided by AndBible that gives users an advanced and flexible interface for studying the Bible.

Note

This project is under active development.

Contents

Getting Started

Installation

There are four main ways to install AndBible. You can install AndBible using the Google Play Store version, the F-Droid version, the Amazon app store and directly from GitHub releases.

Google Play Store

Click on the link above and install the application.

F-Droid

Click on the F-Droid app link above and install the app.

Amazon App Store

Click on the Amazon link above and install the application.

GitHub Releases

GitHub Releases

Go to the link above and download the .apk file in the “Assets” sub-menu. Then, click on the downloaded file and add the necessary permissions to the browser you are using. Finally, click “Install”

Windows 11 setup

To run AndBible on windows 11:

This may be a bit technical if you are outside the US or not on Windows 11 beta. It involves downloading the Windows Subsystem for Android (WSA), running a command to install it, starting Windows Subsystem for Android, enabling developer mode, downloading the apk from GitHub releases, and installing the app with adb.

Install WSA following these instructions:: https://www.xda-developers.com/how-to-run-android-apps-on-any-windows-11-pc/
Set up adb:: https://www.xda-developers.com/install-adb-windows-macos-linux/
Download the APK from GitHub releases:: https://github.com/AndBible/and-bible/releases/latest
How to sideload apps on WSA:: https://www.xda-developers.com/how-to-sideload-android-apps-on-windows-11/

Changing the look and feel

You can use the workspace “All Text Options” to change the look and feel of document texts. You can access these options from the kabab menu on the top right (aka three vertical dots). Use this menu to adjust various AndBible appearance options including font size and type, text and background colors, toggling words of Christ in red, and more.

When using multiple windows, you can use the individual window text options to override current workspace settings. Tap and hold the square window icon at the bottom for the window whose settings you wish to customize. Choose “Text Options” then “All Text Options”. This will open the menu to configure AndBible’s’ appearance for that specific window.

For things that can not be changed through these menus, like the color of certain texts within a module, e.g. Strong’s numbers, you can code the color in the style.css file located within a zip package. You can use HiSB Bible module to see the structure and placement of this file, it should be located in the modules/texts/ztext/hisb/style directory. Once coded you simply use the “Load From Zip” function under Backup/Restore section of the main menu.

Backup and Restore

Overview

The backup and restore function allows you to save your current Application, Bookmarks, and Bible modules so that you can restore them on other devices as well as to preserve them in case of a device failure. It is a recommended to back up your database file often which contains Notes, Bookmarks, Application settings, Reading Plan data, and other information.

How to backup your data

To backup your Bookmarks and Notes:

From the main menu tap on “Backup & Restore”.
Tap on Share or Backup App Database To.
To store the database on the cloud tap on Share, this will direct you to select a cloud storage location.
Taping on Phone Storage will allow you to choose a location on your device to save the database file.

To backup your Bible modules, dictionaries, commentaries:

From the main menu tap on “Backup & Restore”.
Tap on Share or Backup Documents To.
Check the modules you want to backup.
Tap on OK
To store the document on the cloud tap on Share, this will direct you to select a cloud storage location.
Taping on Phone Storage will allow you to choose a location on your device to save the document.

To backup the AndBible Application:

From the main menu tap on Backup & Restore.
Tap on Share or Backup App (.APK file) To.
Select email or cloud storage to save the application file.

How to restore your data

To restore your Bookmarks and Notes:

NOTE: If your database file was saved to a cloud storage, download the file from the cloud first to a location on your device before proceeding.

From the main menu tap on Backup & Restore.
Tap on Restore App Database From.
Select location on your device where the database file is located.

To restore your Bible modules, dictionaries, commentaries:

From the main menu tap on Backup & Restore.
Tap on Restore Documents From.
Tap on Load Document From ZIP/Restore Document From.
Select location on your device where the Document file is located.

NOTE: This form will change significantly in the next release.

Bookmarks

Overview

A bookmark is a label attached to a verse. A bookmark can be added to whole verses. When added to whole verses, the bookmark is visible in all translations.

A bookmark can also be added to part of a verse. When added to part of a verse, only an icon is visible in other translations.

Multiple labels can be added to a single bookmark. Multiple bookmarks can be added to the same verse. The verse action dialog shows all bookmarks for that verse, not just the bookmark clicked on.

Creating a bookmark

A bookmark is created by adding a label to a verse.

Click the verse you want to bookmark.
Push the Bookmark button.
Choose a label.

A bookmark can also be added to part of a verse.

Click and hold on a word that you want to bookmark.
Extend the highlight as required.
Choose Selection or Bookmark > Selection (the text displayed is controlled by the ‘One-step bookmarking’ application preference). Choosing Verses labels the whole verse.
Find or add new labels by clicking on the Select or edit labels… button.

A bookmark can also be added to multiple verses.

Click the first verse you want to bookmark.
Click the Plus button in the upper right of the verse action dialog box. The following verse is automatically selected.
Click on additional verses if needed. To deselect a verse you have added, click the verse the comes before it.
Push the Bookmark button and select a label.

Deleting a bookmark

A bookmark is deleted from the verse action dialog box.

Click the verse containing the bookmark you want to delete.
The verse action dialog shows all bookmarks for that verse, not just the bookmark clicked on.
Click the trash can icon inside the bookmark you wish to delete.
Confirm deletion.

Editing a bookmark

To do.

Notes

Edit the labels assigned to a bookmark by clicking on an existing label.
A bookmark can have more than one label.
The colour used for the highlight is indicated by the ‘Main Label’ icon.
Change the ‘Main Label’ by clicking on a different label.
Remove a label by clicking on it twice.

Customisation

Custom CSS

Custom CSS for individual modules or globally for And Bible (And Bible 4.0+)

And Bible offers option to include custom CSS and fonts in module zip files. Place your CSS file under module directory (or subdirectory), and define CSS file path in config file with AndBibleCSS=path-to/yourcssfile.css

CSS file you need to format as follows:

Prefix everything with .sword-YOURMODULE class (where YOURMODULE is the module initials of your module). For night mode, prefix everything with .night class.

If you have used <hi type="my-type"> tag in your module, you can define css for your tags with .hi-my-type class definitions.

Example (https://github.com/AndBible/special-modules/tree/master/HISB):

mods.d/HISB.conf

[HISB]
DataPath=./modules/texts/ztext/HISB/
AndBibleCSS=style/style.css
...

Put your font file SILEOTSR.ttf to ./modules/texts/ztext/HISB/style/. Define your css in ./modules/texts/ztext/HISB/style/style.css as follows

@font-face {
    font-family: 'Custom HISB Font';
    src: url('./SILEOTSR.ttf') format('truetype');
}

.sword-HISB {
    font-family: 'Custom HISB Font';
}

.sword-HISB .hi-x-trlit {
    color: green;
    font-size: 0.7em;
    vertical-align: top;
    font-weight: bold;
}

.night .sword-HISB {
    vertical-align: text-top;

    color: #00FF00; /*#green; */
}

.night .sword-HISB .hi-x-trlit {
    color:  white; /*#green;*/
    font-size: 0.7em;
    vertical-align: top;
    font-weight: bold;
}

Global styling

If you want to create a module that alters global style (i.e. how And Bible looks overall), you can create add-on module (i.e. put Category=And Bible) and add configuration AndBibleProvidesStyle=True line to the conf.

Example config

[StyleExample]
DataPath=./modules/texts/ztext/StyleExample/
Version=1.0
ShortPromo=Module that provides custom CSS and applies to all documents. Also provides example font.
Description=Module that provides custom CSS and applies to all documents.
DistributionLicense=Copyrighted; Freely distributable
Category=And Bible
ModDrv=RawGenBook
InstallSize=194837
AndBibleMinimumVersion=539
AndBibleProvidesFont=Style Example Font;style/SILEOTSR.ttf
AndBibleProvidesStyle=True
AndBibleCSS=style/style.css

Debugging css

Please see Android Webview Remote debugging guide to see how you can investigate how to manipulate css.

Examples

See https://github.com/AndBible/special-modules/

Module Creation

To do

Document Library

Overview

Document library contains the list of all Bibles, dictionaries, commentaries, books, and other modules that have been download. To access the library tap and hold on the book name on the top left side of the menu bar.

Bibles

Bible modules can be downloaded from going to main menu then taping on download documents. You can filter the list by selecting bibles for “All Types” or by language.

Commentaries

To do.

Dictionaries

To install strong’s concordance dictionaries tap on the top left on the menu bar then tap on download documents. For “All Types” select Dictionary. From the list tap on StrongsGreek to install then StrongHebrew.

To ensure that these dictionaries are used as main lookup for words in Bible modules: From menu select application preferences, then tap on Strongs Greek Dictionary and if not selected tap on StrongsGreek. Do the same for Strongs Hebrew Dictionary.

Return to download documents and download KJV Bible module if you have not installed it previously. This module contains Strong’s number references. From the main Bible window tap and hold on the book name to the right of the menu icon on the top left of the screen. From the list of modules select KJV Bible. (You can also get to this screen by going to “Choose Document” in the main left side menu). This will load the current window with this Bible module. (You can also use the NASB or NET version for this purpose)

If you see dotted underlines for words, this means that a strong’s no is coded for that word, if you tap on these words the window will display the dictionary definition for that word. To display the Strong’s numbers in the bible instead of underlines inlines, tap on the Greek or Hebrew icon on the top menu bar. For the books in the Hebrew scriptures this icon shows Hebrew letters and for the books in the New Testaments the icon shows a Greek letter. If you tap on this icon again then no underline or Strong’s numbers will display.

To display the dictionary definitions in a special window: From the main menu tap on application preferences then turn on “Links window”

Books

To do.

Maps

To do.

How to Delete a Module:

To delete any of the above module types:

From the menu bar at the top; Tap to Enter menu, then tap on “Choose Document”. Optionally you can tap and hold on the book name on the menu bar. This will take you to the document screen. Choose the type of document to filter by, e.g. Bibles, Maps, etc. From the list, tap and hold on the module you want to delete. Once highlighted, at the top right corner on the menu bar, tap on the trash can icon. Tap “Yes” to confirm delete.

Labels

Overview

Labels are used by bookmarks, study pads, and personal notes. The Labels Settings dialog shows a list of all labels.

Add a label

To do.

Delete a label

To do.

Edit a label

To do.

Labels Settings dialog

Add new labels by clicking the Plus button.

Label dialog

Change the colour of a label by clicking the label icon.
A label can have either an underline or background colouring style.
Some label settings only apply to the current workspace.
Favourite labels always appear in the ‘quick select’ list.
‘Auto-assign’ labels are automatically added to new bookmarks.
Delete a label by clicking the trash can. But be careful, this will delete all notes associated with the label.
Finally, the ‘main label’ icon indicates which colour the bookmark will have.

Videos

Navigation

Go to a Bible reference

Tap the Bible reference at the top:

The “Book Chooser” will display where you can select any book that is available in the current document. For example, in regular Bible documents you’ll 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.

After selecting chapter it will take you back to the Bible screen and open the Bible at that reference.

Opening Deuterocanonical books

When your active window is a Bible version that contains deuterocanonical books, there will be a ‘+’ icon in the “Book Chooser” where you are then able to see the rest of the deuterocanonical books. For example, open KJVA in a window, go to the “Book Chooser” and you should see a ‘+’ menu icon close to the top right. Tap that and it will display the deuterocanonical books in the list.

Navigate directly to verse number

If you would like to have another screen to select the verse number, you can enable that in Application preferences. 1. Go to the main menu on left side, then click “Application preferences” 2. Find and enable the setting called “Navigate to verse”

Now after selecting the chapter number it will bring you to the next screen with verse numbers where you can select the exact verse you want to navigate to.

Moving between workspaces

Open the workspaces dialog

Go to the next workspace

Maximising a window

To do.

Minimising a window

To do.

Notes

The Bible Study App allows you to add a note to any bookmark or study pad.

Creating a note

Notes can be created in multiple ways.

Add a note to an existing bookmark.
Add a note to a new bookmark.
Push the ‘Note-button’ on the verse dialog. This creates a new bookmark with the label ‘Unlabeled’.

The Note icon indicates that the bookmark has a note attached. The verse dialog also indicates that a note exists. Click the icon to view the note.

Click the Note icon to view the note.

Editing a note

To edit a note simply click the note itself.

These notes support rich formatting similar-to-a normal document.

Other

Change the label by clicking the label name.
Add a note to a study pad.
To view all chapter notes, choose ‘My Notes’ from the commentary list.
To view every note, open the Bookmarks list.

Reading Plans

From: https://github.com/AndBible/and-bible/wiki/Reading-Plans

Overview

Reading plans are accessible via main menu (left) > Reading Plan.

On first access you select a plan and are taken to the Daily Reading screen for the first day.

The Done button will be enabled after pressing Speak or Passage for each passage, or after you’ve tapped each checkbox (which you might use if you’re reading in a paper Bible). “Done” marks the current day as complete and if you are behind will take you to the next day’s readings.

How to create a reading plan

Custom Reading Plans

It is possible to create a custom reading plan for use with AndBible.

Beginning in version 4.0 (September 2021), there is a new module format that can be used for reading plans. The .properties file remains the same, but the path in jsword/readingplan no longer works on Android 10+, so we have made a new way that reading plans can be imported like other commentaries and Bibles, in .zip format. The jsword/readingplan path will continue to work for Android versions lower than 10.

The .zip format

For a sample reading plan in .zip format, please see this file. This is the complete file that is ready to import into AndBible. It can be imported from “Backup & Restore” in the main menu, or from the Reading Plan screen 3-dot menu.

The zip compressed folder contains a mods.d and a modules directory. The mods.d folder contains the .conf file. The modules folder contains the .properties file, however, the modules directory often has a longer path of folders to the .properties file. See the .conf file “DataPath” property below for an example.

When you are done preparing the mods.d and modules folders, select the 2 folders together and compress them into a zip file. This is the zip file that needs to be imported to AndBible.

The .conf file

For a sample .conf file, please see this file.

This is the content for the “Ninety days” reading plan:

[NinetyDaysReadingPlan] DataPath=./modules/texts/ztext/NinetyDaysReadingPlan/ Version=1.0 Description=Through the Bible in 90 days ShortPromo=Challenge yourself and read through the entire Bible in 90 days DistributionLicense=Public Domain Category=And Bible ModDrv=RawGenBook Versification=KJV AndBibleMinimumVersion=535 AndBibleProvidesReadingPlan=NinetyDaysReadingPlan.properties It’s quite self-explanatory, but I will highlight a few things. The “Category” has to remain as “And Bible”, and “ModDrv” needs to remain as in sample above. “Versification” default is always KJV, so that line really only needs to be provided if it’s different. For more about versification, see here. The “AndBibleMinimumVersion” also needs to remain as 535 because that’s when the zip format started to be supported. Earlier versions of AndBible will then be able to determine that this module is not supported.

The “AndBibleProvidesReadingPlan” is set to the file name that exists in the “DataPath” set at the start of the file.

If your reading plan is date-based you will need to add this line to the .conf file: AndBibleReadingPlanDateBased=true

The .properties file

You will need to create a file similar to the examples here which are the reading plans distributed with AndBible. The name of the file will be the name of the plan. The file extension must be .properties and you must place it on your mobile’s sdcard in a folder named jsword/readingplan. Use a simple text editor to create the file e.g. Notepad++ and do not use something like Word. The file must contain a series of rows in the format day=reading1,reading2 E.g.

1=Gen.1, Matt.1 2=Gen.2, Matt.2 3=Gen.3, Matt.3 4=Ps.119 5=1Cor.1, Jude

It is possible to skip days e.g. if you do not wish to a reading at the weekend. E.g.

1=Gen.1, Matt.1 3=Gen.2, Matt.2

You can also add a date-based reading plan, which includes the month and day number for each day. The only difference of this type of plan from the regular plan, is that the date-based plan will always open at today’s date by default. The regular plan opens the current day, which is the day up to where you are done reading. The file for a date-based plan must always begin the readings at 1=. Also, the date must be in the format of 3 letters for the month, then dash and month day number followed by semicolon (;). E.g.

1=Jan-1;Gen.1-2,Ps.1-2,Matt.1-2 2=Jan-2;Gen.3-4,Ps.3-5,Matt.3-4 3=Jan-3;Gen.5-6,Ps.6-8,Matt.5 … 146=May-26;Jos 12,Isa 16,2Tim 2 … 334=Nov-30;Est 7-8,Oba,Heb 3-5

As mentioned in the “.conf file” section, you will need to add this line to the .conf file: AndBibleReadingPlanDateBased=true

OSIS format references must be used and OSIS Bible book names must be used. These will be translated to the current language when displayed in AndBible. E.g. Gen.1,Matt.1-Matt.2,Ps.119.1-Ps.119.10

Example reading plans can be found here.

A full list of OSIS book names can be found here

Deuterocanonical Books

The default versification for reading plans is KJV. If you wish to include deuterocanonical books in your plan you must specify the versification in the properties file. However, this is not supported for the new zip format added in 4.0. See the “.conf file” section above for how to do this for zip format. E.g.:

Versification=Vulg 1=Sir.1-Sir.2 2=1Macc.1-1Macc.2 3=Bar.1-Bar.2

Set Start to Another Day

If you started the readings on a previous day and have just switched to AndBible then select Menu from the Daily Reading screen and then select ‘Set Start Date…’. You may then jump to ‘Move the current day to a specific day’ below to skip over readings you have already done.

Abandon Reading Plan

Press Menu/Reset from the Daily Reading screen.

Switch between Reading Plans

Select the first button in the toolbar when in the Daily Reading screen. By this means it is possible to use several plans simultaneously.

Preview a plans readings

When in the Daily Reading screen select the second button in the toolbar.

Go to a specific day

When in the Daily Reading screen select the second button in the toolbar. Then select the required day from the list.

Move the current day to a specific day This is useful if you have been using a reading plan externally from AndBible. A sequence of actions might be i) select plan ii) Set start date to another day (as above) iii) Move the current day to a specific day (as below)

Version 3.3 and earlier: Go to the day prior to the desired day as described in the above paragraph. Select Menu/Done (not the normal Done button at the bottom) this bypasses checks and marks the current day as Done and the next day will become the current day.

Note: Starting in 4.0-beta (and 4.0 stable), you will be able to simply go to 3-dot menu on top right, and click “Set as current day”.

Release information

This is the table of contents.

Information on major releases can be found below.

Searching

The search form allows searching of Bible and commentaries.

Overview

To do.

Bible searches

To do.

Commentary searches

To do.

Advanced Search

It is possible to do advanced searches using the special syntax described below.

Search Option Compatibility

Some searches cannot be performed with other searches.

‘All endings’ is not compatible with a ‘Fuzzy Search’
‘All endings’ is not compatible with a ‘Proximity Search’
‘Any word’ / ‘Phrase’ is not compatible with ‘Proximity’

Proximity Search

Find words that are a within a specific distance. To do a proximity search use the tilde, “~”, symbol at the end of a phrase. For example to search for a “God” and “light” within 10 words of each other in a document use the search:

Example

“God light”~10

Note

The order of the words are important. The above example will find verses where the word ‘God’ comes before the word ‘light’

Fuzzy Search

Fuzzy searches find words that are similar in spelling to the search words. To do a fuzzy search use the tilde, “~”, symbol at the end of a single word term followed by a number between 0 and 1. For example to search for a term similar in spelling to “believe” use the fuzzy search:

Example

believe~0.6

This search will find terms like ‘believes’, ‘believed’ etc.

To narrow the search use a larger number. A value of 0.9 is a very near match. A value of 0.3 is a very, very broad match. parameter can specify the required similarity.

Caution

Include paths are relative to the file in the document project, not the file in shared content.

Speak

Voice used for speaking

AndBible uses the Text to Speech functionality of your device to speak the text of the Bible, commentaries and books. The quality and listenability of these voices varies greatly and is not something we control. Most devices allow you to choose a different voice and modify pitch and speed. You can also install 3rd party Text-to-Speech engines which may be superior to the default voices.

The way in which you change the voice differs between devices. Try searching in Settings for Text-to-Speech > Preferred engine > Install voice data.

Speak Settings

The Speak dialog can be accessed from:

Menu ☰ > Speak
Playback control menu that is visible at the bottom of the screen when speech has been started.

Speak and play earcon sounds for
Chapter Changes	Plays a short sound when a new chapter is reached.
Titles	Read the titles that translators have added to the Bible text.
Footnotes	Read the footnotes included in the Bible text.
Speak speed	The speed that the text will be read.
Repeat passage	Repeat the range of verses specified.
Sleep timer	Stop the playback after the number of minutes specified.

How to speak a range of verses

Tick the Repeat passage box. This will show the verse selector.
Choose the book, chapter and verse at which to start.
Then choose the book, chapter and verse at which to end.
The range will now be displayed.
Push the play ▶ button at the bottom of the screen to start playback.

Study Pads

A study pad allows you to view all your notes on a particular topic.
In the Bible Study App, a topic is simply a label.
Notes can be added to a study pad directly or by adding a note to a bookmarked verse with that label.
A label could be anything – a topic like ‘Holiness’ , ‘Salvation’ or an event like ‘Sermon on 24 February’.
Once we have a label we can view the study-pad associated with it.
Of course, because we don’t yet have any bookmarks with this label and we haven’t added any notes, the study pad is empty.
Let’s give the study-pad a better title. To do this we need to add a note. Click the plus button.
Now let’s add our first Bible reference. In a bible window, add a bookmark and assign it the study pad label.
You can see as soon as we add this label to a verse, it appears in the study pad.
Now, suppose we want to add a note that is directly related to the verse we just bookmarked. To do that we need to go to the bookmark itself and add the note. The new note automatically appears.
Now let’s try bookmarking a few words.
You can see that each new bookmark with this label is automatically added to the Study Pad.
Suppose now that the speaker is no longer talking about a specific verse. That means we want to add a general note to the study pad, not to the verse itself. We push the Plus button again and enter a note.
We can tell that a note is not attached to a verse if we try to move it. Click the dot menu and then click and hold the arrow button.
Now lets try that with the verse. See how the note moves with-the-verse.
The dot menu provides some additional features. You can collapse the verse so it takes up less space by pushing the Collapse button.
You can also indent a section.
Or you can remove it completely. But be careful! That will delete the bookmark and any note attached to it.
Finally, it would be great if there was an easy way to label a verse. You can do that by setting the ‘auto-assign’ property of a label.
You can also set that property directly from the list.
Now when you add a new bookmark it will automatically get that label - and it will automatically appear in your Study Pad.
Taking sermon notes has never been easier!
So, in summary, every label has its own study pad. When you add a label to a verse, the verse will automatically appear in the Study Pad. And finally, any notes added to the bookmark will also appear in the Study Pad.

Usage

Overview

Below are suggestions on how you might like to configure the app for different use scenarios.

Bible Study

To do.

Topical Study

To do.

Word Study

To do.

Personal Devotions

To do.

Sermon notes

To do.

Original Language Study

To do.

Verse Action dialog

Bookmark

The bookmark icon creates a new bookmark and displays the Quick Label selector. See Adding a bookmark for more information.

Note

The note icon creates a new bookmark with the ‘Unlabeled’ label and opens the Notes window. You can immediately start entering your note or click the ‘Unlabeled’ tag at the top of the dialog to change the label. See Creating a note for more information.

My Notes

The My Notes icon displays all the notes you have taken for the current chapter in the Links window.

Comparing verses

Click on the verse you want to compare.
Click the Compare button.
Hide translations by clicking the hidden eye button.
Show translations by clicking the translation title at the bottom of the list.

Windows 

The ‘Bible Study App’ provides amazing window functionality.

Open as many windows as you need, showing ‘any’ document you want.
Show your ‘preferred’ bible, a translation with ‘Strongs’ numbers or ‘another’ language translation. You can also show cross-references, commentaries and dictionaries. You can ‘even’ show maps.
Each window has its ‘own’ button at the bottom of the screen. Use it to show or hide ‘that’ window. Or long press the button to access the ‘popup menu’.
You can also access the popup menu from the button at the ‘top right’ of each window. The appearance of each window can be configured from the ‘Text Options’ menu.
Windows can be synced so they ‘always’ show the same verse by setting the ‘Synchronise’ option. There are three types of windows. Pinned windows, Unpinned windows and the ‘Link’ window.
Any number of pinned windows can be shown at one time. Only one unpinned window can be shown at once.
Document links are always opened in the links window. Change a window type by changing the Pin setting.

Creating and configuring windows 

Multiple windows makes it easy to compare and drill down into verses.

There are three ways to create a new window.

First, push the New Window button in the bottom right corner.
Second, choose ‘New Window’ via the window button at the top right of any window.
Third, long-press a window button at the bottom of the screen and choose ‘New Window’.

There are multiple ways to choose the document you want to show in the new window.

You can choose a Bible by clicking the Bible-button at the top.
Or you can choose a commentary by clicking the Commentary-button.
Or you can choose any document from the application menu.

A window can be maximised so it takes up the whole screen. Restore it to its original size by pushing the restore-window button in the bottom right of the screen.

A window can be minimised so that is hidden from view. Show the window again by clicking it’s button in the window-button-bar at the bottom of the screen. Reposition the window by using the ‘Move To’ menu option.

A window has many customisation settings. The most recently used settings appear in the pop-up menu. But you can access all window settings via the ‘All-text-options’ menu item.

It’s important to understand the difference between workspace-settings and window-settings. These settings are nearly the same so it’s easy to get them confused.

Workspace-settings are accessed via the dot menu at the top right of the screen.
Workspace-settings have the gray-workspace-icon.
Workspace-settings apply to ALL windows.

Now for Window settings. They are accessed via the window-buttons.

Window-settings have either a green-workspace-icon or no icon at all.
Window-settings will use the workspace-setting unless you have changed it to something different.

So, if you want to change the appearance of all windows, change the workspace-setting. But if you only want one window to look different, change the window-setting.

Some examples:

I want the cross-reference window only to have a different background color. So I change the window-setting.
I want all other windows to have a different background color. So I change the workspace-setting. This won’t affect the window I just changed because setting the color at the Window-level overrides the workspace-setting.
And finally I want all windows to have a smaller font-size. So I change the font-size workspace-setting.

Workspaces

The concept of a work space is similar to having different multiple parks or playgrounds with the same swing sets. Workspaces allows you to have different windows whether it be Bibles, commentaries, dictionaries, or any combination of these documents arranged in different fonts, formats, or order. The way we use our Bibles differs depending on what we are doing.

For personal devotions we might like just one Bible in large print with no bookmarks.
For daily readings we may prefer several Bibles in different translations.
At church we could show one Bible and a sermon notes Study Pad.
And for focused Bible study we might have many Bibles-and-commentaries ready for easy access.

Workspaces help you do all this and more.

Workspaces remember:

the current bible references
the window arrangement
colors
fonts
and most other window settings

Access the list of workspaces via the ‘dot’ menu or by swiping down on the verse selector. This list allows you to:

reorder workspaces
create new workspaces
and delete existing ones

The Settings option allows you to edit the default settings for all windows in the workspace.

The gray workspace icon indicates you are changing a workspace default setting.

Warning

These settings affect all windows in the workspace that are using the defaults.

A green workspace icon indicates that this window setting is using the default workspace setting.

If there is no green-workspace-icon, then the setting has been changed manually and the workspace settings won’t affect it. Restore it to the default by pushing the Reset button.

Easily navigate between workspaces using gestures.