Home
Softono

Bk

Open source MIT Rust
333
Stars
30
Forks
12
Issues
5
Watchers
2 years
Last Commit

 About Bk

Terminal Epub reader

Platforms

Web Self-hosted

Languages

Rust

Links

Need Help Installing Bk?

We provide expert installation service for this software. Our team will install, configure, and secure Bk on your server. plans start at just $30.

bk

bk is a terminal EPUB reader, written in Rust.

Features

  • Cross platform - Linux, macOS and Windows support
  • Single binary, instant startup
  • EPUB 2/3 support
  • Vim bindings
  • Incremental search
  • Bookmarks

Install

Install from crates.io:

cargo install bk

or from github:

git clone https://github.com/aeosynth/bk
cargo install --path bk

Usage

Usage: bk [<path>] [-m] [-t] [-w <width>]

read a book

Options:
  --bg              background color (eg 282a36)
  --fg              foreground color (eg f8f8f2)
  -m, --meta        print metadata and exit
  -t, --toc         start with table of contents open
  -w, --width       characters per line
  --help            display usage information

Running bk without a path will load the most recent EPUB.

Type any function key (eg F1) to see the keybinds.

Check if your terminal supports italics:

echo -e "\e[3mitalic\e[0m"

Comparison

bk epr/epy
runtime deps python, curses
wide characters ✔️
incremental search ✔️
multi line search ✔️
regex search ✔️
links ✔️
images ✔️
themes ✔️ ✔️
choose file from history ✔️
additional formats FictionBook, Mobi, AZW3
external integration see 1 dictionary

1: you can use the --meta switch to use bk as a file previewer with eg nnn

Inspiration

https://github.com/wustho/epr