Lector
Qt based ebook reader
Install / Use
/learn @BasioMeusPuga/LectorREADME
Qt based ebook reader
Currently supports:
- epub
- djvu
- fb2
- mobi
- azw / azw3 / azw4
- cbr / cbz
- md
Contribute
Bitcoin: 17jaxj26vFJNqQ2hEVerbBV5fpTusfqFro
Requirements
Needed
| Package | Version tested | | --- | --- | | Python | 3.6 | | PyQt5 | 5.10.1 | | python-lxml | 4.3.0 | | python-beautifulsoup4 | 4.6.0 | | python-xmltodict | 0.11.0 |
Optional
| Package | Version tested | Required for | | --- | --- | --- | | python-pymupdf | 1.14.5 | PDF support | | python-djvulibre | 0.8.4 | DjVu support | | python-markdown | 3.0.1 | Markdown support | | textile | 3.0.4 | TXT support |
Support
When reporting issues:
- Make sure you're at the latest commit.
- Run with
$EXECUTABLEPATH debug. - Include the log
~/.local/share/Lector/Lector.logAND terminal output. - If you're having trouble with a book while the rest of the application / other books work, please link to a copy of the book itself.
- If nothing is working, please make sure the requirements mentioned above are all installed, and are at least at the version mentioned.
Installation
Manual
-
Install dependencies - I recommend using your package manager for this.
-
Clone repository
-
Type the following in the root directory:
$ python setup.py build # python setup.py install -
OR launch with
lector/__main__.py
Available packages
Translations
- There is a
SAMPLE.tsfile here. Open it inQt Linguist. - Pick the language you wish to translate to.
- Translate relevant strings.
- Try to resist the urge to include profanity.
- Save the file as
Lector_<language>and send it to me, preferably as a pull request.
Please keep the translations short. There's only so much space for UI elements.
Screenshots
Main window

Table view

Book reading view

Distraction free view

Annotation support

Comic reading view

Bookmark support

View profiles

Metadata editor

In program dictionary

Settings window

Attributions
License
Lector is released under the GNU General Public License v3.0 or any later version. See the LICENSE file for details.
Related Skills
node-connect
352.2kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
claude-opus-4-5-migration
111.1kMigrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5
frontend-design
111.1kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
model-usage
352.2kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
