Imimot

Mitti Help - Cues

There are multiple ways to create Cues in Mitti. Video and Still Image Cues can be created by simply drag-n-dropping files from Finder to Mitti's Playlist view, while Syphon, Camera and NDI Cues types are only accessible from the File Menu. Once you created a Cue it will be added to the Playlist.

Cue Basics

User Interface

All Cues have the same general UI, with two state: collapsed and expanded. The default, collapsed state shows the Cue Type by an icon, the Collapse/Expand Toggle on the left, the Cue Number and the Cue Title.

The expanded state will show you the Cue In and Out Time, as well as the following Cue Options:

  1. Cue Preferences: orders front the Cue Preferences Window.
  2. Cue Title: by default, the title of a Cue represents it's source, so with a Movie Cue for example it will be show the filename, but you can set custom title for each Cue here.
  3. Video FX Toggle: you can toggle the Video FX of the Cue here if it is available.
  4. Audio Toggle: you can toggle the Audio Track of a Movie Cue here.
  5. Fade In: makes the Cue Fading In when its starts.
  6. Fade Out: makes the Cue Fading Out before it stops.
  7. Transition to Next Cue Toggle: enables/disables transition to the next Cue-.
  8. Pause at Beginning: playback will pause when reached the Cue's start point.
  9. Pause at End: playback will pause when reached the Cue's end point.
  10. Replace Cue Source: replace the file or the source of the Cue.
  11. Cue Loop: makes the Cue looping.

Defaults Cue Toggles & Playlist Defaults

You can also set the default state of common Cue Toggles - so the toggle-states defined here will be applied whenever you create a new Cue:

  • Audio On/Off
  • Fade In On/Off
  • Fade Out On/Off
  • Transition On/Off
  • Pause at Cue Beginning On/Off
  • Pause at Cue End On/Off
  • Loop On/Off

There is also an option to Make Playlist Settings Default - a newly created project will be use these settings as default.

Switching between Cues

Once you have multiple Cues, there will be always a current one. The Current Cue's Title and Cue Number will be drawn by blue, and the Playhead Slider will be attached to the Current Cue.

Usually you select a Cue and hit ENTER to play it, but of course you can use the Transport Controls and JUMP commands like double-click will work too, as described in the Getting Started section.

Reorder Cues

The reorder one or more Cue, select them, hold down the mouse button and drag them to the new location.

Selecting Cues

To select Cues, you can use the UP ARROW and DOWN ARROW keys, as well as your left mouse button. CMD and SHIFT can be use as modifiers just like in Finder.

Removing Cues

To remove one or more Cues, select them and hit CMD+DELETE.

Search for Cue Number

You can search for a Cue Number by typing numbers to the Playlist. Mitti will scroll to and select the cue with matching Cue Number.

Cue Preferences

Cue Preferences available by either from the Playlist menu for the Current Cue, or by clicking on the Preferences... icon on one of your Cues.

While some options are related to specific Cue types, most of them are common and available for almost all types of Cues. Here is a list of the most common options.

Movie In/Out Points

Video Cues have In/Out Time settings in Cue Preferences. In/Out Times are in the minutes:seconds.millisecs format, because they are absolute times. This means both In- and Out Times are always calculated from the beginning of the video, which is always zero.

For the Current Cue, In/Out Time can be also set from the Cue menu by the current playhead location.

Geometry Controls

This is where you can change the Aspect Ratio of a file with the corresponding Fit/Fill/Stretch options if needed, and also Scale and Position. Best to choose "Set from Video Output Setup" option to automatically determine the aspect ratio of your setup, especially if you are using a spanned output.

Color Controls

With Color Controls you can set the opacity, brightness, contrast and make changes on the red, green and blue channels too for the each Cue.

Transition to Next Cue

Mitti 1.1 added the possibility to make Transition to Next Cue by adding an option to toggle on/off for each - and any type of - Cue individually.

On enabling Transition to Next Cue on a Cue the next will be started earlier by the half amount of the transition duration to make overlapping possible. This means SMTPE start times will be recalculated from the Cue where you enabled this feature, so be aware of toggling transitions when Mitti is running in MTC/LTC slave mode.

Transitions between two Cues need to have the same rendering dimensions. If they are differ then Mitti will automatically resize during the transition render process and applies letterboxing if the aspect ratio differs too.

