tim-hub_obsidian-bible-reference/README.md at master

obsidian-plugin/tim-hub_obsidian-bible-reference

mirror of https://github.com/tim-hub/obsidian-bible-reference.git synced 2026-07-22 06:00:26 +00:00

tim-hub f58529e767 chore: persist verse cache debug logging, add Matt Pocock skills, ignore tooling

Squashes in-progress local work: [verseCache] debug logs in the cache
path, .agents/.claude skill definitions with skills-lock.json, and
.gitignore/.stignore updates.

Claude-Session: https://claude.ai/code/session_01HvA9UdGcEyNyysyRVKKmmN

2026-07-15 10:00:13 +12:00

16 KiB

Raw Permalink Blame History

Obsidian Bible Reference

Simplify your Bible Study note-taking experience with the user-friendly Obsidian.md notes app.
Experience the seamless assistance of automated Bible Verse suggestions for effortless referencing.

These contributions will be highly appreciated in supporting the development of the project. 👍

👉 Star the Project

☕️ Buy me a coffee @Github Sponsor

❤️ Provide Feedback in Issues or join Discussion

About

How to use

Open a note in Obsidian.md application
In a note, for example type --John1:1
Select the suggestion

Type --John1:a to insert all verses in a chapter (a = the whole chapter).

You can also get a "verse of the day" by typing --vod.

Polish translations are available as well, including UBG (Uwspółcześniona Biblia Gdańska) and BG (Biblia gdańska).

Read more about How to use

On iOS devices, there is a known issue about conflict between Smart Punctuation and double hyphens --.

To make it work,

you can use ++ instead of -- in the beginning of the verse reference => ++John1:1 (recommended)

or you can turn Smart Punctuation off => How to use

Contribution and Credits 🙏

All different kinds of contributions are welcome, see: How to Contribute
Credits: Bible API/Data Source Providers

Sponsors and Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Chris Gonzales} 💵 🤔	_{Jeremy Treis} 💻 🐛 🤔	_{minermaniac447} 💻	_{Brennen Puth} 💻 🤔	_{Joey Kilgore} 💻	_{Ben Vanderhoff} 📖	_{Bill Chen} 💻
_GScriptS 💻 🌍	_{Aaron Friedel} 💻	_benjayahari 🌍	_George 🌍	_Nathan 💻	_{Karl Fischer} 🌍	_OfirSinn 🌍
_{Pavel Diatchenko} 💻	_{Joshua Stoll} 💻 🌍	_blankton2 🌍	_abbasou 💻	_AlphaHasher 💻 🌍	_{jonathanvanschenck} 💻	_{Adam W} 🌍 💻
_Redster1 🐛	_{David Bergan} 💵	_{Benedictteo05} 💻	_{José Soares} 💻	_{Willi Richert} 💻	_cabbott008 💻	_zenibako 💻
_{Michael Marvive} 💻	_{Jonathan Fisher} 💻	_{Hanjo Kim} 💻

Special thanks for the sponsors

Bible Vector Search To search Bible verses in meaning not in keywords. This is another open source project I built recently to implement AI Embedding and Vector Search for Bible verses (in BBE translation).

Packages in this Monorepo

This repository is a Bun workspace monorepo. The repository root doubles as the installable Obsidian plugin folder (manifest.json, versions.json, styles.css, and the built main.js live at the root), while all source lives under packages/:

obsidian-bible-reference — the Obsidian plugin source (this README documents it). Its build emits main.js to the repository root.
bible-reference-toolkit — Normalize Bible references, convert them to machine-readable formats, query and manipulate them.
bible-book-names-intl — Bible book names in multiple languages (the source used to resolve non-English book names).

Development

bun install          # install all workspace deps
bun run build        # build the plugin (main.js -> repo root)
bun run dev          # watch build
bun test             # run all package tests
bun run lint         # lint the plugin package

16 KiB Raw Permalink Blame History Unescape Escape