Skip to content
v0.10.0 What’s new ›

bible-tui

Read the Bible in your terminal.

A fast, dependency-free terminal Bible reader with Vim-style keys. Free and open source for macOS and Linux.

brew install codysechelski/tap/bible-tui
  • free & open source
  • zero dependencies
  • pure Python
  • macOS · Linux

Scripture, where you already work.

If your day happens in a terminal, a browser tab full of ads is a detour. bible-tui opens in a blink, works offline, and moves the way your editor does: arrows and Enter for everyone, hjkl and : for Vim hands.

ctrl+g

John 3:16. Enter. You’re there.

Type a reference and jump straight to it, with book names that autocomplete as you go. Or stay on the Vim-style command line and type :John 3:16.

Read more about John 3:16. Enter. You’re there. ›

ctrl+s

Find the verse you half remember.

Fuzzy-find every verse in the Bible as you type, with a live preview. Typos still land, and a small query syntax handles exact words, prefixes, and exclusions.

Read more about Find the verse you half remember. ›

ctrl+w v

Two versions. Lined up.

Split the screen and read two translations side by side or one above the other. Every verse starts on the same line in both panes, so differences jump out.

Read more about Two versions. Lined up. ›

c · m

Mark and Highlight Verses. Every Version.

Highlight verses in six colors and mark the ones you want to come back to. They’re saved to plain files and show up in every translation you open.

Read more about Mark and Highlight Verses. Every Version. ›

Keyboard first

Keys you already know.

Every action works with plain keys, and Vim users get the motions they expect. Press ctrl+p or ? in the app to see them all.

  • hjklMove around
  • []Previous or next chapter
  • ctrlgGo to a reference
  • /Search the chapter
  • ctrlsSearch the whole Bible
  • tSwitch version
  • yyCopy the verse
  • ?Every command and key

Every key binding ›

Small tool. Lots of care.

See it in two minutes.

Turn the sound on: the reel has a soundtrack.

Questions

What about the NIV or ESV?

bible-tui only ships Bibles that are in the public domain or under an open licence that allows sharing. Most modern translations, including the NIV and ESV, are under copyright, so they can’t be bundled. You can still read any version you have the rights to: convert a published Bible with the companion bible-tui-bible-converter, or build a SQLite file that matches the documented schema.

Does it work on Windows?

bible-tui is made for macOS and Linux and isn’t supported on Windows directly. Windows Subsystem for Linux (WSL) gives you a Linux terminal to try it in; copying even uses clip.exe there.

Do I need to know Vim?

No. Every action works with the arrow keys, Tab, Enter, and Esc, and ctrl+p lists every command with its keys. Vim motions are there as alternatives for people who already have them in their fingers.

Does it need the internet?

No. The Bibles are local SQLite files. bible-tui checks for a new release once a day, and you can turn that off with "check_for_updates": false.

How much does it cost?

Nothing. bible-tui is free and open source under the MIT License, and the bundled Bible texts are in the public domain.

Do I need a Nerd Font?

No. With "nerd_font": true you get extra icons, but the default display uses plain Unicode symbols that work in any terminal font.

Open it in a second.

Free and open source under the MIT License, for macOS and Linux.

brew install codysechelski/tap/bible-tui