Page Contents


Feature List

Previous topic


Next topic


This Page


This documentation is for OMERO 5.2. This version is now in maintenance mode and will only be updated in the event of critical bugs or security concerns. OMERO 5.3 is expected in the first quarter of 2017.

A short decription on how to create movies from OMERO.

Creating a movie from OMERO

OMERO provides a script to make Mpeg or Quicktime movies from any image in the server. These movies are created by a script called, this script has a number of options: these include: selecting a range of Z,T planes, the channels to display. The movie can also show information overlayed over the image: z-section, scale bar and timing.

The resulting movie will then be uploaded to the server by the script and become a file attachment to the source image.

Viewing the movie

The make movie script allows you to save the movie in two different formats, a DivX encoded AVI and Quicktime movie. To view the AVI you may need to install a divX codec from  DivX. It should be noted that the DivX avi is normally 1/3 to 1/10 the size of the Quicktime movie.

Installing the make movie script

The make movie script currently uses the mencoder utility to encode the movies, this command should be in the path of the computer (icegrid node) running the script.

You can find windows installs for mencoder at

We have Mac OSX installs for mencoder which were originally provided here. Unzip and put the mencoder in the PATH available to the server, e.g. /usr/local/bin/ . You may need to restart the server for this to take effect.

There are also macports, rpms and debs for mencoder.

Make movie also uses Pillow and numpy.

Make movie command arguments

A detailed list of the commands accepted by the script are:

  • imageId: This id of the image to create the movie from
  • output: The name of the output file, sans the extension
  • zStart: The starting z-section to create the movie from
  • zEnd: The final z-section
  • tStart: The starting timepoint to create the movie
  • tEnd: The final timepoint.
  • channels: The list of channels to use in the movie (index, from 0)
  • splitView: Should we show the split view in the movie (not available yet)
  • showTime: Show the average time of the aquisition of the channels in the frame.
  • showPlaneInfo: Show the time and z-section of the current frame.
  • fps: The number of frames per second of the movie
  • scalebar: The scalebar size in microns, if <=0 will not show scale bar.
  • format: The format of the movie to be created currently supports ‘video/mpeg’, ‘video/quicktime’
  • overlayColour: The colour of the overlays, scalebar, time, as int(RGB)
  • fileAnnotation: The fileAnnotation id of the uploaded movie. (return value from script)

Platform-specific notes


For Windows, you can download a “MPlayer-rtm-svm-<version>” bundle from You will need  7zip to open the bundle. Then you will need to add the directory containing “mencoder.exe” to your system path and restart.