Skip to content
Projects

aeosynth/bk has 343 GitHub stars and 29 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 01:05 UTC. Last push 2024-06-09.

How these counts are measured

What you can do

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

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Terminal Epub reader

Developer Tools

README.md

Original

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