rvb — Recovery Version Bible CLI

A fast, study-grade terminal Bible reader for the Recovery Version. Offline-first, footnote-aware, cross-reference deep-linking, clipboard-friendly.

Installation

1. Install Node.js (if you don't have it)

Mac:

# Option A: Download the installer from https://nodejs.org (pick LTS)
# Option B: Using Homebrew
brew install node

Windows:

1. Go to https://nodejs.org
2. Download the LTS installer
3. Run the installer — accept the defaults
4. Restart your terminal (PowerShell or Command Prompt)

To verify Node.js is installed, open a terminal and run:

node --version    # should print v18 or higher

2. Install rvb

Open your terminal and run:

npm install -g rv-bible-cli

That's it. Now type rvb to launch.

Windows note: In PowerShell, use rvb (not rv). On Mac/Linux, both rv and rvb work.

Quick Start

rvb                 # home screen — browse all 66 books
rvb john 3          # read a chapter
rvb john 3:16       # read a single verse
rvb search grace    # search the Bible
rvb continue        # resume where you left off
rvb help            # see all commands

Features

Reading

rvb john 3              # chapter mode — opens interactive pager
rvb john 3:16           # single verse
rvb john 3:16-18        # verse range
rvb john 3:16,18,20     # specific verses
rvb john 3:16 rom 8:28  # verses across books
rvb jn 3                # fuzzy book names (jn, gen, rm, eph, rev, etc.)
rvb john 3 --notes      # inline footnote markers + footnote block
rvb john 3 --outline    # section headers inline
rvb john 3 --full       # both notes and outline
rvb john 3 --raw        # plain text, no pager (also auto when piped)

Footnotes

rvb note john 3:16      # all footnotes for a verse
rvb note john 3:16 2d   # specific footnote by marker
rvb note john 3:14-16   # footnotes for a range

Search

Concordance-first for known words (1,129 curated entries), full-text for everything else.

rvb search grace              # concordance lookup
rvb search grace in romans    # scoped to a book
rvb search "only begotten"    # phrase match
rvb search eternal life       # multi-word AND
rvb search grace --all        # show all results (default: 20/page)

Copy to Clipboard

Add --copy to any read command. Output displays normally AND goes to clipboard.

rvb john 3:16 --copy              # "John 3:16 For God so loved..."
rvb john 3:16 --copy --no-ref     # plain text only
rvb john 3:16 --copy --numbered   # verse number prefix
rvb john 3:16 --copy --md         # markdown block quote
rvb search grace --copy           # copy all search results

Navigation

rvb                # home screen — browse books, pick chapters
rvb continue       # resume last-read chapter

Interactive Pager

When you read a chapter in a terminal, rvb opens a full-screen interactive reader — like a book in your terminal.

Reading Mode

| Key | Action | |-----|--------| | j / k / arrows | scroll up/down | | Space / b | page down/up | | g / G | jump to top / bottom | | left / right | prev / next chapter (even across books) | | f | toggle footnotes on/off | | o | toggle outline on/off | | + / - | adjust text width | | d | enter study mode | | c | enter copy mode | | / | find text in current chapter | | : | jump to any book — type rom 8, jn 3, etc. | | [ / ] | go back / forward (like browser history) | | H | go to home screen | | q | quit |

Tip: To make the text bigger or smaller, use your terminal's font size shortcut: Cmd +/- on Mac, Ctrl +/- on Windows/Linux.

Study Mode (d)

Deep-dive into footnotes and cross-references. Press d while reading any chapter.

• A cursor highlights the current verse
• The bottom panel shows all footnotes for that verse with numbered cross-references
• Type a number to follow a cross-reference — you'll jump to that chapter and land on the exact verse
• Press [ to go back to where you were
• Study mode stays active as you navigate — it's designed for chaining through references

| Key | Action | |-----|--------| | up / down | move between verses | | left / right | prev / next chapter | | type number | follow a cross-reference | | v then up/down then c | select a range and copy | | c | copy current verse | | f / o | toggle footnotes / outline | | / | find text | | : | jump to a book | | d or Esc | exit study mode |

Copy Mode (c)

Select and copy verses to your clipboard without leaving the pager.

| Key | Action | |-----|--------| | up / down | move verse cursor | | v | start selecting a range | | Enter or c | copy to clipboard | | Esc | cancel |

Home Screen

Run rvb with no arguments, or press H from the pager.

• Arrow keys navigate the book grid (Old Testament + New Testament)
• Type a letter to jump to matching books (press again to cycle)
• Enter selects a book, then pick a chapter
• Space continues where you left off

What's Included

The entire Recovery Version Bible is bundled offline — no internet needed, no accounts, no setup.

| Content | Count | |---------|-------| | Books | 66 | | Verses | 31,220 | | Footnotes | 47,436 | | Cross-references | 199,369 | | Section headers | 2,907 | | Concordance entries | ~110,000 |

Updating

npm install -g rv-bible-cli@latest

License

For personal study use.