Skip to content

Command line

Eliran Wong edited this page Feb 2, 2021 · 5 revisions

UniqueBible.app supports a set of command lines for quick navigation to bible passages or tools.

screenshot_command_line

Users can run our built-in commands with command field as indicated above.

General Remarks:

These remarks apply to all supported commands described below.

  1. You can press "TAB" as a shortcut to make command line field in focus and ready for typing.
  2. Use of command KEYWORD is case-insensitive. For example, "compare:::John 3:16" produces the same result as "COMPARE:::John 3:16".
  3. Where bible reference is part of a command, common book abbreviations are supported. For example, the following references are all accepted:
    "John 3:16", "Jn 3:16", "Joh 3:16".
  4. Keywords starting with "_" are generally internal commands created for GUI operations. They are not kept as part of history records.

[KEYWORD] BIBLE

Feature - Open a bible chapter or multiples verses on main or study view.
Usage - BIBLE:::[BIBLE_VERSION]:::[BIBLE_REFERENCE(S)]
Remarks:

  1. The bible version last opened on main view is opened by default if "[BIBLE_VERSION]:::" or "BIBLE:::[BIBLE_VERSION]:::" is omitted.
  2. If "BIBLE:::" command is called from manual entry via command field or a link within the content on main view, bible text is opened on main view.
  3. If "BIBLE:::" command is called from a link within the content on study view and "Bible Display on Study View" is enabled, bible text is opened on study view.
  4. If "BIBLE:::" command is called from a link within the content on study view and "Bible Display on Study View" is disabled, bible text is opened on main view.
  5. Common abbreviations of bible references are supported.

e.g. John 3:16
e.g. Jn 3:16; Rm 5:8; Deu 6:4
e.g. BIBLE:::John 3:16
e.g. BIBLE:::Jn 3:16; Rm 5:8; Deu 6:4
e.g. BIBLE:::KJV:::John 3:16
e.g. BIBLE:::KJV:::Jn 3:16; Rm 5:8; Deu 6:4

[KEYWORD] MAIN

Feature - Open a bible chapter or multiples verses on main view.
Usage - MAIN:::[BIBLE_VERSION]:::[BIBLE_REFERENCE(S)]
Remarks:

  1. The bible version last opened on main view is opened by default if "[BIBLE_VERSION]:::" or "MAIN:::[BIBLE_VERSION]:::" is omitted.
  2. Common abbreviations of bible references are supported.

e.g. John 3:16
e.g. Jn 3:16; Rm 5:8; Deu 6:4
e.g. MAIN:::John 3:16
e.g. MAIN:::Jn 3:16; Rm 5:8; Deu 6:4
e.g. MAIN:::KJV:::John 3:16
e.g. MAIN:::KJV:::Jn 3:16; Rm 5:8; Deu 6:4

[KEYWORD] STUDY

Feature - Open a bible chapter or multiples verses on study / main view.
Usage - STUDY:::[BIBLE_VERSION]:::[BIBLE_REFERENCE(S)]
Remarks:

  1. The bible version last opened on study view is opened by default if "[BIBLE_VERSION]:::" is omitted.
  2. If "Bible Display on Study View" is enabled, bible text is opened on study view.
  3. If "Bible Display on Study View" is disabled, bible text is opened on main view.
  4. Common abbreviations of bible references are supported.

e.g. STUDY:::John 3:16
e.g. STUDY:::Jn 3:16; Rm 5:8; Deu 6:4
e.g. STUDY:::KJV:::John 3:16
e.g. STUDY:::KJV:::Jn 3:16; Rm 5:8; Deu 6:4

[KEYWORD] TEXT

Feature - Change the bible version of the last opened passage on main view.
Usage - TEXT:::[BIBLE_VERSION]

e.g. TEXT:::KJV
e.g. TEXT:::NET

[KEYWORD] COMPARE

Feature - Compare bible versions of a single or multiple references.
Usage - COMPARE:::[BIBLE_VERSION(S)]:::[BIBLE_REFERENCE(S)]
Remarks:

  1. All installed bible versions are opened for comparison if "[BIBLE_VERSION(S)]:::" is omitted.
  2. Multiple bible versions for comparison are separated by "_".
  3. If a single reference is entered and bible versions for comparison are specified, verses of the same chapter of the entered reference are opened.
  4. Muliple verse references are supported for comparison.

