Created: 2008-12-24 03:36
Updated: 2017-03-02 16:21
License: mit


This is Address Book. Address Book is a web application for managing your personal address book. It manages phone numbers, birthdays, addresses, and more.


git clone git://
cd addressbook
gem install bundler
bundle install

cp config/database.yml.template config/database.yml
# configure your database

cp config/application_config.yml.template config/application_config.yml
# configure the application

bundle exec rake db:migrate


Addressbook consists of 4 main sections:


Search allows you to search for contacts by full or partial last name.


Contacts is used to manage your, you guessed it, contacts. The contacts sections allows you to view and edit all information for a given contact.


Addresses is used to manage the addresses of your contacts. Each address has an address type (Individual, Family, Married Couple, Unmarried Couple, etc). The address type is used to determine the "addressee" of the address. For example, if Joe Smith and Jane Smith share an address, the addressee would be the following for the specific address types:

"Individual" - "Mr. Joe Smith"
"Family" - "Mr. & Mrs. Joe & Jane Smith & Family"
"Married Couple" - "Mr. & Mrs. Joe & Jane Smith"
"Unmarried Couple" - "Mr. Joe Smith & Ms. Jane Smith"
"Single Parent" - "Mr. Joe Smith & Family"

The home phone is also stored along with the address, since home phones are specific to a home.

You can specify the two main contacts for an address by selecting the primary and secondary contact on the address details page. These contacts are used in constructing the addressee (see above).


Groups provide a way to organize your contacts. Each group has a name, and a list of members. Members can be added via the "Maintain Group Members" link. After clicking "Maintain Group Members", you can add/remove one or more addresses to/from the group.

Once you have members in your group, you can create a printable PDF file of mailing labels for the members in your group. Simply specify the type of labels you will be using, and click the "Create Labels" link.

When printing the labels, be sure your PDF viewer is set to respect the margins in the document, and not to "center the document in the page" or perform any other types of margin alterations.

Other Features

  • Mobile optimized index and contact details pages
  • Authentication using HTTP Basic Auth


MIT License. See LICENCE for details.


John Wood

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