# Install bookokrat with Homebrew

Terminal EPUB Book Reader. Version 0.3.12 via Homebrew; verified 2026-06-06.

## Install

```sh
sudo av install brew:bookokrat
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bookokrat
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:bookokrat
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/bookokrat>
- **Version:** 0.3.12
- **Source summary:** Terminal EPUB Book Reader
- **Homepage:** <https://bugzmanov.github.io/bookokrat/index.html>
- **Repository:** <https://github.com/bugzmanov/bookokrat>
- **Upstream docs:** <https://bugzmanov.github.io/bookokrat/index.html>
- **License:** AGPL-3.0-or-later
- **Source archive:** <https://github.com/bugzmanov/bookokrat/archive/refs/tags/v0.3.12.tar.gz>
- **Last updated:** 2026-06-06T20:41:53Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- bookokrat (cli)
- bookokrat (alias)

## Build dependencies

- pkgconf
- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.3.12
- Package-manager updated: 2026-06-06
- Local data: ok
- Upstream repository: https://github.com/bugzmanov/bookokrat
- Upstream latest detected: v0.3.12 (current)
## Project history and usage

Bookokrat is a terminal ebook reader for EPUB and PDF, with a keyboard-heavy TUI, library discovery, reading progress, bookmarks, search, annotations, and PDF rendering features.

### Project history

The Git history begins in March 2025 with a basic EPUB reader TUI. The README later presents Bookokrat as a feature-rich terminal reader rather than a minimal pager, including Calibre library detection, table-of-contents navigation, PDF support, annotations, SyncTeX support, and Vim-style controls.

### Adoption history

Bookokrat is a young package with Homebrew packaging in the input metadata and an upstream GitHub Pages documentation site. Its adoption is likely among terminal-first readers, developers reading technical PDFs, and users who want ebook navigation without leaving a console workflow.

### How it is used

The documented interface emphasizes keyboard operation: library and reader panes, chapter navigation, search, marks, comments, theme selection, reading history, and PDF controls. Configuration is stored under the user's Bookokrat config directory with separate files for settings and keybindings.

### Why package nerds care

Bookokrat is notable as part of the modern terminal-app revival: it packages an experience that used to be GUI-only, but with rich TUI conventions and configuration files. For package indexes, it is a reminder that terminal productivity tools now include media-like workflows such as ebooks and PDFs.

### Timeline

- 2025-03-27: Initial commit for a basic EPUB reader with TUI.
- 2025-10-28: v0.1.0 tag appears.
- 2025-12-13: v0.2.0 tag appears.
- 2026-03-07: v0.3.7 tag appears.
- 2026-06-06: v0.3.12 tag appears.
- 2026-06-25: Recent repository commits show ongoing tweaks after v0.3.12.

### Related projects

- Calibre is related through the documented library detection feature.
- EPUB, PDF, and DjVu are related document formats in the package tags and documentation.
- VimTeX is related through the documented SyncTeX/editor integration workflow.

### Sources

- current_curation.config-file-location
- <https://bugzmanov.github.io/bookokrat/index.html>
- <https://github.com/bugzmanov/bookokrat/blob/main/readme.txt>
- <https://github.com/bugzmanov/bookokrat/releases>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for bookokrat. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/bookokrat/config.yaml, ~/.config/bookokrat/keybindings.toml
- Windows: %APPDATA%\bookokrat\config.yaml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bookokrat
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [bk](https://www.automicvault.com/pkg/brew/bk/) - Shares av.db curated category or tags: cli, epub, productivity, terminal.
- [fancy-cat](https://www.automicvault.com/pkg/brew/fancy-cat/) - Shares av.db curated category or tags: cli, pdf, productivity, terminal.
- [gnome-papers](https://www.automicvault.com/pkg/brew/gnome-papers/) - Shares av.db curated category or tags: cli, djvu, pdf, productivity.
- [abook](https://www.automicvault.com/pkg/brew/abook/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [aerc](https://www.automicvault.com/pkg/brew/aerc/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [alot](https://www.automicvault.com/pkg/brew/alot/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [alpine](https://www.automicvault.com/pkg/brew/alpine/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [amp](https://www.automicvault.com/pkg/brew/amp/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [lue-reader](https://www.automicvault.com/pkg/brew/lue-reader/) - Both packages work with overlapping file formats or content types. Shared terms: cli, ebook, ebook-reader, epub, pdf.

## Combined YAML source

View the package source record on GitHub. [combined/bookokrat.yml](https://github.com/automic-vault/db/blob/main/combined/bookokrat.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
