Path: README.rdoc
Last Update: Tue Sep 15 14:19:14 -0700 2009


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.