Skip to content
open-source word clouds for Processing http://wordcram.org
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 Auto-add `void endDraw()` to each gallery skech, to save its output.
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
README.md README.md: Update Wikipedia example to use HTTPS
RELEASENOTES.txt Add #42 bug fix to Release notes
Rakefile Auto-add `void endDraw()` to each gallery skech, to save its output.
VERSION Bump version to 1.0.0
build.json.example Make a build.json.example for peeps who want to build WordCram
library.properties Add library.properties. Hope I got it right!
wordcram.png javadoc: added overview.html and wordcram.png; added some javadoc com…

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("https://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.