This is a little TUI epub ebook reader. This is a work in progress and may not work for all EPUB files yet. It uses a modified version of the epub module, which seems to be unmaintained but the best I could find to parse EPUBs. Find it in the pkg/epub/ directory.

Screenshots

Viewing an ebook in dark mode
Viewing an ebook in light mode
You can interactively adjust text width
Showing the help

Installation

The tool does not have any dependencies. Just download the binary for your platform from the releases page and you're good to go.

Installation using a pre-compiled binary

Go to the latest release page and look for your OS and platform. There are two options to install the binary:

Directly download the binary for your platform, e.g. epuppy-linux-amd64-0.0.2, rename it to epuppy (or whatever you like more!) and put it into your bin dir (e.g. $HOME/bin or as root to /usr/local/bin).

Be sure to verify the signature of the binary file. For this also download the matching epuppy-linux-amd64-0.0.2.sha256 file and:

cat epuppy-linux-amd64-0.0.2.sha25 && sha256sum epuppy-linux-amd64-0.0.2

You should see the same SHA256 hash.

You may also download a binary tarball for your platform, e.g. epuppy-linux-amd64-0.0.2.tar.gz, unpack and install it. GNU Make is required for this:

tar xvfz epuppy-linux-amd64-0.0.2.tar.gz
cd epuppy-linux-amd64-0.0.2
sudo make install

Installation from source

Check out the repository and execute go build, then copy the compiled binary to your $PATH.

Or, if you have GNU Make installed, just execute:

make
sudo make install

README.md

epuppy - terminal epub reader

Screenshots

Installation

Installation using a pre-compiled binary

Installation from source

Report bugs

License

Author