Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Ruby wrapper for the QuickTime C API.
C Ruby Smalltalk
Latest commit b9ec264 @ryanb releasing 0.1.6



Open, edit, and export QuickTime movies all within Ruby! This is an unofficial wrapper around Apple's QuickTime C API. Mac OS X required.


Install the gem:

gem install rmov

And then load it in your project:

require 'rmov'

32 vs 64 Bit

Snow Leopard introduces a push towards 64 bit, and by default Ruby will run in 64 bit. Unfortunately the QuickTime C API will not be moving to 64 bit (see ). Therefore RMov 0.1.6 and later will always be installed under 32 bit.

This means You will not be able to use this gem while running the default 64 bit Ruby. Instead you will need to run Ruby in 32 bit mode. You can do so with this command.

arch -i386 ruby path/to/script.rb


There are many methods for editing, compositing, and exporting movies. Here are some examples.


movie1 ="path/to/")
movie2 ="path/to/")

# add movie2 to the end of movie1

# make a new movie out of a section of movie 1
# this will delete 5 seconds out of the movie at 2 seconds in
movie3 = movie1.clip_section(2, 5)

# You can insert that part back into the movie at 8 seconds in
movie1.insert_movie(movie3, 8)


movie ="path/to/")
watermark_movie ="path/to/watermark.png")

# add watermark track onto the entire length of the movie
movie.composite_movie(watermark_movie, 0, movie.duration)

# grab the watermark track
watermark = movie.video_tracks.last

# enable the alpha transparency of the png

# make the watermark half the size
watermark.scale(0.5, 0.5)

# offset into lower left corner
watermark.translate(10, movie.height - watermark.height - 10)


Usually exporting is done through a user interface the first time. The settings can then be saved to a file. After that you can load these settings without interfering the user with the dialog again.

exporter = movie.exporter

# if we already have saved the settings, load those
if File.exist? ""
  # otherwise open the QuickTime GUI settings dialog

  # save settings to a file so we don't have to bother user next time

# export the movie to a file and report the progress along the way
exporter.export("") do |progress|
  percent = (progress*100).round
  puts "#{percent}% complete"


See QuickTime::Movie and QuickTime::Track in the RDoc for more information.


This project can be found on github at the following URL.

If you find a bug, please send me a message on GitHub.

If you would like to contribute to this project, please fork the repository and send me a pull request.

Something went wrong with that request. Please try again.