Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
open-source word clouds for Processing
Java Processing CSS Ruby Perl

This branch is even with gh-pages

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.settings
_data
_layouts
_posts
assets
blog
example
gallery
ideExample
installing-wordcram
javadoc
javascripts
lib
src
stylesheets
test/wordcram
.classpath
.gitignore
.project
.ruby-gemset
.ruby-version
CNAME
Gemfile
Gemfile.lock
LICENSE
NOTICE
README.md
RELEASENOTES.txt
Rakefile
VERSION
_config.yml
build.json.example
favicon.ico
favicon.png
index.md
params.json
wordcram.png

README.md

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
WordCram

Make a Word Cloud

import wordcram.*;

// Set up the Processing sketch
size(1000, 600);
colorMode(HSB);
background(230);

// Make a wordcram from a random wikipedia page.
new WordCram(this)
  .fromWebPage("http://en.wikipedia.org/wiki/Special:Random")
  .withColors(color(30), color(110),
              color(random(255), 240, 200))
  .sizedByWeight(5, 120)
  .withFont("Copse")
  .drawAll();

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

Install

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 http://wordcram.org. 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.

Problems?

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.