https://github.com/erykjj/refractor
REFERENCE EXTRACTOR - scripture and publication reference parser
https://github.com/erykjj/refractor
parser publication-references scripture-references
Last synced: 26 days ago
JSON representation
REFERENCE EXTRACTOR - scripture and publication reference parser
- Host: GitHub
- URL: https://github.com/erykjj/refractor
- Owner: erykjj
- License: other
- Created: 2025-12-11T18:55:46.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-01-13T01:53:35.000Z (27 days ago)
- Last Synced: 2026-01-13T04:40:11.865Z (27 days ago)
- Topics: parser, publication-references, scripture-references
- Language: Nim
- Homepage:
- Size: 9.66 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 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 selected 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*](https://wol.jw.org)[^#], or a link to see your results directly.
## Downloads
- [Linux (x86_64)](https://github.com/erykjj/refractor/releases/latest/download/refractor_linux_x86_64.tgz)
- [Linux (ARM64)](https://github.com/erykjj/refractor/releases/latest/download/refractor_linux_arm64.tgz)
- [macOS (universal)](https://github.com/erykjj/refractor/releases/latest/download/refractor_macos.tar.gz)
- [Windows (amd64)](https://github.com/erykjj/refractor/releases/latest/download/refractor_windows_amd64.zip)
- [Windows (ARM64)](https://github.com/erykjj/refractor/releases/latest/download/refractor_windows_arm64.zip)
## Usage
```
Usage: {appName} [-h | -v | -l] | [-r] [-s] [--full | --standard | --official] -c:code
Options:
-h, --help Show this help message and exit
-v, --version Show the version and exit
-c:, --code= Language code or symbol (en by default)
-l, --list List supported languages
-r, --references Output publication references
-s, --scriptures Output scriptures (if neither -r nor -s
is provided, both shown)
Scripture (book names) rewrite options:
--full Use full name
--standard Use standard name
--official Use official name (default)
File to process (docx or text)
```
## Examples
Linux/macOS: `./refractor -c:S bosquejo.docx`
Windows: `refractor.exe -c:en talk_outline.txt`
____
[](https://github.com/erykjj/refractor/releases.atom)
By using this software you agree to abide by the terms of its [License](https://github.com/erykjj/refractor#License-1-ov-file).
Feel free to get in touch and post any [issues and/or suggestions](https://github.com/erykjj/refractor/issues).
____
#### Footnotes:
[^*]: For publications of Jehovah's Witnesses
[^#]: Copyright *Watch Tower Bible and Tract Society of Pennsylvania*