XIPHOS-NAV(1)

πŸ’… xiphos-nav(1) β€” the Xiphos Utilities glow-up

okay so bestie, welcome to xiphos-nav from the Xiphos Utilities fam β€” this is the little command that makes your Bible app move when you click a link, and honestly? iconic behavior. πŸŽ€


✨ NAME ✨

xiphos-nav β€” navigating Xiphos to a verse reference, but make it effortless πŸ¦‹


✨ SYNOPSIS ✨

xiphos-nav URL

that's it. one argument. we love a low-maintenance queen. πŸ‘‘


✨ DESCRIPTION ✨

xiphos-nav is a command line utility that induces Xiphos to react to a URL request, and it does this using dbus. ngl "induces" is such a dramatic word for it but fr fr that's what the page says. πŸ’…

you invoke it like this, for example:

xiphos-nav sword://ESV/Gen.1.1

the normal use case β€” the main character energy scenario β€” is that it's your desktop environment's handler for sword:// URLs. so like, you set it up once and then it just handles things for you. obsessed.

here's the vibe check on what happens: if the dbus access attempt fails, it concludes that Xiphos is not running and starts a new Xiphos with that URL. no cap, that's the whole trick. 🧚

with this, you can click URLs of that sort in web pages and so forth, and Xiphos will be navigated for you. literally just click and go. 🌸

also β€” and this is the part people forget β€” the dbus interface also supports a search interface, used by bibledit. so it's not only about jumping to verses, iykyk. ⭐


✨ BUGS ✨

found a bug? don't suffer in silence bestie 😭 please report bugs online at:

https://github.com/crosswire/xiphos/issues

✨ AUTHOR ✨

xiphos-nav was written by the Xiphos Developer Team. 🫢

<xiphos-devel@crosswire.org>

πŸ’– cute little sign-off: this is xiphos-nav version 4.5.0, dated Feb 2020, and that's the whole page β€” slay, you read it all. πŸ”₯πŸ‘‘
πŸ“¦ where this page comes from