Open JW.ORG shared links in JW Library app for Apple Silicon macs

1 minute read

Updated 2022-01-30. About the new JW Library Sign Language version 4.5.

Starting with JW Library 12.2 October 2020 and the JW Library Sign Language version 4.5 January 2022, you can share a link to a specific paragraph or verse right from the JW Library app or JW Library Sign Language app. Those universal links1 may look like this www.jw.org/finder?.

Only on Android, you can open those dynamic links directly in the JW Library app and the JW Library Sign Language app, natively.

What if you want to do the same with JW Library apps on an Apple Silicon mac? A third-party app named Finicky2 will help you.

After installing the app3, create a file called .finicky.js in your home directory with the configuration below if you want to open the universal links of 103 sign languages in JW Library Sign Language app and the rest in JW Library (an excellent work of vbastianpc)

module.exports = {
  defaultBrowser: "Safari",
  handlers: [
    {
      // regex match all signs languages
      match: /^https:\/\/www\.jw\.org\/finder\?[\w=&]*wtlocale=(SMS|LSA|BVL|SCH|LSC|SCR|SEC|LSM|LSP|LSS|SGL|TTS|LSU|LSV|LSE|ALS|DGS|ASL|LAS|ARS|AUS|OGS|BUS|WSL|LSB|BSL|BRS|BLS|CBL|SLS|CRS|CSE|CSL|CGS|KSL|LSI|HZJ|CBS|DSL|HSL|LSQ|VSL|SZJ|STD|ESL|FSL|FID|FJS|VGT|LSF|SBF|GHS|GSL|LSG|NGT|SHO|HDF|INS|INI|ISG|QSL|ISL|JML|JSL|KSI|LSL|LBS|LTS|BIM|MSL|TTM|MLS|MTS|MNS|MSR|SLM|SLN|NZS|NSL|LSN|NNS|NDF|PSL|SPE|PDF|LGP|RWS|LMG|RSL|SBS|SWS|SAS|SSL|SGS|SSU|SIL|TSL|TZL|TKL|USL|SLV|ZAS|ZSL)[\w=&]*$/,
      browser: "org.jw.jwlibrary.signlanguage"
    },
    {
      // match all others
      match: "https://www.jw.org/finder*",
      browser: "org.jw.jwlibrary"
    },
}

Whenever you open a www.jw.org/finder?link from Telegram, iMessage, Notes, AirDrop… (not a browser app), one of two JW Library apps will be called and show the content for you.


  1. It’s called Android App Links (https://developer.android.com/training/app-links) or iOS Universal Links (https://developer.apple.com/ios/universal-links/) 

  2. A free, open-source, and built-for Apple Silicon app. You can download it from https://github.com/johnste/finicky. 

  3. One way is: brew install --cask finicky