mocha Logo
developed by
imagineer systems
Home > Support > Documentation > Preferences


Preferences location

Preferences are accessed through File | Preferences on Windows or Linux and Application Menu | Preferences on Mac.

Output Settings

File Storage

The Output Directory settings specify the default location of the directory in which the project file and rendered clips are stored. There is a choice between:

Relative Path: The project directory is a subdirectory of the directory containing the original project clip. By default, the subdirectory is Results. If you often load your project clip over a network, it would be best not to choose Relative Path, because the performance of project and clip I/O will not be as fast as the local disk.

Absolute Path: The project directory as an absolute path. For the best performance choose a folder on a fast disk, with plenty of disk space available.

Disk Space Available

If Absolute Path is specified, the available space in the given disk drive.

Cache Directory

Specify here the folder to use for caching image data and storing auto-saved project files. For the best performance, choose a folder on a fast disk with plenty of disk space available. A lot of data is written out in the background while you work, approximately three times as much disk space as the taken up by the original clip will be used.

The Cache Original Clip box is selected by default. This will cache the original clip to the File Cache when a project is created or opened for a more efficient playback and workflow.

RAM Player

The Use Textures box is selected by default. This will use textures when rendering, so set Amount of Texture RAM to Reserve to the amount of memory that you want to be reserved for textures. This determines how many frames can be played back in real-time. A reasonable setting would be 3⁄4 of your graphics card’s memory.

Using textures will usually result in faster rendering, but may not work on all graphics cards. Textured rendering is not compatible with Microsoft Windows Remote Desktop Connection.



The Enable box is selected by default. This will automatically save the project you are working on. Set the interval between saves by increasing or decreasing the value in the Interval (minutes) box. The default is 5 minutes. If Save Images Every Frame is checked, rendered frames are saved to disk as soon as they are created in memory; otherwise the render to disk only occurs when rendering a sequence of frames.

UI Color

This decides the color of the user interface. You can choose if you prefer the user interface to be dark or light. If you choose to change from dark to light or vice versa, you will need to re-launch the application for the change to take place.

UI Look and Feel

This decides whether the user interface is displayed Full Screen or within a Window. If you are working with multiple applications, you may wish to set the UI Look to Window, as you cannot minimize the main window with Full Screen selected.

By default, the application uses Rotational Controls to change parameter values. You drag with the mouse or pen away from, and then around, the parameter being changed. For those users who prefer traditional linear controls, switch to Linear Controls, which change the value of a parameter by dragging a handle underneath the parameter edit box. If Invert Mouse Wheel is checked, dragging the mouse wheel down will move up the timeline or reduce the value of a chosen parameter, and vice versa.


The Maximum Size of the history is the number of user interactions stored in the undo/redo command list. The limit is used to conserve memory.

Track in mocha AE

Checking this option will allow you to load mocha V3 instead of the bundled version inside After Effects CS6+ when you click on "Track in mocha AE" from the After Effects animation menu.

Default Clip Settings

If you are working on a number of shots that share the same clip attributes (the same video standard, frame rate and colorspace), it can be useful to set a default clip setting. Then you will not have to re-enter the same clip information each time you load a clip.


This is the default file format for rendered clips, when the format is not transferred from an input clip. This should be a format that supports all internal pixel formats and types. Currently the choice is between DPX and TIFF.


Select Linear if your source clip is stored in linear color space, possibly with gamma applied. Select Log if your source clip is stored in log color space. Select Panalog if your clips originate from a Panavision Genesis camera, and are stored in the native Panalog format.

Convert to Float

Convert to Float causes imported clips to be generated internally as 32-bit float, increasing the precision of compositing operations but using more memory.


FPS - Choose a default clip speed in frames per second (FPS) from the pull-down menu. You can also select here whether to show Frames or Timecode for the frame numbers shown for the in/out points and current frame. Choose Timecode if you usually work with clips with DPX timecode or QuickTime clips containing timecodes. With the Frame Offset you can choose to apply a positive or negative offset value to each shot that you import should you wish to make the clip you are importing begin earlier or later by slipping the start point forwards or backwards.


Select the Frames button when importing a clip that is frame-based. This will usually be a film clip, CG clip or a graphic. Select the Separate Fields button if you normally use field-based clips. This will usually consist of a video clip with options for PAL (upper field first, also used for SECAM) or NTSC (lower field first) field ordering. Separate Fields will de-interlace the clip and display both fields. When a clip is rendered, the fields will automatically be interlaced back together again. There is also a 3:2 Pulldown option if you mainly work with 3:2 pulldown material.


Enable Error Logging

This is selected by default. The file generated is useful for Imagineer engineers to diagnose error messages and fix any problems. You can view the log by selecting View Log from the Help menu. You can also change the location of the Log File from its default.

Error Detection

This is set to Comprehensive by default. If you are working on a labor-intensive project, you can switch to Normal only logs errors as they occur, rather than constantly checking. This provides less information in the event of an error, but can marginally improve performance.

Key Shortcuts

Select a module from the pull-down menu to reveal a list of keyboard shortcuts for that module.

Directional keys

Select either "Nudge Points" or "Step frames" from the radio button options to choose which is controlled by your directional keys alone.  The unselected option will then be controlled by CMD/Ctrl + Direction rather than just the Directional keys by themselves.

Document Actions