On this page

Use mplay --help to display the list of options.

Profiles

  • -default

  • -tools

  • -render

  • -flipbook

  • -viewer

  • -full

  • -minimal

Image options

-g

Group the command line images into separate sequences, based on base name and extension.

-u

Leave the images in the command line unsorted (in the order they appear).

-Z pad

Load only images that are padded to pad digits (or 0 for non-padded images only).

-D

Load fractional frames: assume . is a decimal if it appears in filenames to the left of the frame number.

-n

Disable negative frames: assume - is a separator, not a negative symbol, when it appears in filenames to the left of the frame number.

-z level

Load images zoomed to a certain percentage, where level is 12, 25, 33, 50, 66, 75 or 100.

-v

Flip all images vertically.

-B file

Set the background image(s). This will automatically enable transparency and background images.

-c

Load RGB color components only (no alpha).

-U

Use an unlimited amount of memory for images.

-m N

Limit memory usage to N MB.

-w width

Images loaded from STDIN are width pixels wide.

-h height

Images loaded from STDIN are height pixels high.

-x aspect

Sets the pixel aspect ratio.

-X on|off

Enable or disable stretching to account for pixel ratio.

-S n

Load n images from STDIN in RGBA format.

-O startframe step

Load images from STDIN starting at startframe and skipping step frames.

-L lutfile

Sets lutfile as the lookup table for Cineon images.

-l w g iw

Sets the Cineon white point to w, the film gamma to g and the image white point iw.

-N

Leave Cineon files in their natural 10 bit log space.

-d lutfile

Set the display LUT to lutfile.

-i lutfile

Set the inspect LUT to lutfile.

-8

Always load images at 8-bit depth.

-G gamma

Sets the display gamma. For example, -G 2.2.

-j x1 y1 x2 y2

Select a sub-region of the image to load, using fractional values between 0 and 1. For example, -j 0.25 0.25 0.75 0.75 to load the center region.

-J x1 y1 x2 y2

Select a sub-region of the image to load, using pixels. For example, -J 20 10 320 200.

-E leftimg rightimg

Load two images as a stereo image pair.

-E file1 file2

Loads stereo image pairs. The first file specified should be the left image, and the second should be the right image.

Playback Options

-C

Pre-cache all images at startup.

-f start end step

Sets the frame range (start to end) and frame step.

-p

Startup in playback mode.

-P mode

Sets the playback mode to 'loop', 'once' or 'zigzag'.

-r fps

Set the frames per second for realtime play.

-R

Turn on realtime play without specifying a rate.

-M mode

How to deal with missing frames, where mode is one of:

black

Show a black frame.

prev

Show the previous frame.

next

Show the next frame.

close

Show the closest available frame.

UI Options

-b s|d

Startup in single (s) or double (d) buffer mode. Single buffer provides faster playback speed (default).

-F

Full image view mode; do not show any extra UI.

-H

Disable tool tips.

-K

Tell MPlay to listen on a socket for input images.

-k

Tell MPlay to listen on a socket for flipbook images. Images rendered to the ip device will be displayed.

-T

MPlay window stays on top (on Windows).

-V x y

Sets the viewport layout to x columns by y rows.

-e c|s|h|v|b|d [val]

Enables diffing with the mode set to:

c

Compare

s

Subtract

h

Split horizontal (split at val, default 0.5)

v

Split vertical (split at val, default 0.5)

b

Blend (by val amount, default 0.5)

d

Highlight differences (uses val, default 0)

Audio Options

-a file

Load audio from file.

-A volume

Sets the volume scale (default 1).

-o fr sec

Aligns the animation frame fr to sec audio seconds.

-s on|off

Enable or disable the audio scrub sustain.

-W rate

Sets the audio scrub rate.

MPlay viewer

Basics

Audio

Reference

Advanced