Is there an Equipd URL Scheme?

There sure is!

Using URL Schemes it is possible to link external applications to Equipd.

Some basic examples of how you can use this:

• Take notes in the Apple "Notes" app and link scriptures directly to Equipd
• Type links into emails that can open scriptures or publications in Equipd
• Integrate Equipd with 3rd party apps like ReadingPlan for Daily Bible Reading Schedules
• Have a Bible Reading coming up? Insert the link to your reading in a Calendar Event!

• Alter EPUB files so that they open scriptures in Equipd
• Embed links in webpages (such as this page) that open a scripture directly in Equipd
• Developers of other apps can open scriptures from their app in Equipd
• Integrate Equipd with Launch Center Pro for your iPhone, and quickly open Today's Daily Text with one click.
  
  

There are a number of different URL Schemes that can be used, depending on what you are trying to do:

Open Scriptures in Equipd - Format 1

Format 1 is a very tightly structured url format. In most cases you should use the alternate format outlined in the next section.

equipd://bible/book/chapter/verses

This link is broken down into the following parts: 

1. equipd:// - The url shortcut that will open Equipd
2. bible - the module to open in Equipd
3. book - the abbreviated name of the book, or the book number - e.g. "2ti" or "2 Ti", or 55 are all valid. (see last heading on this page for full list of book abbreviations)
4. chapter - a single integer - e.g. 3 or 4 or 23 are all valid
5. verses - a comma-delimited list of verses to open - e.g. "3,4" or "15,16,17" or just "21" are all valid

Here are some examples of scripture links that would open from an email or webpage on a device running Equipd:

Open Scriptures in Equipd - Format 2

This format is the most flexible, and perhaps powerful, as it allows for the book name to be written multiple different ways, in full or abbreviated. It also allows for spanned verses instead of the verses having to be specified one at a time. For example "2 Timothy 3:14-16" will look up verses 14,15,16 (this did not work in the old format).

equipd://bible/scripture

This link is broken down into the following parts: 

1. equipd:// - The url shortcut that will open Equipd
2. bible - the module to open in Equipd
3. scripture - the scripture written out in multiple ways. 

Check out the examples below which show different formats that are supported for the scripture links - note that there are no spaces in the link anywhere.

Automatically Generate the Scripture URL

In version 2.4.0 a new feature was added that allows you to generate the URL scheme for a scripture by simply pressing a button. Just look up the scripture, and then hit the action button top/right in the Bible Tab, and press "Generate Scripture URL". This will format the URL for the current scripture you are reading, and insert the link into your clipboard ready to be pasted anywhere you want.

Opening Library Modules

Improved URL Scheme in Equipd 3.0+

equipd://library/?lang=LANG&pubtype=PUBTYPE&pubabbr=PUBABBR 

What about if you want to open a specific chapter in a publication? 

This is now supported as well using the URL of the chapter/article as found on WOL. In fact you can go find a chapter/article on WOL, and copy the address of the page and change the "http://" for "equipd://" and Equipd will do its best to work out the link and open the page for you.

Here are two examples of the link formats that support opening a specific page in a publication:

Bible Book Abbreviations

Here is a complete list of the Bible Book abbreviations as used by Equipd. You can use the book number or the book abbreviation in the scripture links passed to Equipd when using the "Format 1" url scheme outlined above.