RMagick Download Page

RMagick is an interface between the Ruby programming language and the ImageMagick® and GraphicsMagick image processing libraries.

Thumbnails are just the start! Check out the RMagick portfolio. The first page shows some basic transformations. Page 2 demonstrates special effects. Page 3 illustrates the drawing API.

There are two versions of RMagick, RMagick 1 and RMagick 2. Most people will want to install RMagick 2. This version works with Ruby 1.8.5 and later (including Ruby 1.9) and ImageMagick 6.3.5 and later. All new enhancements to RMagick will be in RMagick 2. RMagick 2 does not work with GraphicsMagick.

RMagick 1 works with Ruby 1.6.7 and later^*, all versions of GraphicsMagick and ImageMagick 6.0.0 and later. RMagick 1 does not support any features added to ImageMagick 6.3.0 and later and does not work with Ruby 1.9. RMagick 1 is fully supported. As of this writing there have been 14 bug fix releases. I plan to continue to supply bug fixes as necessary.

RMagick comes with comprehensive documentation in HTML format. The documentation for your version of RMagick is installed on your system along with the RMagick software. If you are using RMagick on another system such as a web hosting service you can read the documentation online at one of these locations.

**RMagick Version Feature Table**
Feature	RMagick 1	RMagick 2
Works with Ruby < 1.8.5^*	Yes	No
Works with ImageMagick 6.0.0-6.2.9	Yes	No
Works with GraphicsMagick	Yes	No
Fully supported	Yes	Yes
Works with ImageMagick 6.3.5 and later	Yes	Yes
Available as a Windows RubyGem?	No	Yes
Gets new features	No	Yes
Works with Ruby 1.9	No	Yes
Supports new ImageMagick features	No	Yes

The documentation at these locations may not be for the same version of RMagick that you are using. Thanks to the good folks at Simple Systems and ImageMagick Studio LLC for providing the web space.

You can use RMagick on Linux, FreeBSD, OS X and other *nix-like systems such as Solaris and Cygwin. You can also use RMagick on Windows XP and Vista. RMagick works with Ruby 1.8. If you do not have Ruby, you can get it from www.ruby-lang.org. You must have ImageMagick 6.0.0 or later, or GraphicsMagick 1.0 or later. (I recommend ImageMagick 6.3.0 or later, or GraphicsMagick 1.1.) You only need one of ImageMagick or GraphicsMagick. RMagick works equally well with either. See below for links to the ImageMagick and GraphicsMagick download sites.

Look here for short, in-depth articles about RMagick. New ones will be added from time-to-time.

These fine books include information about using RMagick. Find them at your favorite bookstore.

My name is Tim Hunter. Please use the RMagick project at RubyForge to ask questions, report bugs, or just to let me know you're using RMagick! You can also email me at

rmagick
  at rubyforge dot org

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

	The Ruby Way, Second Edition (Addison-Wesley) Hal Fulton's classic book includes an overview of RMagick.		Ruby Cookbook (O'Reilly) Check out Antonio Cangiano's excellent RMagick recipes.
	Rails Cookbook (O'Reilly) Rob Orsini's guide includes a "Graphics" chapter that shows how to use RMagick in Rails applications.		The Definitive Guide to ImageMagick (Apress) Michael Still devotes an entire chapter to RMagick.
	Practical Ruby Gems (Apress) David Berube shows how to create thumbnails with RMagick, one one of 29 "practical" Ruby Gems explained in his book.		Beginning Google Maps Applications with Rails and Ajax: From Novice to Professional (Apress) Andre Lewis shows how to use RMagick to create custom overlays to use with the Google Maps API.

	Ruby+ImageMagick ® Ruby+GraphicsMagick
Graphics Processing for Ruby and Ruby on Rails