Skip to content


Subversion checkout URL

You can clone with
Download ZIP
open-source word clouds for Processing
Java HTML Processing Ruby
Failed to load latest commit information.
.settings backported from java1.6 to java1.5 - should run on 1.5 JVMs now
example Update Wikipedia example sketch to use HTTPS.
ideExample Strip out ASL copyright headers. The LICENSE file should suffice.
javadoc Updating javadoc for 0.5.7 release.
lib update the .jars for Processing 3
src Performance tweak: break after finding a colliding word.
test/wordcram Strip out ASL copyright headers. The LICENSE file should suffice.
.classpath Remove .svn excludes from .classpath, since we're off .svn
.gitignore Add example/gallery, and a Rake task to include them in jekyll.
.project Initial Commit
.ruby-gemset Switch from .rvmrc to .ruby-version
.ruby-version bump ruby version for build tools
Gemfile For #15, move downloads from github to Amazon S3
Gemfile.lock Upgrade ruby version to 2.1.2, and bundle install
LICENSE Initial Commit
NOTICE Update copyright NOTICE Update Wikipedia example to use HTTPS
RELEASENOTES.txt Add #42 bug fix to Release notes
Rakefile Remove a print statement from Raketask#import_the_gallery
VERSION Bump version to 1.0.0
build.json.example Make a build.json.example for peeps who want to build WordCram
wordcram.png javadoc: added overview.html and wordcram.png; added some javadoc com…

WordCram lets you generate word clouds in Processing. It does the heavy lifting -- text analysis, collision detection -- for you, so you can focus on making your word clouds as beautiful, as revealing, or as silly as you like.

Word Cloud by

Make a Word Cloud

import wordcram.*;

// Set up the Processing sketch
size(1000, 600);

// Make a wordcram from a random wikipedia page.
new WordCram(this)
  .withColors(color(30), color(110),
              color(random(255), 240, 200))
  .sizedByWeight(5, 120)

You can control where words appear, what angle they're at, their font, their color, and how they're sized.


Installing WordCram is simple, like any standard Processing library.

How do I use this thing? Show me examples!

You can check out the tutorials and examples at You can watch WordCram in action, on OpenProcessing: popular baby names, and the U.S. Constitution.

But the best way to see WordCram in action is to install it, and look at the examples under File > Examples > Contributed Libraries > WordCram.


If you're running into problems, see the FAQ, or read the javadocs.

If a question has you stumped, and the FAQ is no help, send me a note. My email account is 'wordcram', and I use gmail.

Want a better WordCram?

WordCram is open-source under the Apache 2 license. That means you can help make it better! I try to keep the source clean so it's easy to find your way around. There's a laundry list of things to do, and it's easy to build WordCram from source.

Something went wrong with that request. Please try again.