The Transition Time for individual Cues can be set independently in Cue Preferences.

By the default Transition is Dissolve, Mitti is coming over 30 different type of - GPU accelerated - Transition modules. Some of them has even parameters that can be controlled thru the UI or even by OSC.

Video Effects

Mitti supports the GPU-accelerated ISF video effect format, and bundled with more than 100 effects by default.

One video effect can be applied for each Cue, which you can select from the dropdown Effect: menu on the Video Effect section.

If you have an effect selected, you can toggle it on or off on the Cue's User Interface.

Once you have an effect selected, Mitti will build the user interface for it, making all the parameters accessible and controllable on the user interface or even by OSC.

Audio Output

Cues using the Output Routing what you set in Audio Output Preferences by default, but you can override this on a per-Cue basis in Cue Preferences.

This option is only available if your Cue contains and audio track.

Misc

On the Misc pane you can set a custom Cue Title for your Cue, and also a couple of information are listed related to your current Cue, like media format, codec, etc.

Here you can also set the Fade time of the Cue used for Fade In/Out.

Align to Next Minute or Hour

Still images, Syphon and NDI sources, so non-movie Cues have an option to automatically set their duration to be aligned to the Next Minute or Next Hour in their Source settings.

This feature is especially useful when you are using Mitti in LTC/MTC Timecode slave mode with Still Images - as a workaround - for setting the Start Time of Video Cues.

Video/Still Cues

Supported formats

Mitti can play files in any format supported by AVFoundation (the library used by Mitti for video decoding), listed in order of preference, for videos without transparency:

  • ProRes 422
  • HAP
  • HAP Q
  • PhotoJpeg
  • H.264

For videos with transparency:

  • ProRes 4444
  • HAP Alpha
  • HAP Q Alpha

For videos at 4K resolution and over, HAP could perform better than ProRes if you are outputting to external screens thru HDMI/DisplayPort/VGA/DVI. For more info about the GPU accelerated HAP codec family, please check out https://hap.video

With systems where an Apple AfterBurner card is present Mitti will leverage its power with hardware accelerated ProRes decoding, so this case ProRes is the best choice even with 4K resolution and over.

However, if you are only outputting to SDI (via BlackMagic Output) output, ProRes is the best choice of codec for you, since we need to send pixel data with the CPU instead of the GPU.

The list of supported codecs can be appended by a number of other common formats if you have Apple's Pro Video Formats Bundle installed.

Still Images are also supported in the most common formats, but we recommend PNG and JPG. Mitti can also render PDF files.

Transcode to ProRes/HAP

Got new and untested files last minute? No problem, you can transcode them to the recommended ProRes or HAP video codec from the Cue right-click menu. Audio tracks will remain untouched.

Transcoded files are added to the ~/Movies/Mitti/Transcoded folder with the ProRes or HAP suffix.

Camera Cues

Mitti's Camera cues will recognize input from:

  • Any Blackmagic DeckLink device (including DeckLink, UltraStudio, and Intensity devices)
  • Any UVC-complient USB Video Capture cards (Magewell, Inogeni, etc.)
  • iPhone / iPad running at least iOS 8 and connected by a Lightning cable
  • Any IIDC-compliant webcam

Once you created a Camera Cue, you can set it's source and change it's duration in the Cue Preferences window. Selecting a Blackmagic DeckLink device will add a new popup where you can select the format of the incoming video data.

Audio from devices currently does not supported.

Syphon Cues

Mitti supports incoming Syphon transmission from any Syphon enabled apps by Syphon Cues.

Once you created a Syphon Cue, you can set it's source and change it's duration in the Cue Preferences window.

NDI Cues

NDI™ by NewTek Inc., is a new technology for IP-based video production. With NDI Cues in Mitti, you can use any NDI output-enabled video application on the local network as sources.

Once you created a NDI Cue, you can set it's source and change it's duration in the Cue Preferences window.

Audio from NDI sources currently does not supported.

Audio Cues

Audio Cues works and can be created just like Video and Still Images Cues - except you can not apply Video Effects on them.

The following formats are supported:

  • wav
  • aif
  • mp3
  • m4a
  • flac (only on macOS 10.13 and higher)

Still stuck? How can we help?