A terminal EPUB reader built with Textual.
- File browser to navigate and open EPUB files
- Chapter sidebar with TOC navigation
- Keyboard-driven reading
Requires uv.
git clone <repo>
cd epub-tui
uv sync# Open file browser
uv run epub-tui
# Open a specific EPUB
uv run epub-tui path/to/book.epub| Key | Action |
|---|---|
Enter |
Open EPUB / select chapter |
n |
Next chapter |
p |
Previous chapter |
t |
Toggle TOC sidebar |
Esc / q |
Back / Quit |
- textual — TUI framework
- ebooklib — EPUB parsing
- html2text — HTML to Markdown conversion
- beautifulsoup4 — HTML fallback parsing