epr
brew install epr
v2.4.15
MIT
Command-line EPUB reader
17
30-day installs · #7253
70
90-day · #6456
340
365-day · #6010
1.4k
★ GitHub stars · updated 3y ago
Runtime dependencies
GitHub topics
cli
ebook
epub
epub-reader
epub3
python
python3
terminal
Links
- https://github.com/wustho/epr
- GitHub: wustho/epr
- Brew formula source: Formula/e/epr.rb
Raw metadata
{
"aliases": [],
"alternatives": [],
"build_dependencies": [],
"categories": [],
"caveats": null,
"conflicts_with": [],
"dependencies": [
"python@3.14"
],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Command-line EPUB reader",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:37:21+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "epr",
"github_default_branch": "master",
"github_last_commit_at": "2023-02-08T04:18:39Z",
"github_readme_excerpt": "# `$ epr`\n\n\n\nTerminal/CLI Epub reader written in Python 3.6 with features:\n\n- Remembers last read file (just run `epr` without any argument)\n- Remembers last reading state for each file (per file saved state written to `$HOME/.config/epr/config` or `$HOME/.epr` respectively depending on availability)\n- Adjustable text area width\n- Adaptive to terminal resize\n- Supports EPUB3 (no audio support)\n- Secondary vim-like bindings\n- Supports opening images\n- Dark/Light colorscheme (depends on terminal color capability)\n\n## Limitations\n\n- Minimum width: 22 cols\n- Supports regex search only\n- Supports only horizontal left-to-right text\n- Currently, only supports language with latin alphabet (see [issue30](https://github.com/wustho/epr/issues/30))\n- Doesn\u0027t support hyperlinks\n- \u003csup\u003eSuperscript\u003c/sup\u003e and \u003csub\u003esubscript\u003c/sub\u003e displayed as `^{Superscript}` and `_{subscript}`.\n- Some known issues mentioned below\n\n## Dependencies\n\n- Windows: `windows-curses`\n\n## Installation\n\n - Via PyPI\n\n ```shell\n $ pip3 install epr-reader\n ```\n\n - Via Pip+Git\n\n ```shell\n $ pip3 install git+https://github.com/wustho/epr.git\n ```\n\n - Via [Homebrew](https://formulae.brew.sh/formula/epr) for macOS or Linux\n\n ```shell\n $ brew install epr\n ```\n\n - Via Chocolatey\n\n Maintained by [cybercatgurrl](https://github.com/cybercatgurrl/chocolatey-pkgs/tree/master/epr)\n\n ```shell\n $ choco install epr\n ```\n\n - Via AUR\n\n Maintained by [jneidel](https://aur.archlinux.org/packages/epr-git/)\n\n ```shell\n $ yay -S epr-git\n ```\n\n - Manually\n\n Clone this repo, tweak `epr.py` as much as you see fit, rename it to `epr`, make it executable and put it somewhere in `PATH`.\n\n## Checkout [`epy`](https://github.com/wustho/epy)!\n\nIt\u0027s just a fork of this `epr` with little more features:\n\n- Formats supported: epub, epub3, fb2, mobi, azw3, url.\n- Reading progress percentage\n- Bookmarks\n- Exte",
"github_repo": "wustho/epr",
"github_stars": 1390,
"github_topics": [
"cli",
"ebook",
"epub",
"epub-reader",
"epub3",
"python",
"python3",
"terminal"
],
"homepage": "https://github.com/wustho/epr",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 17,
"installs_365d": 340,
"installs_90d": 70,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": null,
"llm_model": null,
"name": "epr",
"oldnames": [],
"one_liner": null,
"optional_dependencies": [],
"rank_30d": 7253,
"rank_365d": 6010,
"rank_90d": 6456,
"raw_hash": "ec68f1d37c39e6fa",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/e/epr.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": "HEAD",
"version_stable": "2.4.15",
"versioned_formulae": [],
"why_use_this": null
}