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.