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 can be set in Preferences... - Playlist.

The expanded state will show you the Cue In and Out Time or the TRT, depending of what you set in the View... menu, as well as the following Cue Options:

  1. Replace Cue Source: replace the file or rebuilding the Source menu of the Cue Inspector.
  2. Audio Toggle: you can toggle the Audio of the Cue.
  3. Pause at Beginning: playback will pause when reached the Cue's start point.
  4. Fade In: makes the Cue Fading In when its starts.
  5. Cue Loop: makes the Cue looping.
  6. Transition to Next Cue Toggle: enables/disables transition to the next Cue.
  7. Fade Out: makes the Cue Fading Out before it stops.
  8. Pause at End: playback will pause when reached the Cue's end point.
  9. Goto: if this is enabled, Mitti will jump to the selected Cue instead of the next one in the playlist.

Defaults Cue Toggles in Playlist Preferences

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.

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.

Right-Click menu

Right-clicking on one or more Cues will popup a contextual menu where you can access various options, start transcoding, etc.

Search for Cue ID

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

Cue Preferences

You can access the Cue Preferences from the Cue Inspector on the right-side. The tabs can be collapsed and expanded just like 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.

General

In the General section you will find the following options:

  • Name: the name of a Cue is the filename by default. You can change it here.
  • Cue ID: Cues have a maximum 6 characters long ID. By default, this ID is their index in the playlist. You can use this ID in OSC messages, as well as with on-screen search.
  • Color Tags: there are 5 built-in background colors you can choose to group you Cues, either from the here or from the right-click menu. If you click on the Color Tag icon on a Cue's left side, it will select all Cues with the same Color Tag.
  • Notes: you can write memos.
  • In/Out: you can specify the Cue In/Out points here, but you can also modify these by dragging the throttles on the Playhead View.
  • Play Count for Looping: now you can select how many times you want to the Cue to Play looped. If this is not infinite, Mitti allows you to turn on Transition, Goto and Pause at End, which will be processed on the last loop.
  • Goto: you can specify a Cue here, where Mitti should jump when it is played out.

Below of these settings, you will find the Media Info - codecs, duration, framerate, dimension and location.

Geometry Controls

This is where you can set what Mitti should do when the media dimension does not match to the output rendering dimension (Canvas) - Fit/Fill/Stretch/Unscaled are your options.

You can also Rotate, Scale, Position or Crop your Cue here.

Color Controls

With Color Controls you can set the opacity, brightness, contrast, HSV for the each Cue.

Audio Output

You can set the Volume here for each Cue.

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

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

Transition & Fade

You can set the transition type Mitti should use when you are switching to this Cue, as well as the transition and fade duration.

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
  • H.264
  • HEVC (H.264)
  • HAP
  • HAP Q

For videos with transparency:

  • ProRes 4444
  • HEVC
  • HAP Alpha
  • HAP Q Alpha

With systems where Apple AfterBurner card is present, or with the Apple M1 Pro and Max chip based computer Mitti will leverage its power with hardware accelerated ProRes decoding, so this case ProRes is the best choice ultimatelly.

In other cases, 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

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 Inspector. Selecting a Blackmagic DeckLink device will add a new popup where you can select the format of the incoming video data.

With Blackmagic devices, the audio is also 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 its source and change its duration.

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 its source and change its.

Audio Cues

Audio Cues works and can be created just like Video and Still Images Cues. The following formats are supported:

  • wav
  • aif
  • mp3
  • m4a
  • flac

Still stuck? How can we help?