Skip to content
A library for accessing Adobe's Kuler service
Latest commit d66577b Mar 29, 2010 @bleything rdoc tweaks
Failed to load latest commit information.
lib better docs Mar 29, 2010
test add Kuler::Swatch Mar 29, 2010
.gitignore ignore rcov artifacts Mar 29, 2010
CHANGELOG.rdoc rdoc tweaks Mar 29, 2010
LICENSE rdoc tweaks Mar 30, 2010
Manifest.txt update Manifest.txt Mar 29, 2010
README.rdoc rdoc tweaks Mar 30, 2010
Rakefile add dependencies to the rakefile Mar 29, 2010




Kuler is a fun little webapp that allows you to discover, explore, and share color themes. This is a Ruby library to access the Kuler service.

To use Kuler, you'll need an API key, which you can obtain from Adobe at


  • retrieve color themes from Kuler:

    • most recent themes

    • most popular

    • highest rated

    • random


Set up a new Kuler instance with your API key:

kuler = 'your api key' )

# ... or ...

kuler =
kuler.api_key = 'your api key'

… then, grab a random color theme:

theme = kuler.fetch_random_theme

… and inspect the color theme:

=> [ "#ff0000", "#00ff00", "#0000ff", "#ffff00", "#ff00ff" ]

For more, check out the rdoc.


For users:

* nokogiri

For developers:

* hoe
* hoe-doofus
* hoe-git
* mocha


  • gem install kuler


kuler is copyright © 2010 Ben Bleything, and distributed under the terms of the MIT license. See the LICENSE file for details.

Something went wrong with that request. Please try again.