Skip to content

Correct-Syntax/bible_side

Repository files navigation

Bibleside

Bibleside is an offline Bible app featuring the OET (Open English Translation).

The OET (Open English Translation) is a new, open-licensed Bible translation (currently in draft state) featuring multiple versions intended to be used together. Please see the OET website for more info on what makes it different than other translations.

Bibleside implements the OET's "Reader's" version in the main area and a toggle to show the "Literal" and "Reader's" versions side-by-side. The two can be scrolled together for easy comparison.

Try the app

Bibleside is currently in closed testing on Google Play. Click here to become a tester and provide early alpha version feedback. The same alpha version of the Bibleside app can also be found on F-droid if you prefer.

Bible versions

  • Open English Translation Readers Version
  • Open English Translation Literal Version
  • King James Version
  • King James Version with Strongs numbering
  • WEB (World English Bible)

Others?

Known issues/TODO

  • Bug: Scrolling between the two versions is synced too well? Since the Literal version is lengthier, verses can be in different locations or even off screen.
  • Some sections are missing or have misplaced starting points (fix in update_OET_sections.py)

Feedback/contributing

Feedback and contributions are welcome. To help out please open an issue.

Development

Bibleside is built with Flutter using Stacked Architecture.

  • Run flutter pub get to install the dependencies.
  • Choose an emulator or a connected device.
  • Hit F5 to run the code in the emulator, or open a terminal and run with flutter run.

Note on Bible versions

Bible versions are treated as separate Bibles. e.g: The OET-RV and OET-LV are treated as a separate bible version.

OET file conversion

There is a Python script in /assets/bibles that will automatically update the json files from the GitHub sources.

The ESFM files from here (OET Reader's version) and here (OET Literal version) are run through usfm-grammar in relaxed mode for conversion to JSON.

Navigate to /assets/bibles and run the file with python update_OET_json.py.

Updating the OET sections

After converting the OET ESFM to json, navigate to the folder with cd assets/bibles and run python update_OET_sections.py. This will generate two dart files mapping the OET sections for use in Bibleside. Move back to the root folder with cd ../.. and run dart format ./lib -l 120 to format the file.

License

Bibleside is licensed under the GPL-3.0 license. See LICENSE for more information.