Ruby 2D lets you create 2D applications with ease using Ruby, and run them just about anywhere.
Set up your environment and install dependencies
Before installing the gem, we’ll need to install a few dependencies, namely a native graphics engine Ruby 2D will use behind the scenes called Simple 2D.
On macOS, we recommend using Homebrew and running:
brew tap simple2d/tap brew install simple2d
On Linux, run the install script by pasting this snippet in your terminal:
url='https://raw.githubusercontent.com/simple2d/simple2d/master/bin/simple2d.sh'; which curl > /dev/null && cmd='curl -fsSL' || cmd='wget -qO -'; bash <($cmd $url) install
On Windows, learn how to set up your environment »
Install the gem
Now you’re ready to install the Ruby 2D gem:
gem install ruby2d
Writing your first 2D app
After installing the gem, create a new Ruby script called
app.rb and add the following two lines.
require 'ruby2d' show
This is the simplest Ruby 2D application you can write. The
require statement adds the Ruby 2D domain-specific language and classes, and the
show method tells Ruby 2D to show the empty window. Let’s make this window more interesting by giving it a name and adding a shape. We’ll use the
set method to change the title of the window and add a colorful triangle.
require 'ruby2d' set title: "Hello Triangle" Triangle.new( x1: 320, y1: 50, x2: 540, y2: 430, x3: 100, y3: 430, color: ['red', 'green', 'blue'] ) show
Great! Now save your script and run it on the command line using:
You should see this impressive triangle…
Congrats, you just built your first Ruby 2D app! 🎉
Building natively and for the web
On macOS, we recommend using Homebrew to install MRuby:
brew install mruby
On Linux, install MRuby and its development files using
sudo apt install mruby libmruby-dev
With MRuby installed, using the “Hello Triangle” script you wrote above, run the following to build a native and web-based version of the app:
ruby2d build app.rb
build/ directory was created containing an executable named either
app on Unix-like systems, or
app.exe on Windows. There’s also an HTML file named
The executable is a compiled, native version of your app. It can run on any system, similar to the one you built it on, without the need for the full Ruby interpreter to be present. Let’s try running the native app on the command line:
# Enter the `build/` directory cd build # Run on Unix-like systems ./app # Run on Windows app.exe
app.html file contains a
<script> tag linking to the
app.js file containing the code for your application. When you open the HTML file in a web browser, the script will run, the
<canvas> element will be created (your window), and the triangle will appear. Try opening the HTML file by simply double clicking it.
Whether you run your script using the Ruby interpreter, build and run it natively, or build it for the web, the results will all be the same.
Ready to learn more? Explore the documentation to discover everything Ruby 2D can do.