e.g. COMPARE:::John 3:16
e.g. COMPARE:::KJV_NET_CUV:::John 3:16
e.g. COMPARE:::KJV_NET_CUV:::John 3:16; Rm 5:8

[KEYWORD] DIFF

Feature - Compare bible versions against the last opened version, with highlights of differences.
Dependency - This feature is available since the release of version 5.7. You have to install package 'diff_match_patch' to run this feature. Read https://github.com/eliranwong/UniqueBible#install-dependencies for guideline on installation.
Usage - DIFF:::[BIBLE_VERSION(S)]:::[BIBLE_REFERENCE(S)]
Remarks:

  1. Last-opened bible version is always displayed at the top for comparison.
  2. All installed bible versions are opened for comparison if "[BIBLE_VERSION(S)]:::" is omitted.
  3. Multiple bible versions for comparison are separated by "_".
  4. Muliple verse references are supported for comparison.

e.g. DIFF:::Joh 3:16
e.g. DIFF:::KJV_ASV_WEB:::Joh 3:16; Rm 5:8

[KEYWORD] DIFFERENCE

Feature - same as [KEYWORD] DIFF
Usage - DIFFERENCE:::[BIBLE_VERSION(S)]:::[BIBLE_REFERENCE(S)]

e.g. DIFFERENCE:::Joh 3:16
e.g. DIFFERENCE:::KJV_ASV_WEB:::Joh 3:16; Rm 5:8

[KEYWORD] PARALLEL

Feature - Display bible versions of the same chapter in parallel columns.
Usage - PARALLEL:::[BIBLE_VERSION(S)]:::[BIBLE_REFERENCE]
Remarks:

  1. Multiple bible versions for comparison are separated by "_".
  2. If a single reference is entered and bible versions for comparison are specified, verses of the same chapter of the entered reference are opened.
  3. Muliple verse references are supported for comparison.
  4. Only the bible version last opened on main view is opened if "[BIBLE_VERSION(S)]:::" is omitted.

e.g. PARALLEL:::NIV_CCB_CEB:::John 3:16
e.g. PARALLEL:::NIV_CCB_CEB:::John 3:16; Rm 5:8

[KEYWORD] PASSAGES

Feature - Display different bible passages of the same bible version in parallel columns. It is created for studying similar passages.
Usage - PASSAGES:::[BIBLE_VERSION]:::[BIBLE_REFERENCE]
Remarks:

  1. Only the bible version last opened on main view is opened if "[BIBLE_VERSION(S)]:::" is omitted.
  2. Only the first bible version specified in the command is taken, even multiple bible versions are entered and separated by "_".
  3. Users can read an additional version by setting config.extractParallel as True.
  4. Book abbreviations and ranges of verses are supported for bible references.
  5. If a chapter reference is entered, only verse 1 of the chapter specified is displayed.

e.g. PASSAGES:::Mat 3:13-17; Mark 1:9-11; Luk 3:21-23
e.g. PASSAGES:::KJV:::Mat 3:13-17; Mark 1:9-11; Luk 3:21-23

[KEYWORD] SEARCH

e.g. SEARCH:::KJV:::love
e.g. SEARCH:::KJV_WEB:::love

[KEYWORD] SHOWSEARCH

e.g. SHOWSEARCH:::KJV:::love

[KEYWORD] ADVANCEDSEARCH

e.g. ADVANCEDSEARCH:::KJV:::Book = 1 AND Scripture LIKE '%love%'

[KEYWORD] ANDSEARCH

e.g. ANDSEARCH:::KJV:::love|Jesus
alias of, e.g. ADVANCEDSEARCH:::KJV:::Scripture LIKE "%love%" AND Scripture LIKE "%Jesus%"

[KEYWORD] ORSEARCH

e.g. ORSEARCH:::KJV:::love|Jesus
alias of, e.g. ADVANCEDSEARCH:::KJV:::Scripture LIKE "%love%" OR Scripture LIKE "%Jesus%"

