install

Additional install commands

macOS

Homebrewverified · 100%

brew install lue-reader

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#lue

nixpkgs package indexes · pkgs/by-name/lu/lue/package.nix · source: api.github.com

overview

Package summary

Terminal eBook reader with text-to-speech and multi-format support

Project links

Commands and aliases

lue

history

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 posture

No protected-tool coverage found yet

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.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Installs with 4 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

Command	Kind	Exposure	Note
`lue`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version0.4.0

manager updated2026-06-27

local dataok

upstreamnot checked

latest detectednot detected

https://github.com/superstarryeyes/lue

infoNo cached GitHub release or tag data was available.https://github.com/superstarryeyes/luenone confidence

install metadata

Package metadata

Package key	brew:lue-reader
Version	0.4.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/lue-reader
Homepage	https://github.com/superstarryeyes/lue
Repository	https://github.com/superstarryeyes/lue
Upstream docs	https://github.com/superstarryeyes/lue#readme
License	GPL-3.0-only
Source archive	https://files.pythonhosted.org/packages/a0/02/492383eb53224831f2f5ccbbc3f7aca9ba051b89e7df03233d3c41856ec3/lue_reader-0.4.0.tar.gz
Last updated	2026-06-27T15:38:04Z
Pulse	updated
Dependencies	certifi, ffmpeg, pymupdf, python@3.14
Uses from macOS	libxml2, libxslt
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	lue-reader
Version Scheme	0
Revision	6
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix92%

lue

nix profile install nixpkgs#lue

installed executable or alias match
Matched by: Lue

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/lu/lue/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/lue-reader.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install lue-reader with Homebrew, Nix