refractor

Commandline/terminal reference extractor utility that finds scriptures and publication references¹. Works with both text files and .docx (MS Word) documents. Multiple languages are supported.

Publication references are only parsed within () and [].

Scripture references only include the ones with verses (not whole chapters or books), and they will be "cleaned up" (rewritten in official format):

II Chronicles 2:3 --> 2Ch 2:3
1-Cor 1:11 --> 1Co 1:11
1st Peter 1:1 --> 1Pe 1:1
1.John 5:3 --> 1Jo 5:3

You will get a list that you can paste into the search box on Watchtower ONLINE LIBRARY², or a link to see your results directly.

Downloads

• Linux (x86_64)

• Linux (ARM64)

• macOS (universal)

• Windows (amd64)

• Windows (ARM64)

Usage

 Usage: refractor [-h | -v | -l] | [-r] [-s] -c:code <infile>

 Options:
   -h, --help                      Show this help message and exit
   -v, --version                   Show the version and exit

   -c:<code>, --code=<code>        Language code (en by default)
   -l, --list                      List supported languages

   -r, --references                Output publication references
   -s, --scriptures                Output scriptures (if neither -r or
                                     -s is provided, both are enabled)

 <infile>                          File to process (docx or text)

Examples

Linux/macOS: ./refractor -c:es bosquejo.docx

Windows: refractor.exe -c:en talk_outline.txt

---

By using this software you agree to abide by the terms of its License.

Feel free to get in touch and post any issues and/or suggestions.

---

Footnotes:

Footnotes

1. For publications of Jehovah's Witnesses ↩

2. Copyright Watch Tower Bible and Tract Society of Pennsylvania ↩