The Green Shoes Manual 1.1.362

Installing Green Shoes

Okay, on to installing Green Shoes. I'm sure you're wondering: do I need to install Ruby? Do I need to unzip anything? What commands do I need to type?

Yeah. You need to install Ruby and Gems. But, no need to worry about it. We'll talk through all the steps.

Step 1: Installing Green Shoes

At first, install Ruby. On Windows, visit the site of RubyInstaller for Windows to download the latest RubyInstaller 1.9.2 or 1.9.3.

Then just do the following one line.

That's all. Too easy?

Note: green_shoes gem is on If you get some errors of rdoc, try to add --no-ri --no-rdoc option.

Step 2: Start a New Text File

Shoes programs are just plain text files ending with a .rb extension.

Here are a few ways to create a blank text file:

Now, in your blank window, type in the following:

 require 'green_shoes' do
   para "Welcome to Shoes"

Save to your desktop as welcome.rb.

Step 3: Run It! Go Shoes!

To run your program, just open console window and run the following.

So, not much of a program yet. But it's something! You've got the knack of it, at least!

What Can You Make With Shoes?

Well, you can make windowing applications. But Shoes is inspired by the web, so applications tend to use images and text layout rather than a lot of widgets. For example, Shoes doesn't come with tabbed controls or toolbars. Shoes is a tiny toolkit, remember?

Still, Shoes does have a few widgets like buttons and edit boxes. And many missing elements (like tabbed controls or toolbars) can be simulated with images.

Shoes is written in part thanks to a very good art engine called Cairo, which is used for drawing with shapes and colors. Also thanks to an awesome text lay out engine called Pango. In this way, Shoes is inspired by NodeBox and Processing, two very good languages for drawing animated graphics.

Next: The Rules of Green Shoes