Show HN: Lue – Terminal eBook Reader with Text-to-Speech

Summary

✨ Features Feature Description 📖 Multi-Format Support Support for EPUB, PDF, TXT, DOCX, DOC, HTML, RTF, and Markdown with seamless format detection 👄 Modular TTS System Edge TTS (default) and Kokoro TTS (local/offline) with extensible architecture for new models 🌌 Rich Terminal UI Clean, responsive interface with customizable color themes and full mouse & keyboard support 💾 Smart Persistence Automatic progress saving, state restoration, and cross-session continuity for seamless reading 🌍 Cross-Platform & Multilingual Full support for macOS, Linux, Windows with 100+ languages and consistent global experience ⚡️ Fast Navigation Intuitive shortcuts, flexible controls, and smooth scrolling for efficient book navigation 🚀 Quick Start Want to try Lue right away? Follow these simple steps: # 1. Install FFmpeg (required for audio processing) # macOS brew install ffmpeg # Ubuntu/Debian sudo apt install ffmpeg # Windows: Download from ffmpeg.org and add to PATH # 2. Clone and setup git clone https://github.com/superstarryeyes/lue.git cd lue pip install -r requirements.txt # 3. Start reading! python -m lue sample.txt 📝 Note: Quick start uses Edge TTS (requires internet). For offline capabilities, see full installation. 📦 Installation Prerequisites Core Requirements FFmpeg - Audio processing (required) Optional Dependencies espeak - Kokoro TTS support - Kokoro TTS support antiword - .doc file support macOS (Homebrew) brew install ffmpeg # Optional brew install espeak antiword sudo apt update && sudo apt install ffmpeg # Optional sudo apt install espeak antiword Windows Download FFmpeg from ffmpeg.org and add to PATH. Install Lue Standard Installation # 1. Clone repository git clone https://github.com/superstarryeyes/lue.git cd lue # 2. Install dependencies pip install -r requirements.txt # 3. Install Lue pip install . Enable Kokoro TTS (Optional) For local/offline TTS capabilities: # 1. Edit requirements.txt - uncomment Kokoro packages: kokoro > =0.9.4 soundfile > =0.13.1 huggi...