Created: 2012-03-24 14:09
Updated: 2014-03-22 18:15
License: mit

VotD - (Bible) Verse of the Day

Build Status Code Climate

VotD (Verse of the Day) is a Ruby Gem that wraps various web services that generate daily Bible Verses.

Currently the gem supports three VotD web services:

Other services are are planned:

If you are able to contribute modules for any of these, please see our CONTRIBUTING file. Let us know before you begin work in case someone else has a module in-progress.


Add this line to your application's Gemfile:

gem 'votd'

And then execute:

$ bundle

Or install it yourself as:

$ gem install votd


To use VotD in your code:

require 'votd'

votd =

# or votd =

votd.reference   # Ephesians 2:8-9
votd.text        # For by grace you are saved through faith...        # 2012-03-24
votd.version     # NIV
votd.copyright   # Copyright © ...

NOTE: If there's an error encountered while accessing the VotD service a default verse of John 3:16 in the KVJ is returned. This ensures that something is returned no matter what.

Outputting HTML

You can use the built-in formatted HTML:


Which by default looks like the following:

<p class="votd-text">For by grace you are saved through faith... it is not from works, so that no one can boast.</p>
<span class="votd-reference"><strong>Ephesians 2:8-9</strong></span>
<span class="votd-version"><em>(NETBible)</em></span>

You can then use the provided CSS classes to style the VotD.

You may also provide custom HTML text by using the .custom_html method with a block:

votd.custom_html do |votd|
  "<p>#{votd.reference} - #{votd.text} (#{votd.version})</p>"

votd.to_html now outputs:

<p>John 3:16 - For God so loved... (KJV)</p>

Outputting Text

You can use the built-in formatted Text:


Which by default looks like the following:

For God so loved the world, that he gave his only begotten Son,
that whosoever believeth in him should not perish, but have
everlasting life. -- John 3:16 (KJV)

.to_text is also aliased to .to_s

You can provide custom Text formatting by using the .custom_text method with a block:

votd.custom_text do |votd|

Which outputs:

John 3:16|For God so loved...|(KJV)

This returns the custom formatted text, or you can call the .to_text method when ready, and your custom text will be output.

Command Line

For command-line usage see here


Documentation may be found here

Source Code

Source code is available in our GitHub repository.


To submit bug, feature requests, patches see our Issues List on GitHub.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Write passing tests/specs (we use RSpec)
  4. Commit your changes (git commit -am 'Added some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request



See our CHANGELOG file.


See our TODO file.


Christopher Clarke

Stephen Clarke

Sebastian Hirsch (ESV)


(The MIT License)

© 2012-2014 Christopher Clarke, Stephen Clarke. See LICENSE for details.

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more