Distribute Ruby GUI apps easily.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


furoshiki Build Status

風呂敷 (Furoshiki) is a simple way to package your Ruby applications for distribution on Windows, Linux, and OSX. A 風呂敷 is “a type of traditional Japanese wrapping cloth that were frequently used to transport clothes, gifts, or other goods.”


This is all super alpha, and is subject to change at any time.

Packaging Shoes apps

For the moment, we only really package Shoes apps. See ALPHA WARNING above ;)

path = 'path/to/your/shoes-app' # See Furoshiki::Shoes::Configuration
config = Furoshiki::Shoes::Configuration.load(path)
packager = Furoshiki::Shoes.new(:swt, :app, config)

Or use the shoes4 command line interface:

bin/shoes -p swt:app path/to/your/shoes-app

Eventually, we will be able to package non-Shoes apps too.


The inspiriation for 風呂敷 came from Shoes. One of Shoes' best features is packaging up scripts made with Shoes into their own executables. You could take any little script and make a .app, .exe, or .run file. However, this code was really complicated, and made Shoes hard to maintain. It was often the source of people's problems when trying to build Shoes of their own. So, while working on Shoes 4, I decided to see if anyone else was doing anything similar. I came across the .app for libgosu, which was doing a similar thing. After emailing Julian, I decided that if this was useful for Shoes, and useful for libgosu, it'd probably be useful for other projects, too. So I've set out to figure out the Shoes packager, play with the libgosu versions, and come up with an easy way for you to bundle and distribute GUI programs written in Ruby.

Helping out with 風呂敷

It's easy! Just clone it down and do the usual bundler thing:

$ git clone https://github.com/shoes/furoshiki.git
$ cd furoshiki
$ gem install bundler
$ bundle


Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2010 Steve Klabnik. See LICENSE for details.