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
Small tool. Lots of care.
Any version, any language
Each translation is one SQLite file. The public-domain KJV and ASV are included; add any version you have the rights to.
Read more about Any version, any language ›Zero dependencies
Pure Python standard library. Nothing to compile, nothing to break, and it starts instantly.
Plain files you own
Settings, marks, and highlights are readable JSON in one folder. Back it up or keep it in your dotfiles.
Read more about Plain files you own ›A real : command line
Vim-style commands with suggestions as you type: :vsplit, :set version=ASV, :marks, :find, and more.
Read more about A real : command line ›Copy with the reference
yy copies a verse, v and V select. Set a yank_format to paste the reference and version along with it.
Read more about Copy with the reference ›Proverb of the day
:potd opens the chapter of Proverbs that matches today’s date. Thirty-one chapters, one a day.
Read more about Proverb of the day ›Updates in place
A once-a-day check tells you in the footer. :update installs it and reopens at the same verse. Or turn it off.
Read more about Updates in place ›Nerd Font icons, if you like
Turn on nerd_font for icons in the gutter and menus. Plain Unicode symbols work fine without one.
Read more about Nerd Font icons, if you like ›Private and offline
No account and no tracking. The only network call is the optional update check, and you can switch it off.
Read more about Private and offline ›
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