Omahub
← All plugins
H

Catholic Reference

by Hugh Whelan

A Chi-Rho bar widget with the Douay-Rheims Bible (with Catena Aurea commentary), the Catechism of the Catholic Church, Catholic prayers, daily Mass readings, and the Liturgy of the Hours.

GitHub

Security review

Potentially dangerous behavior detected · 1 finding

Deterministic scan — not a security guarantee

High
Risk level
High
Analyzed commit
ff5714a
Scanned
1 week ago
  • high destructive_filesystem data/catechism.json:4232

    Low-level disk manipulation or write command.

    parted from you.\" If it is true that no one can save himself, it is also true that God \"desires all men to be saved\" (*1 Tim* 2:4), and that for him \"all things are possible\" (*Mt* 19:26).\n"

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
ff5714a
Reviewed
1 week ago

The plugin is a benign Catholic reference widget that bundles public-domain texts and runs a local Node helper for search and readings. The deterministic scan's high-risk finding is a false positive: the flagged snippet is just Bible text containing the word 'parted', not a disk command. No obfuscation, persistence, credential theft, or destructive operations were found.

  • The plugin fetches daily Mass readings from universalis.com over HTTPS)Skip; this is a minor privacy consideration but is clearly documented and cached locally.
  • The Node helper is invoked with user-controlled search queries, but it only reads bundled data files and does not execute shell commands, so injection risk is minimal.
  • The plugin requires `node` and `wl-clipboard` as external dependencies; if missing, it may fail gracefully but could be a usability issue.
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/whelanh/omarchy-catholic-reference --enable
Widgets #bar #quickshell

Catholic Reference for Omarchy

An Omarchy Quattro bar widget with a theme-colored Chi-Rho icon and a five-tab panel: fuzzy search of the Douay-Rheims Bible (with Catena Aurea commentary), the Catechism of the Catholic Church, common Catholic prayers, the daily Mass readings, and a bundled Liturgy of the Hours.

Plugin id: io.github.whelanh.catholic-reference

What it does

  • Bible tab — search the full 73-book Douay-Rheims (Challoner) text by word, phrase, or reference. Search is fuzzy: type god so loved and John 3:16 comes back without needing the exact wording. Book names work as you type them: Mat lists the chapters of Matthew, Mat 4 shows the whole chapter, Mat 4:23 the verse, and Mat 4:23-25 a range. A short prefix like Jo offers every book it could mean; select a book or chapter to open it. Click a result to copy it and pin it with Catena Aurea commentary (Thomas Aquinas' Golden Chain, on the four Gospels); the random chip does the same for a random passage. Esc or Back returns to the results.
  • Catechism tab — fuzzy search all 2865 paragraphs of the Catechism of the Catholic Church. Click a paragraph to copy it with its CCC number.
  • Prayers tab — the bundled data/prayers.json (Our Father, Hail Mary, Glory Be, the Apostles' Creed, and more) in English and Latin.
  • Readings tab — today's Mass readings (First Reading, Responsorial Psalm, Second Reading, Gospel Acclamation, Gospel) with the liturgical colour and the Lectionary cycle (Year A/B/C and Weekday I/II). Fetched from universalis.com and cached locally for offline reuse.
  • Hours tab — the office for Morning, Daytime, Evening, and Night Prayer. The current hour is highlighted and selected by default; the liturgical day (General Roman Calendar, approximated) is shown above the text.
  • Browse — with nothing typed, the Bible tab opens on the Old and New Testaments by division (Pentateuch, Historical Books, Wisdom Books, the Prophets; Gospels, Acts, Letters of St. Paul, Catholic Letters, Revelation), and the Catechism tab on its Prologue and four Parts down to each Article, with paragraph numbers. Open a chapter or section to read it as running text; ‹ › step to the next one. In a chapter, click a verse number for its card and Catena Aurea commentary; in the Catechism, click a paragraph number to copy it, or a cross-reference to follow it.
  • Pop out — the header's Pop out button moves the reader into a resizable window with room for longer passages. Closing the window returns it to the bar popup. Scriptable too: qs ipc -p /usr/share/omarchy/shell call io.github.whelanh.catholic-reference window.

Everything runs offline except the Readings tab, which makes one request to universalis.com the first time it is opened each day and then reads a local cache. The Collect is not shown: it is not available from the free sources.

Install

omarchy plugin add https://github.com/whelanh/omarchy-catholic-reference.git --enable
omarchy bar move io.github.whelanh.catholic-reference --section right

Requires node (the search/readings helper bin/omarchy-catholic is a Node script) and wl-clipboard for copying results. The Readings tab needs network access; everything else is fully offline.

Usage

  • Left click the Chi-Rho in the bar to open or close the panel.
  • Bible / Catechism tabs: type to search (fuzzy, debounced). ↑/↓ move the cursor, Enter copies the selected result, Esc returns focus from the search field, then Esc closes the panel. In the Bible tab, Enter or a click pins the verse with commentary; Esc/Back returns to the list.
  • Prayers tab: click a prayer to read it in English and Latin.
  • Readings tab: today's Mass readings load automatically; click Refresh to force a re-fetch.
  • Hours tab: click Morning / Daytime / Evening / Night to read that hour's office. Scroll to see the full text.
  • Tab / Shift+Tab switches to the neighbouring bar panel.

Data and privacy

  • The Douay-Rheims Bible is public domain; the search index is data/bible.tsv.
  • The Catena Aurea commentary (four Gospels) is bundled, gzip-compressed, as data/catena.json.gz; it is public domain.
  • The Catechism is bundled as data/catechism.json.
  • The office (psalms, canticles, readings, collects) is bundled as data/office.json.
  • Prayers are bundled as data/prayers.json.
  • Mass readings are fetched from universalis.com and cached under ~/.local/state/omarchy/catholic-reference/ (one request per day).
  • Does not request elevated privileges, runs no background services, and starts no second Quickshell process.

Regenerating the data

The bundled data can be rebuilt from the upstream sources:

node tools/build-data.mjs path/to/DRC.json      # writes data/bible.tsv + data/books.json
node tools/build-office.mjs path/to/DRC.json    # writes data/office.json
node tools/build-catena.mjs path/to/catena.xml  # writes data/catena.json.gz

DRC.json is the formats/json/DRC.json file from the scrollmapper/bible_databases repository. catena.xml is the OSIS source from lemtom/catena. See NOTICE.md for sources and licensing.

Development checks

omarchy plugin validate .
node tests/model.test.js
node tests/search.test.js
node tests/reader.test.js
node --check bin/omarchy-catholic
qmllint -I "$OMARCHY_PATH/shell" BarWidget.qml Panel.qml Service.qml ChiRho.qml

Remove

omarchy plugin remove io.github.whelanh.catholic-reference

Contributors

Hugh Whelan — project author and maintainer.

Demian Neidetcher — Browse the Bible and Catechism by outline and read them as running text(#5).

License

Plugin code is MIT licensed. See LICENSE. Data sources are covered in NOTICE.md.