[KEYWORD] INDEX

e.g. INDEX:::Gen 1:1

[KEYWORD] CROSSREFERENCE

e.g. CROSSREFERENCE:::Gen 1:1

[KEYWORD] TSKE

e.g. TSKE:::Gen 1:1

[KEYWORD] COMMENTARY

Feature - Open commentary of a bible reference.
Usage - COMMENTARY:::[COMMENTARY_MODULE]:::[BIBLE_REFERENCE]
Remarks:

  1. The last opened commentary module is opened if "[COMMENTARY_MODULE]:::" is omitted.
  2. Commentary is opened on study view.

e.g. COMMENTARY:::John 3:16
e.g. COMMENTARY:::CBSC:::John 3:16

[KEYWORD] COMMENTARY2

Feature - Open commentary of a bible reference.
Usage - COMMENTARY2:::[COMMENTARY_MODULE]:::[BIBLE_REFERENCE]
Remarks:

  1. The last opened commentary module is opened if "[COMMENTARY_MODULE]:::" is omitted.
  2. Commentary is opened on study view.
  3. Bible reference used with "COMMENTARY2:::" is formatted as [BOOK_NUMBER.CHAPTER_NUMBER.VERSE_NUMBER], see examples below.

e.g. COMMENTARY2:::43.3.16
e.g. COMMENTARY2:::CBSC:::43.3.16

[KEYWORD] COMBO

e.g. COMBO:::Gen 1:1

[KEYWORD] TRANSLATION

e.g. TRANSLATION:::Gen 1:1

[KEYWORD] DISCOURSE

e.g. DISCOURSE:::Gen 1:1

[KEYWORD] WORDS

e.g. WORDS:::Gen 1:1

[KEYWORD] LEXICON

e.g. LEXICON:::BDB:::H7225

[KEYWORD] LMCOMBO

e.g. LMCOMBO:::E70002:::ETCBC:::subs.f.sg.a

[KEYWORD] LEMMA

e.g. LEMMA:::E70002
e.g. LEMMA:::H7225

[KEYWORD] MORPHOLOGYCODE

e.g. MORPHOLOGYCODE:::E70002,subs.f.sg.a

[KEYWORD] MORPHOLOGY

e.g. MORPHOLOGY:::LexicalEntry LIKE '%E70002,%' AND Morphology LIKE '%feminine%'

[KEYWORD] SEARCHMORPHOLOGY

e.g. SEARCHMORPHOLOGY:::E70002:::feminine
alias of e.g. MORPHOLOGY:::LexicalEntry LIKE '%E70002,%' AND (Morphology LIKE "%feminine%")
e.g. SEARCHMORPHOLOGY:::E70002:::feminine|noun
alias of e.g. MORPHOLOGY:::LexicalEntry LIKE '%E70002,%' AND (Morphology LIKE "%feminine%" OR Morphology LIKE "%noun%")

[KEYWORD] WORD

e.g. WORD:::1:::2

[KEYWORD] CLAUSE

e.g. Embed in the first clause of Gen 1:1 in MAB
e.g. CLAUSE:::1.1.1:::1

[KEYWORD] SEARCHTOOL

e.g. SEARCHTOOL:::EXLBP:::Jesus
e.g. SEARCHTOOL:::HBN:::Jesus
e.g. SEARCHTOOL:::EXLBL:::Jerusalem
e.g. SEARCHTOOL:::EXLBT:::faith
e.g. SEARCHTOOL:::EAS:::faith
e.g. SEARCHTOOL:::ISB:::faith
e.g. SEARCHTOOL:::mETCBC:::prep

[KEYWORD] EXLB

e.g. EXLB:::exlbp:::BP904
e.g. EXLB:::exlbl:::BL636

[KEYWORD] DICTIONARY

e.g. DICTIONARY:::EAS1312

[KEYWORD] ENCYCLOPEDIA

e.g. ENCYCLOPEDIA:::ISB:::ISBE3333

[KEYWORD] SEARCHTHIRDDICTIONARY

