Omahub
← All plugins
B

Readest

by Bibek Bhusal

Search and open books from the Readest library with fuzzy ranking by title or author.

GitHub Homepage

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
7679949
Scanned
3 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
7679949
Reviewed
3 weeks ago

The plugin is a read-only QML overlay that lists books from the local Readest library and opens them with the readest command. The shell script only reads JSON and emits tab-delimited paths, with no destructive, network, or persistence behavior. No dangerous or malicious code was found.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/BibekBhusal0/omarchy-readest --enable
Productivity #launcher

Omarchy Shell Plugin for Readest

A beautiful Readest library search menu. Type to filter books by title or author with fuzzy ranking, and open one with Enter.

Readest preview

Features

  • Fuzzy search across your library by title or author, ranked by relevance
  • Open books directly in Readest

Requirements

  • Omarchy quattro
  • Readest
  • jq (preinstalled on Omarchy)

Install

omarchy plugin add https://github.com/BibekBhusal0/omarchy-readest.git --enable

Usage

Bind the menu to a key (~/.config/hypr/bindings.lua):

o.bind("SUPER", "R", "exec, omarchy-shell shell summon bibek.readest")

Type to filter, Enter opens the selected book in Readest, Escape closes. Move with Up/Down, Ctrl+K/Ctrl+J, or Ctrl+P/Ctrl+N, jump with PageUp/PageDown.

Configuration

The library is read from ~/.local/share/com.bilingify.readest/Readest/Books by default. Override it in ~/.config/omarchy/readest.json (watched live, so edits apply instantly):

{ "libraryPath": "/path/to/your/books" }

Uninstall

omarchy plugin remove bibek.readest

Credits

Fuzzy matching uses FuzzySearch.js, adapted from omarchy-raindrop-bookmarks by Trevor Ramey, licensed under the MIT License.

This plugin is licensed under the MIT License.

Others

Here are my other Omarchy plugins:

Please give a star if you find them useful!