Basic Concepts 

This page explains the key features of the Toolbar,  Layout Editor,  Databases,  Passage Window, Results Tab, Search Table, and Search Bucket.


Each of the elements on the toolbar is described below.



Enter a Bible Reference here, and press <Enter>.  Valid formats are a single verse (Gen 1:1), a range (Gen 1:31-2:4), or a chapter (Gen 1)


Versification Scheme


The verse numbering systems for the English Bible, GNT, MT, LXX and Vulgate differ at times.  Use the versification dropdown to select the versification schemes to be used when processing a BibleRef (eg. Ps 23:3 in the MT is Ps 22:3 in LXX and Vulgate).




Use the layout dropdown to select a layout to be used when a passage window is displayed.  See Layout Editor below for more information.


Default Bible


Use the DefaultBible dropdown to select a default bible.  The default bible is used in two places – it is the bible searched when a phrase search is initiated, and it is the bible displayed in layouts that use the special code @@BIBLE## (See the layout editor section below for more information)

Phrase Search


Type a phrase into the PhraseSearch box  (eg. God created), and press <enter>.  The currently nominated default bible will be search for matches on that phrase.


Search Lexicon


These ‘Search Lexicon’ options are explained on the ‘simple searches’ help page.

Search Tools


These ‘Search Lexicon’ options are explained on the ‘advanced searches’ help page.




The config menu allows you to edit layouts and database codes (see below), download updates to database files, and to configure BibleCrawler preferences.


Layout Editor


A layout file is a HTML file that configures how and where bible verses are displayed in the passage display window.


It is strongly recommended that you do NOT change the standard layouts (in case you break them!)  Instead, create a copy of a layout by changing the name of an existing layout, then click “Save Layout”.  For example, change the name “Default” to “DefaultNew”, then click the “Save Layout” button, then make any further changes, then “Save Layout” again.  Your new layout will be added to the layout list when you close the layout editor (Red “X” at the top right).


A layout consists of three sections (represented by the first three text windows shown above)

   a header (which only occurs once per bible passage)

   verse rows (which reoccur for each verse in the passage being displayed)

   a footer (which only occurs once per bible passage)


A database is represented by the code @@[DatabaseCode]##    - eg. @@GNT##, @@RSV##.

@@VerseRef##   represents an individual verse id – eg. Matt 1:1.

@@BIBLE## is a special code to represent the ‘DefaultBible’ as selected on the toolbar when the passage is displayed. Eg. If the default bible is RSV, @@BIBLE##  becomes @@RSV##.


A layout file could be as simple as

  no header

 @@VerseRef##  @@GNT##

  no footer


This would display as (for example)

Matt 1:1 Βίβλος γενέσεως Ἰησοῦ χριστοῦ υἱοῦ Δαυὶδ υἱοῦ Ἀβραάμ. Matt 1:2 Ἀβραὰμ ἐγέννησεν τὸν Ἰσαάκ, Ἰσαὰκ δὲ ἐγέννησεν τὸν Ἰακώβ, Ἰακὼβ δὲ ἐγέννησεν τὸν Ἰούδαν καὶ τοὺς ἀδελφοὺς αὐτοῦ, Matt 1:3 Ἰούδας δὲ ἐγέννησεν τὸν Φαρὲς καὶ τὸν Ζάρα ἐκ τῆς Θαμάρ, Φαρὲς δὲ ἐγέννησεν τὸν Ἑσρώμ, Ἑσρὼμ δὲ ἐγέννησεν τὸν Ἀράμ,


The ‘Default’ layout show in the screen shot above uses HTML tables to format the bible passages into rows and columns.  The html code   class=“greekfont” and class=”hebrewfont” refer to font definitions stored in the file   [user’s AppData Path]\BibleCrawler\Layouts\HTMLHead.html


The “Show Me” button displays a mini web browser window so that you can see how your HTML will be rendered at runtime.


Layout files are stored in the directory [UsersAppData]\BibleCrawler\Layouts, and have the filename  [layoutname].bcl    (bcl = BibleCrawlerLayout)


Database Code Editor


BibleCrawler uses texts stored in various databases.  Database codes are used to tell BibleCrawler what texts are available, and how to connect and retrieve the necessary data.   A database code file is named [shortname of database].bcd  (bcd = BibleCrawlerDatabase).


It consists of the following lines







displayfield~     ~



searchfield~  ~

searchfield~  ~

searchfield~  ~




Passage Window

Bible verses / passages are displayed in the upper Tab Page area, using the layout as specified in the Layout selector in the toolbar (see above).  You have the option to change the layout, using the Layout drop-down list on the passage window.  After you select a different layout, these verses will be redisplayed using the new layout.


Use the switch tabs button (the reciprocal arrows at the top right) to move this tab to the lower tab page area.

Use the close window button (the red X at the top right) to remove this tab.


Results Tab

The results table shows the results of a word search initiated from the passage window.  For example:


Search Table

The search table lists the word searches that have been executed.  This list of search patterns is used to determine which words should be highlighted when a passage is displayed.  You may change the highlight colour to any standard HTML colour name.


If you do not want a word to be highlighted, delete its line from the search table.  If you have finished a set of searches and wish to stop all highlighting, click the “Clear Search Table” button.

Search Bucket

The search bucket is used to accumulate the results of multiple searches.  This enables complex searches to be build up progressively.


In the example below, the results of two searches were copied to the bucket.


 The operation of the search bucket is explained on the “Advanced Searches” help page.