🍺 BREW Explorer

← all formulae

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

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![Screenshot](https://raw.githubusercontent.com/wustho/epr/master/screenshot.png)\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
}