Omahub
← All plugins
S

Bible Verse of the Day

by stevehnh

Shows a daily Bible verse in the bar, fetched from bible-api.com, with a popup for the full text.

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
62fb06c
Scanned
1 month ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs external_hosts README.md:24

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/stevehnh/omarchy-bible-verse-plugin \

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

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

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
62fb06c
Reviewed
1 month ago

This plugin fetches a daily Bible verse from bible-api.com and displays it in the bar. It uses curl for network requests and writes a cache file. No malicious behavior detected.

  • Makes a network request to a third-party API (bible-api.com), which is expected and documented.
  • Writes a cache file to ~/.local/state/omarchy/, but only for caching verse data.
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/SteveHNH/omarchy-bible-verse-plugin --enable
Widgets #bar #quickshell #system

Bible Verse of the Day

Bible Verse of the Day popup

An Omarchy (Quattro shell) bar-widget plugin that shows a daily Bible verse. A book icon sits in the bar; clicking it opens a popup with the day's reference, translation, and full verse text.

The verse rotates once per day (day-of-year indexed into a curated list of ~180 references bundled with the plugin) and its text is fetched from the free, keyless bible-api.com API. The result is cached locally so the widget only hits the network once per day, not on every shell restart.

Installation

omarchy plugin add https://github.com/stevehnh/omarchy-bible-verse-plugin --enable

Or clone manually into your user plugins directory:

git clone https://github.com/stevehnh/omarchy-bible-verse-plugin \
  ~/.config/omarchy/plugins/io.github.stevehnh.bible-verse-of-the-day
omarchy plugin enable io.github.stevehnh.bible-verse-of-the-day

Usage

  • Left-click the bar icon: toggle the popup with today's verse.
  • Middle-click: force a refresh (ignores the daily cache).
  • Right-click: send today's verse as a desktop notification.
  • With the popup open: Esc closes it, r refreshes, Tab/Shift+Tab switches to the neighboring bar panel.

Configuration

The plugin has one setting, translation — any bible-api.com translation code (web, kjv, bbe, webbe, oeb-us, ...). It defaults to web (World English Bible, public domain). Set it either through the plugin's settings form in the Omarchy settings panel, or directly in ~/.config/omarchy/shell.json next to the plugin's bar entry:

{ "id": "io.github.stevehnh.bible-verse-of-the-day", "translation": "kjv" }

Changing the translation triggers an immediate refetch. To move the widget to a different bar section:

omarchy bar move io.github.stevehnh.bible-verse-of-the-day --section left

Removal

omarchy plugin disable io.github.stevehnh.bible-verse-of-the-day
omarchy plugin remove io.github.stevehnh.bible-verse-of-the-day

This only removes the plugin's own directory under ~/.config/omarchy/plugins/ and its entry in shell.json's bar layout; it does not touch any other Omarchy configuration. Its cache file at ~/.local/state/omarchy/bible-verse-of-the-day.json can be deleted manually if you want to clear it too.

Dependencies

  • Omarchy Quattro's shell plugin system (omarchy-shell).
  • curl, invoked as a subprocess to fetch verse text.
  • Network access to bible-api.com (no API key required). If unreachable, the popup shows the last cached verse (if any) with an error note.

License

MIT — see LICENSE.