Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Installing on Windows

matthutchinson edited this page · 9 revisions


Note: This guide is not for cygwin, and assumes you have installed Ruby via the one-click installer. These steps are known to work with Windows 7 and 8 (x86 32-bit) and (x64 64-bit).


First, please ensure you have git installed and working. The git command should be available in your command prompt. Type git --version to check the version.


There are many ways to install Ruby on Windows. To get up and running quickly we recommend the one-click installer. Download and run the installer following the prompts to complete the installation. Close and then re-open your command prompt and type ruby -v to check the install worked OK.

Ruby Development Kit

After installing Ruby, you'll need the Ruby Development Kit. This provides extra libraries and modules necessary for installing some Ruby gems with C bindings. We'll need this for the Rmagick Ruby gem (a dependency of lolcommits).

  1. Grab the Ruby Development Kit from here
  2. Unpack it somewhere (e.g. C:\RubyDevKit)
  3. Open a command prompt and cd to this directory
  4. Run ruby dk.rb init to prepare the install
  5. Run ruby dk.rb review to review the install
  6. Run ruby dk.rb install to complete the install

For more information or troubleshooting see


  1. Download ImageMagick from here e.g. ImageMagick-6.8.0-3-Q16-windows-dll.exe. NOTE: At the time of writing this older version of ImageMagick is known to work with the latest Rmagick gem on Windows. Ymmv with newer or different versions of ImageMagick and the Rmagick gem.
  2. Install to a specific path without spaces. e.g. C:\ImageMagick
  3. Make sure Add application directory to your system path and Install development headers and libraries for C and C++ are checked like so; ImageMagick installation
  4. Close and reopen your command prompt to reload your PATH variables (you can run PATH or convert -v to ensure ImageMagick is there)


Run the following command. Replace the location of ImageMagick on your system if you opted for something different above:

gem install rmagick --platform=ruby -- --with-opt-dir=C:\ImageMagick

If you run into any issues, copy your error and Google around.


Woo, that's it! All the prerequisites have been taken care of. Now all you need to do is install lolcommits and enable it in your own git repo.

gem install lolcommits
cd C:\your_repo
lolcommits --enable
Something went wrong with that request. Please try again.