# Install lue-reader with Homebrew, Nix Terminal eBook reader with text-to-speech and multi-format support. Version 0.4.0 via Homebrew; verified 2026-06-27. ## Install ```sh sudo av install brew:lue-reader ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install lue-reader ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#lue ``` Evidence: nixpkgs package indexes: pkgs/by-name/lu/lue/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:lue-reader - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.4.0 - **Source summary:** Terminal eBook reader with text-to-speech and multi-format support - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-only - **Source archive:** - **Last updated:** 2026-06-27T15:38:04Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - lue (cli) - lue (alias) ## Dependencies - certifi - ffmpeg - pymupdf - python@3.14 ## Uses from macOS - libxml2 - libxslt ## 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.4.0 - Package-manager updated: 2026-06-27 - Local data: ok - Upstream repository: https://github.com/superstarryeyes/lue - info: No cached GitHub release or tag data was available. ## Project history and usage Lue is a terminal ebook reader with text-to-speech, supporting formats such as EPUB, PDF, DOCX, HTML, RTF, TXT, and Markdown. ### Project history The project appeared publicly on GitHub in August 2025. Its README presents Lue as a Python terminal reader focused on synchronized listening and reading, with Edge TTS as the default online voice backend and Kokoro TTS as an optional local/offline path. ### Adoption history Lue is a young project, but it had hundreds of GitHub stars by mid-2026 and official installation instructions for PyPI, Homebrew, Debian/Ubuntu prerequisites, Arch AUR, and Windows via WSL. Homebrew packages it as `lue-reader` while the command exposed to users is `lue`. ### How it is used The quick start tells users to install FFmpeg, install `lue-reader`, run `lue --guide`, and open a book path such as `lue path/to/your/book.epub`. The README also documents navigation modes, highlighting, TTS voice configuration, and customization through files in the installed Python package. ### Why package nerds care Lue is interesting to package maintainers because it combines terminal UI behavior, document parsing, audio generation, and optional TTS backends. That mix makes system dependencies such as FFmpeg and optional speech tooling part of the packaging story, not just Python metadata. ### Timeline - 2025: Public GitHub repository created. - 2025: v0.1.x releases published, followed by v0.2 and v0.3 releases. - 2025: v0.4.0 published in December. - 2026: Homebrew formula available as `lue-reader`. ### Related projects - The README documents Edge TTS and Kokoro TTS as speech backends. - FFmpeg is listed as a core requirement for audio processing. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for lue-reader. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** lue-reader - **Version Scheme:** 0 - **Revision:** 6 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - lue: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/lu/lue/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## 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. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Runtime dependency declared by Homebrew. - [pymupdf](https://www.automicvault.com/pkg/brew/pymupdf/) - Runtime dependency declared by Homebrew. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [epr](https://www.automicvault.com/pkg/brew/epr/) - Shares av.db curated category or tags: cli, ebook-reader, epub, media, terminal. - [aalib](https://www.automicvault.com/pkg/brew/aalib/) - Shares av.db curated category or tags: cli, media, terminal. - [agg](https://www.automicvault.com/pkg/brew/agg/) - Shares av.db curated category or tags: cli, media, terminal. - [aview](https://www.automicvault.com/pkg/brew/aview/) - Shares av.db curated category or tags: cli, media, terminal. - [cairo](https://www.automicvault.com/pkg/brew/cairo/) - Shares av.db curated category or tags: cli, media, pdf. - [catimg](https://www.automicvault.com/pkg/brew/catimg/) - Shares av.db curated category or tags: cli, media, terminal. - [cava](https://www.automicvault.com/pkg/brew/cava/) - Shares av.db curated category or tags: cli, media, terminal. - [ccm](https://www.automicvault.com/pkg/brew/ccm/) - Shares av.db curated category or tags: cli, media, terminal. - [pocket-tts](https://www.automicvault.com/pkg/brew/pocket-tts/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, media, python, python-3-14. - [standardebooks](https://www.automicvault.com/pkg/brew/standardebooks/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, ebook, epub, media. ## Combined YAML source View the package source record on GitHub. [combined/lue-reader.yml](https://github.com/automic-vault/db/blob/main/combined/lue-reader.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph