Copyright 2014-2024 Caleb Evans
Code released under the MIT license

This repository consists of Bible language data gathered from the YouVersion website, for use by my Alfred workflow, Raycast extension, and my JavaScript library.

This project is not affiliated with YouVersion, and all Bible content is copyright of the respective publishers.

This tool also retrieves Bible metadata directly from YouVersion. However, please be aware that this functionality does not fully comply with YouVersion's Terms of Use.

Using the uv package manager:

uv sync

You can add support for a new language to the Bible dataset by running the add_language utility. Just supply an RFC 5646 language code as the only argument (supported YouVersion language codes can be found here), and the script will do the rest.

uv run -m utilities.add_language kud

You can explicitly set a default version for this Bible language file by passing the --default-version option. If you do not supply this option, the version with the lowest numeric ID will be used as the default version

# Versions from <https://www.bible.com/languages/tgl>
uv run -m utilities.add_language tgl --default-version 2195

You can fetch the latest Bible data for an existing language in this repository by running the update_language utility. Just supply the language code of a language in this repository's bible/languages.json.

uv run -m utilities.update_language spa_es

You can also change the default version for that language by supplying the --default-version option with the numeric ID of your new default version:

# Versions from <https://www.bible.com/languages/eng>
uv run -m utilities.update_language eng --default-version 59

You can fetch the latest Bible data for all language in this repository by running the update_languages utility.

uv run -m utilities.update_languages

To include this project's Bible data in another project, add youversion-suggest-data as a Git submodule to your consuming project's repository:

git submodule add https://github.com/caleb531/youversion-suggest-data.git

To update the submodule to the latest release of youversion-suggest-data:

git submodule update --recursive --remote