YouVersion Public API Client. This project has no affiliation with YouVersion or Life.Church.
- API Documentation
- Client Documentation (coming soon!)
pip install youversion
A YouVersion API Developer Token will be needed. Information about obtaining an API token can be found in the YouVersion API documentation
import youversion as yv
import webbrowser
YV_TOKEN = 'YouVersion API Developer Token'
YV_LANG = yv.Language.English
api = yv.API(YV_TOKEN, YV_LANG)
print(api.bible_versions)
# Sets the Bible version (defaults to KJV)
api.bible_version = 'KJV'
# Or use the BibleVersion object
api.bible_version = api.get_bible_version('ASV')
# Gets the current verse of the day
votd = api.get_verse_of_the_day()
# Print the verse of the day verse text
print(votd.verse.text)
# Downloads the verse of the day image
votd.image.download()
# Open the verse of the day square image in a browser
webbrowser.open_new_tab(votd.image.square_url(size=256))Information about how to get setup for development and contribution is coming soon.