OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Audio & Voice AI

Lue

Lue is a Python-based terminal ebook and document reader that pairs multilingual text-to-speech with synchronized word highlighting, auto-scrolling, chapter navigation and persistent reading progress.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Lue — OpenViST project profile in Audio & Voice AI.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Lue when you want to read and listen to a supported ebook or document in a terminal, especially when synchronized highlighting and saved progress are useful.

Who it is for

  • Readers who want spoken narration while following text in a terminal.
  • People working with EPUB, PDF, DOCX, HTML, RTF, TXT or Markdown files.
  • Readers who want chapter navigation and progress retained between sessions.

Documented uses

  • Listen to a document while its spoken words are highlighted on screen.
  • Navigate a book by chapter and resume from saved reading progress.
  • Adjust narration voice and speed, or configure the optional Kokoro local/offline TTS path.
Before you choose

Requirements & limits

The repository documents installation through PyPI or from source. The default Edge TTS requires internet access; Kokoro is described as an optional local/offline option. Windows use is documented via WSL.

  • FFmpeg is required for audio processing.
  • Edge TTS is the default and requires internet; Kokoro requires additional setup and packages.
  • The Windows installation path uses WSL.
  • The interface is terminal-based, with keyboard and mouse support described in the project documentation.
  • The repository identifies the software as GPL-3.0 licensed.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Install Lue and open a book on macOS or Linux

Set up the documented PyPI quick start and launch a book with the default Edge TTS option.

Before you start

  • macOS or Linux
  • FFmpeg installed for audio processing
  • Internet connection for the default Edge TTS

Steps

  1. Install FFmpeg using the package method for your system: brew install ffmpeg on macOS or sudo apt install ffmpeg on Ubuntu/Debian.

  2. Install Lue with the command below.

    Documented command
    pip install lue-reader

  3. Run lue --guide to practice the navigation keys.

  4. Open a file with lue path/to/your/book.epub, substituting the path to your book.

Expected outcome

Lue opens the specified book for terminal reading with the default text-to-speech option.

Guide limitations

  • The quick start uses Edge TTS and requires internet access.
  • The listed package commands are for macOS and Ubuntu/Debian; the repository documents a separate installation path for Windows via WSL.
Documentation 1 ↗
Source-based practical guide

Set up Lue for local Kokoro text-to-speech

Configure the optional Kokoro TTS dependencies described for offline narration.

Before you start

  • A standard Lue installation
  • FFmpeg
  • espeak for Kokoro TTS support
  • PyTorch

Steps

  1. Edit requirements.txt and uncomment the listed Kokoro packages: kokoro, soundfile and huggingface-hub.

  2. Install PyTorch using the documented CPU command or the CUDA 12.1 package index command.

  3. Install the updated requirements with the command below.

    Documented command
    pip install -r requirements.txt

  4. Install Lue with the command below.

    Documented command
    pip install .

Expected outcome

The installation is configured with the optional Kokoro TTS dependencies; the repository documents Kokoro as its local/offline option.

Guide limitations

  • This setup requires modifying requirements.txt and installing additional packages.
  • The repository lists espeak as an optional dependency for Kokoro support.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
6 November 2026
Original website title
paulilaaso/lue · Official homepage title · retained in its source language
How we review sourcesSuggest a correction