epr

A terminal‑based EPUB reader written for Python 3.6 that remembers the last opened file and the reading position for each book, storing its state in a user configuration directory. It adapts to terminal resizes, allows the text area width to be adjusted, and offers vim‑like key bindings. The program supports EPUB 3 files, can display embedded images, and provides a simple dark or light colour scheme that can be cycled with a keystroke.

The reader maintains a history of opened books; invoking the command with arbitrary strings will search that history and open the best‑matching file, while a flag lists all entries. Configuration is stored in $HOME/.config/epr/config or $HOME/.epr depending on availability. Limitations include a minimum terminal width of 22 columns, regex‑only search, left‑to‑right Latin‑alphabet text, and no hyperlink support.

Installation is available through PyPI, Homebrew, Chocolatey, the Arch AUR, or direct source checkout, and Windows users require the windows‑curses package. The project is stable and provides a lightweight, command‑line alternative for reading EPUBs without a graphical interface.