e.g. SEARCHTHIRDDICTIONARY:::faith

[KEYWORD] THIRDDICTIONARY

e.g. THIRDDICTIONARY:::webster:::FAITH

[KEYWORD] BOOK

e.g. BOOK:::Timelines:::2210-2090_BCE

[KEYWORD] SEARCHBOOK

To search the last opened book module
e.g. SEARCHBOOK:::Abraham
To search a particular book module
e.g. SEARCHBOOK:::OT_History1:::Abraham
To search mutliple books, separate book modules with a comma ",".
e.g. SEARCHBOOK:::OT_History1,OT_History2:::Abraham
To search all installed book modules:
e.g. SEARCHBOOK:::ALL:::Abraham
Remarks: Module creator should avoid comma for naming a book module.

[KEYWORD] SEARCHCHAPTERNOTE

e.g. SEARCHCHAPTERNOTE:::faith

[KEYWORD] SEARCHVERSENOTE

e.g. SEARCHVERSENOTE:::faith

[KEYWORD] CMD

Feature - Run an os command Warning! Make sure you know what you are running before you use this keyword. The running command may affect data outside UniqueBible folder. Use at your own risk!

Examples on Windows: e.g. cmd:::notepad e.g. cmd:::start latest_changes.txt

Examples on macOS: e.g. cmd:::open latest_changes.txt e.g. cmd:::open "~/Applications/Visual Studio Code.app"/

Examples on Linux: e.g. cmd:::firefox e.g. cmd:::mkdir -p myNotes; cd myNotes; gedit test.txt e.g. cmd:::rm -rf myNotes e.g. cmd:::google-chrome https://uniquebible.app

[KEYWORD] SPEAK

Usage - SPEAK:::[TEXT]
Usage - SPEAK:::[LANGUAGE]:::[TEXT]
Feature: run text-to-speech function If language is not specified, config.ttsDefaultLanguage is applied.

e.g. SPEAK:::All Scripture is inspired by God e.g. SPEAK:::en-gb:::All Scripture is inspired by God e.g. SPEAK:::zh-cn:::聖經都是上帝所默示的 e.g. SPEAK:::zh-tw:::聖經都是上帝所默示的

[KEYWORD] _imv

e.g. _imv:::1.1.1 e.g. _imv:::43.3.16

[KEYWORD] _instantverse

e.g. _instantVerse:::KJV:::1.1.1

[KEYWORD] _instantword

e.g. _instantWord:::1:::h2

[KEYWORD] _menu

e.g. _menu:::

[KEYWORD] _commentary

e.g. _commentary:::CBSC.1.1.1

[KEYWORD] _book

e.g. _book:::

[KEYWORD] _info

e.g. _info:::Genesis

[KEYWORD] _bibleinfo

e.g. _bibleinfo:::KJV

[KEYWORD] _commentaryinfo

e.g. _commentaryinfo:::CBSC

[KEYWORD] _command

e.g. _command:::testing

[KEYWORD] _history

e.g. _history:::main e.g. _history:::study

[KEYWORD] _historyrecord

e.g. _historyrecord:::1

[KEYWORD] _image

e.g. _image:::EXLBL:::1.jpg

[KEYWORD] _editchapternote

e.g. _editchapternote:::

[KEYWORD] _editversenote

e.g. _editversenote:::

[KEYWORD] _openchapternote

e.g. _openchapternote:::43.3

[KEYWORD] _openversenote

e.g. _openversenote:::43.3.16

[KEYWORD] _openfile

e.g. _openfile:::1

[KEYWORD] _editfile

e.g. _editfile:::1

[KEYWORD] _website

e.g. _website:::https://marvel.bible

[KEYWORD] _uba

e.g. _uba:::file://notes.uba e.g. _uba:::file://note_editor_key_combo.uba

[KEYWORD] _biblenote

e.g. _biblenote:::1.1.1.[1]

[KEYWORD] _wordnote

e.g. _wordnote:::LXX1:::l1

[KEYWORD] _searchword

e.g. _searchword:::1:::1

[KEYWORD] _paste

e.g. _paste:::

Clone this wiki locally