MixEmergency Manual

Introduction

Welcome to the MixEmergency (3.5.4) manual.

MixEmergency is an application designed to mix and scratch video and visualisations. It has the ability to be controlled externally by Scratch Live or Serato DJ. MixEmergency is a visualisation application only and does not handle any audio processing.

You can download a demo version of MixEmergency from http://www.inklen.com/mixemergency/. It is recommended to download and try MixEmergency on your system before you purchase a license key to ensure that it fits your needs and meets your performance requirements.

License keys can be purchased online from http://www.inklen.com/mixemergency/.

back to top

Minimum Requirements

Hardware

  • Mac (2012 model or later)

Software

  • macOS 10.13
  • Scratch Live 1.9.2 or Serato DJ 1.6, or Serato DJ Pro1

1 For external control

back to top

Authorization

To fully activate MixEmergency requires a valid authorization code. This can be purchased online at: http://www.inklen.com/mixemergency/

Once purchased you will receive your authorization code via e-mail.

To authorize MixEmergency:

  1. Launch MixEmergency
  2. Select "Authorize..." from the MixEmergency application menu
  3. Enter the authorization code that you received via e-mail
  4. Click the "Authorize" button

back to top

Supported Media

MixEmergency supports mixing and scratching1 of a range of files playable in macOS. It is recommended that you test your media files before performing live to avoid any unforeseen issues.

1 Requires external control via Scratch Live or Serato DJ

Video Files

MixEmergency officially supports and recommends the following video container formats: mp4, mov, m4v and the following video codecs: H.264, HEVC (H.265) MPEG-4, HAP, ProRes, Motion JPEG, Apple Intermediate Codec.

Image Files

MixEmergency can import most image formats recognised by macOS. It is also capable of playing animated GIF images.

Quartz Compositions

MixEmergency supports the loading and playing of Quartz Compositions (.qtz files).

Karaoke Files

MixEmergency supports the loading and playing of CDG files.

back to top

Main Window

The main window of MixEmergency displays the channel and output preview views as well as several frequently used controls (described below). This window can be shown/hidden from the Window menu, or by using the keyboard shortcut ⌘1. You can toggle this window to float above all other windows by pushing the "pin" button on the top right of this window.

Right-clicking on the left or right Preview View will open a pop-up menu with options to:

  • Syphon (to load a Syphon input)
  • NDI (to load a NDI input)
  • Eject
  • Lock/Unlock

External Control

MixEmergency has the ability to act as a "plug-in" for Serato DJ. This allows Serato DJ to control aspects of MixEmergency such as play position, mix and current media.

  1. External Control Menu - The external control pop-up menu allows you to select either MixEmergency or Serato DJ/Scratch Live as the controller for MixEmergency.
  2. Connection Status Indicator - The connection status indicator appears to the right of this menu when not connected to MixEmergency. The indicator will be colored green when there are no connection problems, or red when there are. You can view a text message of this status in the indicator's tool-tip.

Panel Controls

The panel control buttons allow you to toggle a number of MixEmergency's windows. The MIDI button, above this section, toggles the MIDI mapping mode.

Full Screen Controls

  1. Toggle Output Window - When in windowed mode, this button toggles the visibility of the output window.
  2. Full-screen Output Destination - This pop-up menu is used to select the destination display to be used when in full-screen mode.
  3. Full-screen Toggle Button - Toggles between windowed and full-screen mode.

Multiple Window Preview Layout

The main window is split into four windows when using the Multiple Window Preview layout. Three of the windows contain the channel preview views, while the fourth contains the external, panel and full-screen controls.

back to top

Control Window

The Control window contains the Transition, Effect and Transport controls of MixEmergency. This window can be shown/hidden from the Window menu, the Control window button on the Main window, or by using the keyboard shortcut ⌘3.

Transition View

The Transition view lets you control the output mix of your media sources.

  1. Upfader Control - Controls the brightness of the media source.
  2. Upfader Link - Links the Upfader of your mixer to the Upfader Control.
  3. Crossfader - Controls the mix between the current media sources.
  4. Autofade - Automatically moves the Crossfader to the opposite media source from the one displayed.
  5. Autofade Time - Adjusts the duration of the autofade.
  6. Transition Parameter - Allows customization of some transitions.
  7. Transition Select - Selects the transition to use when mixing the media sources. A more detailed explanation of the transitions is available in the Transitions section of the manual.
  8. Link Crossfader - Links the Crossfader of your mixer to the Crossfader control.
  9. Link Upfaders to Crossfader - Links the Upfaders of your mixer to the Crossfader control.
  10. Link Crossfader to Autofade - Links the Crossfader or your mixer to the autofade function.

Transport View

The Transport view is on the first tab to either side of the Transition view.

  1. Transport Controls - Allow you to restart, rewind, play backward, play forward or fast forward the media. There is also a Rate control to adjust the rate of playback. These are disabled when controlled externally. When controlled by an external application, these buttons change to a Link with Audio button that can be used to link audio in the external control application with video or Quartz Compositions playing in MixEmergency.
  2. Media Progress - Displays the current play position of the media (disabled for media without a duration - e.g. images, Quartz Compositions, etc). The progress bar will be colored red if the file is not recommended for video scratching.
  3. Eject - Ejects the media from the deck.
  4. Capture Image - Captures an image from the current Channel Preview view to be used in the Media Bank.

Effect View

The Effect view, on the second tab to either side of the Transition view, allows you to apply effects to the media sources. These are applied before the transition effect.

  1. Effect select - Selects the effect to apply.
  2. Effect mix - Controls the mix between the original source and the effect.
  3. Effect blend mode - Controls the blending mode for the effect.
  4. Effect Parameter 1 Control Select - Selects the control mode for Effect Parameter 1.
  5. Effect Parameter 1 - Controls the first effect parameter.
  6. Effect Parameter 2 Control Select - Selects the control mode for Effect Parameter 2.
  7. Effect Parameter 2 - Controls the second effect parameter.
  8. Beat Display - Displays the current beat of the media.

back to top

Media Window

The Media Bank is a place to store media that you may use often or for ambient video/Quartz Compositions (there is an option in the Preferences to load these automatically when a song without a video is loaded in Serato DJ). You can toggle the display of the Media window from the Window menu, the Media window button on the Main window, or by using the keyboard shortcut ⌘4

To load media into the Media Bank simply drag and drop files from the Finder onto the desired position.

You can drag an entire folder onto this area to have MixEmergency scan and load the contents of the folder. When using this folder mode, MixEmergency is able to load more than 16 clips into the Media Bank.

Clicking on an entry in the Media Bank will load the media to the deck that is not currently displayed on the output window. This is a feature to avoid situations where you may accidentally load media onto the live deck. You can also drag and drop media from the Media Bank directly onto a deck to bypass this safety feature.

Right-clicking on an item in the Media Bank will open a pop-up menu with options to:

  • Delete
  • Reveal in Finder
  • Generate Thumbnail
  • Generate All Thumbnails
  • Syphon (for adding and saving a Syphon input)
  • NDI (for adding and saving a NDI input)
  • Clear Media Bank

You can assign MIDI controls to individual media entries by following the instructions in the MIDI section of the manual.

back to top

Presets Window

The Presets window can be used to store and recall effect, transition, text overlay, image overlay, Quartz Composition overlay, Video Input overlay, FX Sequencer sequence, Mixer FX mapping, Media Bank, and Sample Player settings. You can toggle the display of the Presets window from the Window menu or by using the Presets window button on the Main window.

Each effect preset panel can store six banks of twelve presets (i.e. 72 presets in total).

  1. Preset Bank - Selects the current preset bank.
  2. Preset Trigger - These buttons can be used to trigger an effect preset.
  3. Preset List - This list displays the presets currently assigned to the bank. Selecting these will not trigger a preset, but allows you to select preset slots to either save or delete a preset to. Double-click on a preset to rename. For effect presets, right-click on a preset to assign a specific target (A, B, Mid.).
  4. Save Preset - Clicking this button will save the settings of an effect or transition as a preset from the currently mapped channel into the currently selected preset slot.
  5. Delete Preset - Clicking this button will delete the preset from the currently selected preset slot.
  6. Preset Channel - This control allows you to select the target for effect presets.
  7. Preset Trigger MIDI Mapping Mode - When this is disabled, you can map the 1-12 preset trigger buttons to MIDI controls, then use the Preset Bank control to switch between banks. When this is enabled, you can map each trigger, within each bank, separately. The current Preset Bank has no effect on preset triggers, allowing mapping up to 72 individual presets to MIDI controls.
  8. Preset Tab - Here you can navigate between the different types of presets.

The Preset Channel control is only available for effect presets. It has five options:

  1. A - The first media channel (left) is selected for presets.
  2. B - The second media channel (right) is selected for presets.
  3. Mid. - The middle channel is selected for presets.
  4. Safe - The channel that is not currently visible on the output is selected for presets. A lighter selection color will also indicate which of the channels (A, B or Mid.) is the current target.
  5. Actv - The channel that is currently visible (or active) on the output is selected for presets. A lighter selection color will also indicate which of the channels (A, B or Mid.) is the current target.

Saving Presets

To save an effect preset:

  1. Select the desired settings for the effect preset using the effect controls on the Control window.
  2. Use the Preset Channel control to select the channel that you have used to set up the effect settings (i.e. A for the left channel, B for the right channel, or Mid. for the middle/output channel).
  3. Select the slot to save the preset to using the Preset List.
  4. Click the Save Preset button.

Importing and Exporting Presets

To export a preset:

  1. Right-click on the preset you want to export.
  2. Select Export Preset.
  3. Enter the name that you wish to save the preset as.

To import a preset:

  1. Right-click on the preset you wish to replace.
  2. Select Import Preset.
  3. Navigate to the preset that you wish to import.

You can also drag a preset file from the macOS Finder onto the Preset List to import it.

back to top

Mixer FX Window

The Mixer FX window contains controls that allow you to map the High, Mid., Low, Filter, and FX section of your mixer to visual effects in MixEmergency. This window can be shown/hidden from the Window menu, or by using the Mixer FX window button on the Main window.

The High, Mid., and Low controls are automatically mapped to your Rane mixer or most Serato DJ controllers when Serato DJ is running. The Filter and FX sections require manual MIDI mapping.

Mixer FX View

The Mixer FX view contains the basic controls for mapping visual effects to your mixer's controls. This view has 2 channel strips, and one effect mapping area.

Channel Strips

  • Knobs - Each knob can be MIDI mapped to your mixer.
  • Pink Buttons - These buttons can be used to enable/disable the effect of the knob in the counter-clockwise direction.
  • Yellow Buttons - These buttons can be used to enable/disable the effect of the knob in the clockwise direction.

FX Mapping Area

For the High, Mid., Low, and Filter sections, there are 4 individual mapping sections. Those coloured Pink are for the counter-clockwise direction of the corresponding knob. Those coloured Yellow are for the clockwise directino of the corresponding knob.

In the FX section, there are 12 individual mapping sections. Only 2 of these are applied at one time. The mappings to be applied are selected using the green buttons to the left of the mapping sections.

Mixer FX Edit View

The Mixer FX Edit View allows you to edit how the position of the corresponding knob will control the visual effect.

The view contains controls to edit the Title, select the effect (FX), select the Blend Mode, and 3 sections that allow you to map the Mix, Parameter 1, and Parameter 2, of the selected effect.

Within the 3 mapping sections, you can select the Mode (Direct, or Beats), the number of Beats (for the Beat mode), and edit the graph of how the knob or beat position will be applied to the parameter.

The vertical axis of each Mapping Graph corresponds to the parameter value (e.g. 0%-100%).

When the Direct Mode is selected, the horizontal axis of the Mapping Graph corresponds to the distance from the resting point of the knob (the center for the High, Mid., Low, and Filter knobs, and fully counter-clockwise for the FX knob). There are 2 indicators (an orange point for Channel 1, and a pink point for Channel 2) that indicate the current mapping position when the knob is moved.

There are 3 graphs within the Mapping Graph when the Beat Mode is selected. You can choose which one to edit by clicking either the Blend, Start, or End buttons that will appear along the top of the Mapping Graph. The first graph is the Blend Graph. The horizontal axis for this Graph corresponds to the position of the knob, and the vertical axis corresponds to the blend between the Start and End graphs (0% = the Start Graph, 100% = the End Graph). The other two graphs (Start and End) have a vertical axis that corresponds to the effect parameter (e.g. 0%-100%). The horizontal axis of these Mapping Graphs corresponds to the position within the number of beats selected by the Beats control.

Editing the Mapping Graphs

The Mix, Parameter 1, and Parameter 2 mapping graphs allow you to create complex animations.

To add a new point:

  1. Right-click, and then select "Add Point", or
  2. Left-click while holding the Command key, or
  3. Double-click

To remove a point:

  1. Right-click on a point, and select "Remove Point", or
  2. Left-click while holding the Command key on a point, or
  3. Double-click on a point

To extend a control point (for a smooth bezier curve):

  1. Hold down the alt/option key while clicking on a point

To have fine control over a point:

  1. Hold down the shift key while clicking on a point

back to top

Sample Player Window

The Sample Player is designed to allow you to play up to 8 media clips (loops, samples, etc) over MixEmergency's output.

The Sample Player is not linked directly to Serato DJ's Sample Player, so it is also possible to use other audio applications to trigger/play audio samples alongside it.

Sample Player Window

The Sample Player Window contains 2 sections.

To the left are the 8 Samples. Each contains a Sample Preview View, a Stop button, an Eject button, and an Edit button. Clicking on the Sample Preview View will cause the Sample to trigger. This can also be mapped to a MIDI control.

To load a sample, simply drag and drop a media file onto the corresponding Sample Preview View.

To the right are 3 controls. The Bank buttons control which of the 4 banks of samples is currently loaded. The Out buttons control which channel of MixEmergency the samples will be output to (A = left, B = Right, M = Master). The Mix knob controls the wet/dry mix of the samples over the output.

Samples are composited from left to right (i.e. each sample to the right is rendered over the previous one to the left). To rearrange the samples, simply drag and drop their Sample Preview View between the other samples.

Sample Settings Edit View

Clicking on the Edit button below a sample will open the Sample Settings Edit View. This contains a number of settings that can be adjusted for each sample.

  • Play Mode - there are 3 play modes. From left to right, Play Through (plays from the start to the end), Play While Held (plays while the sample trigger is held), and Play/Stop (trigger once to begin playback, and again to stop).
  • Blend - selects the blending mode that is used to composite the sample (e.g. Multiply, Difference, etc).
  • Loop - when this is enabled, videos will loop until the sample is stopped or it reaches the time specified by Override Duration.
  • Alpha Blending - when this is enabled, media with an Alpha channel will use this Alpha channel to composite the sample over the output.
  • Play Rate - selects how the rate of playback is calculated. This can be set to either Pitch (play rate is controlled by the Pitch knob - which can be mapped via MIDI), or Sync to BPM (play rate is matched to the currently playing track's BPM at the moment it is triggered).
  • Override BPM - when this is enabled, the BPM of the media will be set to the BPM entered in the edit box to the right.
  • Play From - selects the point from which the media starts playback from. This can be set to Start (the beginning of the media), or Time (starts from the time, in seconds, entered in the edit box to the right).
  • Override Duration - when this is enabled, the media will play for the duration entered in the edit box to the right. This can be useful when triggering short segments from within a larger video or playing images/Quartz Compositions (by default, these have infinite duration).

Below this are 3 areas for animating the Scale, X, and Y position of the sample.

The Mode control allows you to select whether the animation is applied over the Duration of the sample, or synced to a number of Beats of the underlying music (the number of beats is selected with the control labelled Beats to the right).

To reset any of these graphs, right-click (or control-click) on the graph and select Reset.

Recommended Media

If you're playing video samples or loops, it is recommended that you encode your video using the Hap video codec, as MixEmergency can utilise your GPU to decode and playback the video, freeing up your computer's CPU.

back to top

FX Sequencer Window

The FX Sequencer window contains controls that allow you to sequence and animate effect patterns in MixEmergency. This window can be shown/hidden from the Window menu, or by using the FX Sequencer window button on the Main window.

FX Sequencer View

The FX Sequencer view contains the basic controls for sequencing and blending your effect sequences.

  1. Master Wet/Dry Mix - Controls wet/dry mix for the effect sequencer over the output of MixEmergency.
  2. Beat Indicator - Shows the current beat position within the sequence.
  3. Beat Selector - Selects the duration of the sequence (in beats).
  4. Rate - Selects the rate at which the sequence progresses (relative to the beat of the media).
  5. Effect Label/Editor - Displays the title for the effect row, and opens the effect editor. Right-click on this to copy/paste effect animations.
  6. Row Enable - Enables the effect.
  7. Sequence Matrix - From here you can enable the effect on specific beats.
  8. Sequence Type Selector - Allows you select the type of sequnced. You can select Loop (synced), One-shot, or One-shot (synced).
  9. Trigger On Load - When this is enabled, One-shot sequences will be triggered when they are loaded from an FX Sequencer preset.
  10. BPM Knob - Allows you to set the BPM of One-shot sequences.
  11. Trigger Button - Triggers a One-shot sequence.

FX Sequencer Edit View

The FX Sequencer Edit View allows you to edit the effect.

  1. Title - The effect title (this can be renamed by pushing the edit button to the right).
  2. Beat Duration - Selects the number of beats that the animation will cover.
  3. Effect - Selects the effect.
  4. Blend Mode - Selects the blend mode for the effect.
  5. Effect Mix - This mapping graph controls the mix parameter over the course of the animation.
  6. Effect Parameter 1 - This mapping graph controls parameter 1 over the course of the animation.
  7. Effect Parameter 2 - This mapping graph controls parameter 2 over the course of the animation.

Editing the Mapping Graphs

The Mix, Parameter 1, and Parameter 2 mapping graphs allow you to create complex animations.

To add a new point:

  1. Right-click, and then select "Add Point", or
  2. Left-click while holding the Command key, or
  3. Double-click

To remove a point:

  1. Right-click on a point, and select "Remove Point", or
  2. Left-click while holding the Command key on a point, or
  3. Double-click on a point

To extend a control point (for a smooth bezier curve):

  1. Hold down the alt/option key while clicking on a point

To have fine control over a point:

  1. Hold down the shift key while clicking on a point

back to top

Output Window

This window can be shown/hidden from the Window menu, the Output window button on the Main window, or by using the keyboard shortcut ⌘2.

To resize the Output window, click and drag the bottom-right corner of the window. To move the window, click and drag anywhere else within the window.

back to top

Serato DJ control

To control MixEmergency from Serato DJ:

  1. Launch Serato DJ
  2. Launch MixEmergency
  3. Set MixEmergency's external control selector to Serato DJ / Scratch Live (this is set to Serato DJ / Scratch Live by default)
  4. Check that the external control indicator is colored green

Controlling MixEmergency from Serato DJ is as easy as loading videos in Serato DJ, or dragging Quartz Compositions onto MixEmergency and linking them to the currently loaded audio file in Serato DJ.

back to top

Scratch Live control

To control MixEmergency from Scratch Live:

  1. Launch Scratch Live
  2. Launch MixEmergency
  3. Set MixEmergency's external control selector to Serato DJ / Scratch Live (this is set to Serato DJ / Scratch Live by default)
  4. Check that the external control indicator is colored green

Controlling MixEmergency from Scratch Live is as easy as loading videos in Scratch Live, or dragging Quartz Compositions onto MixEmergency and linking them to the currently loaded audio file in Scratch Live.

Note: If you're not using Scratch Live 2.3.3 or higher, then to import videos into your Scratch Live library you need to download and install the demo version of Video-SL and check "enable Video-SL plugin" in the plugins tab of Scratch Live's setup screen.

back to top

Transitions

You can choose from a range of transitions to mix between your media sources. As of MixEmergency 3.3.0, all previous transition plug-ins are now built into MixEmergency. If you're using a version earlier than this then you will need to download and install these separately. A description of just some of the transitions is available below:

  • Random - Randomly selects a transition when new media is loaded.
  •  
  • Dissolve - Smoothly dissolves between media sources.
  • Difference - Transitions through the difference between media sources.
  • Multiply - Transitions through the multiplication of the media sources.
  • Minimum - Transitions through the minimum of the media sources.
  • Maximum - Transitions through the maximum of the media sources.
  • Fade To Black - Transitions through a fade to black.
  • RGB - Transitions through the red, green and blue color channels. Transition parameter controls the channel order.
  • Luma Key Black - Transitions based on the brightness of the media sources (darker colors are mixed first). Transition parameter controls how smooth the transition is.
  • Luma Key White - Transitions based on the brightness of the media sources (lighter colors are mixed first). Transition parameter controls how smooth the transition is.
  • Slide - Horizontally slides one source in, and one source out.
  • Wipe H - A horizontal wipe effect. Transition parameter controls the smoothness of the transition edge.
  • Wipe V - A vertical wipe effect. Transition parameter controls the smoothness of the transition edge.
  • Iris - An opening iris transition. Transition parameter controls the smoothness of the transition edge.
  • Squeeze H - Distorts both media sources horizontally.
  • Squeeze V - Distorts both media sources vertically.
  • Cube - Projects the media sources onto a rotating cube. Transition parameter controls the 3D perspective.
  • Flip H - A horizontal 3D flipping transition. Transition parameter controls the 3D perspective.
  • Flip V - A vertical 3D flipping transition. Transition parameter controls the 3D perspective.
  • Grid - Displays a 3 by 3 grid that randomly transitions between the media sources. Transition parameter controls the grid size.
  • Grid 2 - A variation of the Grid transition. Transition parameter controls the grid size.
  • Grid 3 - A variation of the Grid transition. Transition parameter controls the grid size.
  • Strobes - Strobes between both media sources. Transition parameter controls the strobe time.
  • Switch - Switches instantly to the opposite media source at the center position of the crossfader.
  • Cut - Cuts instantly to the opposite media source as soon as the crossfader begins fading.
  • Hold - Holds the current media source until the crossfader has completely transitioned to the opposite media source.
  • Stay - Stays on the currently displayed media.
  • Stay Reverse - Stays on the opposite channel to the currently displayed media.

back to top

Effects

You can choose from a range of effects to apply to your media sources. As of MixEmergency 3.3.0, all previous effect plug-ins are now built into MixEmergency. If you're using a version earlier than this then you will need to download and install these separately.

Most effects have either one or two effect parameters that can be adjusted. The adjustments of these effects can be assigned to one of the following controls (this varies depending on the source of the effect).

  • Internal - The effect parameter is controlled by the main effect parameter knob.
  • Position - The effect parameter is controlled by the current position (time) of the media.
  • Velocity - The effect parameter is controlled by the velocity of the media.
  • Bass - The effect parameter is controlled by the amount of bass in the audio for the media. Note: This option is not available when using MixEmergency as the controller.
  • Grid - The effect parameter is controlled by the current beat position for songs that have a beat grid (if not, then it will default to using the BPM).

Using these controls you can quickly and easily add effects that react dynamically to mixing and scratching.

Position control

When controlling the effect parameter with the Position control, the knob that appears to the right controls the rate of the effect.

Velocity control

When controlling the effect parameter with the Velocity control, a mapping graph will appear to the right. Clicking on this mapping graph will pop out a larger editing view.

The vertical range corresponds to the effect parameter, and maps directly onto the range of the effect parameter knob. The second range corresponds to velocity, and maps the velocity of the media. This is an advanced function of the program, and may take some time to get used to.

The mapping graph has three parts: two mapping points and a mapping indicator. The mapping points can be repositioned by dragging the points around the graph. The mapping indicator is a blue dot that will automatically move to show the currently mapped position on the graph.

The effect parameter (vertical) range is from 0 to 10 (i.e. the same as the range on the effect parameter knob) and controls the range of the effect to control.

The above examples show:

  1. Mapping from 0 to 10.
  2. Mapping from 5 to 10.
  3. Mapping from 10 to 0.

The velocity (horizontal) range is from -2 to 2 and controls the range of the velocity to affect the control. At -2 the media would be playing backwards at double speed, 0 would be stopped, 1 would be playing forwards at normal speed and 2 would be playing forwards at double speed.

The above examples show:

  1. Mapping -2 to 2 - all velocities in this range will affect the parameter.
  2. Mapping 0 to 2 - only positive velocities (moving forwards) will affect the parameter.
  3. Mapping -1 to 0 - only negative velocities (moving backwards) will affect the parameter. This can be useful if you only want the effect when scratching.

The blue dot on the mapping graph gives an indication of how the current velocity is mapped.

The above examples show:

  1. Velocity is 2 x reverse, mapping the effect parameter to 0.
  2. Velocity is 1 x reverse, mapping the effect parameter to 2.5.
  3. Velocity is 0 (stopped), mapping the effect parameter to 5.
  4. Velocity is 1 x forward, mapping the effect parameter to 7.5.
  5. Velocity is 2 x forward, mapping the effect parameter to 10.

Once you understand how these controls work, you will be able to quickly and easily create effects that compliment your video scratching.

Bass control

The bass control mode graph is similar to the velocity graph. The only difference is that the horizontal axis represents the time since the bass triggered the effect parameter. When the bass triggers the effect parameter the blue mapping indicator will jump to the left of the graph and slowly move towards the right.

Grid control

The Grid control mode graph is similar to the velocity graph. The horizontal axis represents one beat (as defined by a preset Beatgrid, or based upon the BPM of the currently loaded media). As the beat progresses it will shift from the left to the right.

back to top

Plug-Ins

Please note that, as of MixEmergency 3.3.0, all previous effect and transition plug-ins are now built into MixEmergency.

MixEmergency supports effect and transition plug-ins. These can be used to extend MixEmergency with new effects and transitions.

Plug-ins are in a format created exclusively for MixEmergency and use the same high-performance graphics technologies used in MixEmergency.

Installation

To install a plug-in for use withing MixEmergency.

  1. Double-click on the plug-in.
  2. MixEmergency may prompt you to replace the existing plug-in. If so, then click "replace".
  3. Re-launch MixEmergency.
  4. Check that the plug-in is now be available in either the effect or transition list.

Plug-in files have the extension "plugin" and are installed in the folder ~/Movies/MixEmergency/Plug-Ins/.

Removal

To remove a plug-in previously installed with MixEmergency.

  1. Close MixEmergency.
  2. Delete the effect or transition plug-in from the folder ~/Movies/MixEmergency/Plug-Ins/.

back to top

Overlay Window

The Overlay Window can be used to display text, images, Quartz Compositions, video input, NDI streams, Syphon streams, and border fills, over the output of MixEmergency. This window can be shown/hidden from the Window menu, or by using the keyboard shortcut ⌘5.

Text Overlay

The Text overlay can be used to display static or scrolling text over the output of MixEmergency. The controls, in order from top left to bottom right are:

  • On/Off - Toggles the text overlay.
  • Channel - Allows you to place the overlay on the Output, Left or Right channel.
  • Text - Text to display.
  • Font - Displays a standard font panel.
  • Color - The color of the text.
  • Mix - The opacity of the overlay.
  • Scale - The height of the font.
  • X - The horizontal position of the overlay.
  • Y - The vertical position of the overlay.
  • Effect - The effect applied to the overlay.
  • Effect Parameter - An adjustable parameter of the effect.

The Text Overlay Window is useful for adding short text titles or advertisements over the output.

Image Overlay

The Image overlay can be used to display a static image over the output of MixEmergency. The controls, in order from top left to bottom right are:

  • On/Off - Toggles the image overlay.
  • Channel - Allows you to place the overlay on the Output, Left or Right channel.
  • Image - Drag and drop image files here to set them as the current image.
  • Mix - The opacity of the overlay.
  • Scale - Scales the image.
  • X - The horizontal position of the overlay.
  • Y - The vertical position of the overlay.
  • Effect - The effect applied to the overlay.
  • Effect Parameter - An adjustable parameter of the effect.

The Image Overlay Window is useful for adding titles, logos or advertisements over the output. It supports most image file formats that Quicktime can open.

Quartz Composition Overlay

  • On/Off - Toggles the Quartz Composition overlay.
  • Quartz Composition - Drag and drop Quartz Compositions here to set them as the current Quartz Composition overlay.
  • Mix - The opacity of the overlay.

Video Input Overlay

  • On/Off - Toggles the Video Input overlay.
  • Device - Allows you to select the Video Input device.
  • Quality - Allows you to lower the quality level of the video input.
  • Mix - The opacity of the overlay.
  • Scale - Scales the image.
  • X - The horizontal position of the overlay.
  • Y - The vertical position of the overlay.

Border Fill Overlay

The Border Fill overlay differs from the other overlays in that it is applied to each channel prior to the channel's effects.

The purpose of this overlay is to fill in the "black bars" that are often seen on videos which have an aspect ratio that differs from the output aspect ratio. You can select from one of several effects to fill this space.

Syphon and NDI Overlay

These overlays allow you to overlay a live video feed via either Syphon or a NDI input.

back to top

MIDI

MixEmergency supports MIDI control of almost all controls available on screen (such as the faders, transition select menu and loading media from the media bank). You can easily use a MIDI capable mixer to control MixEmergency.

MixEmergency also supports MIDI output (also commonly referred to as "MIDI feedback") - allowing you to sync compatible MIDI gear with the on-screen state of MixEmergency's controls.

To toggle MIDI mapping mode, push the MIDI button on the Main window of MixEmergency. All MIDI mappable controls will display whether they have been MIDI mapped when this mode is on. Controls that have a MIDI mapping will appear green, while those that have not will appear red.

To assign a MIDI control to an on-screen control:

  1. Ensure that your MIDI device is connected
  2. Enter MIDI mapping mode.
  3. Click the on-screen control you wish to map.
  4. If you are adding a second MIDI mapping for a control, ensure that the Learn New Control button is enabled (or the Learn 14-Bit Control button, for high-resolution MIDI controls).
  5. Move or toggle the MIDI control.

To clear an assigned MIDI control:

  1. Enter MIDI mapping mode.
  2. Click the on-screen control that you wish to clear.
  3. Click the trash button to the right of the mapped control you wish to clear.

Advanced MIDI Mapping

The MIDI mapping pop-up panel contains a button that enables the Advanced MIDI mapping mode. This mode enables further options for your MIDI mapping. Also note that you can map multiple MIDI controls to a single control in MixEmergency.

The Advanced MIDI input mapping options are:

  • Fine - This sets the MIDI control number for the fine MIDI message (only available for 14-Bit MIDI messages).
  • 14-Bit - This enables 14-Bit MIDI control.
  • Mode - This sets the way in which the MIDI control interacts with the MixEmergency control. You can use this to support the use of rotary MIDI controls, or you can map a MIDI button to step up or down through the effect list of MixEmergency.
  • Invert - Inverts the MIDI control. For example, a MIDI knob may set a MixEmergency control to the minimum value when turned fully counterclockwise, and to the maximum when turned fully clockwise. If the Invert button was enabled then the control would be set to the maximum when turned fully counterclockwise, and the minimum when turned fully clockwise.
  • Shift - This allows you to map either an additional MIDI button, or keyboard key, to the mapping. Only when this MIDI button is enabled, or keyboard key pressed, will the mapping apply.

The Advanced MIDI output mapping options are:

  • Invert - Inverts the MIDI control.

MIDI Window

This window can be shown/hidden from the Window menu, or by using the keyboard shortcut ⌘8.

Inputs and Outputs

Here you can select which MIDI input and output devices MixEmergency will send to (outputs) and receive (inputs) MIDI messages from.

You can also set MixEmergency to sync all beat-related features to an incoming MIDI Clock signal.

Shift/Layer Buttons

These MIDI mappable buttons can be used in conjunction with the "Shift" section of the MIDI mapping pop-up windows.

Mappings

The Mappings section of the MIDI window allows you to load, save and delete MIDI mappings for MixEmergency.

To load a MIDI mapping:

  1. Select the mapping from the MIDI mapping list.
  2. Push the Load button.

To save a MIDI mapping:

  1. Type the desired name for the MIDI mapping in the text box.
  2. Push the Save button.

To delete a MIDI mapping:

  1. Select the mapping from the MIDI mapping list.
  2. Push the Delete button.

Info

This section of the MIDI Window displays information about the current MIDI sources and the data received from these sources.

The Info section can be used to verify that your MIDI device is communicating correctly with MixEmergency. When the Log MIDI Messages check-box is enabled, MIDI data received by MixEmergency will be logged in the lower text view.

The "In" and "Out" lights will briefly change to green when a MIDI message is sent or received.

It is recommended that you use the MIDI logging function only if you encounter problems assigning MIDI controls within MixEmergency. During live performance it is recommended that MIDI logging is disabled.

back to top

Preferences

The preferences panel can be accessed through the application menu or the keyboard shortcut ⌘,

General

Windows

Layout - Allows you to select between the Single Window Preview layout and the Multi Window Preview layout (which splits the main MixEmergency window into three independently resizeable windows). Note that Single Window Preview layout is more efficient than the Multi Window Preview layout with regards to CPU and GPU usage.

Opacity - These controls set the opacity of the main application windows. This can be useful if you need to monitor another application while using MixEmergency.

Forward keyboard events - When this option is checked MixEmergency will forward any keyboard events (not including short-cuts used by MixEmergency) to the external controller application. This can be useful if you don't want to switch between the applications.

Disable conflicting shortcuts - When this option is checked MixEmergency will disable keyboard shortcuts that conflict with the application currently controlling MixEmergency.

Auto-hide menu bar and dock - When this option is enabled MixEmergency will auto-hide the menu bar and dock when MixEmergency is set to float above other windows.

Effects

Automatically load effects - Enables loading of previously saved effects when media is loaded.

Automatically save effects - Enables saving of the last used effect preset per media.

Display

The Display preference panel allows you to control aspects relating to the output of MixEmergency.

Output

Quality - This adjusts the quality of the rendered output level. If you're experiencing low frame rates on full-screen then you may need to lower this setting.

Scaling - There are four types of output scaling: Fit, Letterbox, Zoom and Stretch.

  • Fit - This adds black bars either horizontally or vertically to fit the full video into the output. The aspect ratio of the media is maintained.
  • Letterbox - This adds only horizontal black bars to the media. Cropping may occur at the top and bottom of the screen. The aspect ratio of the media is maintained.
  • Zoom - This will scale the media so that the entire output screen is filled. Cropping may occur at the edges of the screen. The aspect ratio of the media is maintained.
  • Stretch - This stretches the media to fit into the dimensions of the output screen. The aspect ratio of the media is not maintained.

Arrangement - Controls the arrangement of panels on the output window.

  • Mix - This option is the default and will display the mixed output of both channels.
  • Left, Right - This option displays the left and right channel beside each other in the output.
  • Left, Mix, Right - This option displays the left, mix and right channels horizontally beside each other in the output.

Enable Frame Blending - This option enables frame blending for videos, resulting in smoother video when scratching at slower speeds.

Enable Anti-Aliasing - This option will apply an anti-aliasing filter to the output, which will result in smoother edges on the output image.

Enter full screen on startup - This option automatically activates full screen mode when the application launches. This will only occur when an external monitor is detected.

Flip Horizontal - Flips the output image along the horizontal axis.

Flip Vertical - Flips the output image along the vertical axis.

Enable Color Correction - Enables basic brightness, saturation and contrast controls for the output.

Brightness - Controls the brightness of the output.

Saturation - Controls the saturation of the output.

Contrast - Controls the contrast of the output.

Use Advanced Output - Enables the advanced output. This can be configured by pushing the button labelled "Configure".

Preview

Aspect Ratio - This sets the aspect ratio of the preview views. You can choose either None, 4:3 or 16:9.

Update Rate - The update rate of the preview views can be lowered using this control.

Transition

Transition

Reverse MIDI fader - This reverses the direction of any MIDI control assigned to the Crossfader.

Smooth fader - This enables Crossfader smoothing.

Random Transition includes - Use this to choose which transitions will be selected from when using the Random transition.

Auto-fade

Auto-fade duration - This sets the duration of the auto-fade control.

Auto-fade Hot-key - This can be used to assign a global hot-key to the auto-fade button.

Stopping media triggers Auto-fade - Stopping one channel's media (e.g. pulling backwards on your external vinyl control) while this is enabled will cause MixEmergency to trigger an auto-fade to the opposite playing channel. This is useful when you don't have access to a MIDI controller or mixer.

Fader cut distance - Allows you to adjust the fader cut distance for the crossfader.

Use External Controller Crossfader - Enables the use of your External Controller's (e.g. Scratch Live) crossfader.

Use External Controller Upfaders - Enables the use of your External Controller's (e.g. Scratch Live) upfaders.

Use External Controller Cuefader - Enables the use of your External Controller's (e.g. Scratch Live) cuefader.

Contour

Enable - Enables contouring.

Crossfader - Adjusts the contour of the crossfader between slow and fast.

Upfaders - Adjusts the contour of the crossfader between slow and fast.

Use External Controller Contour - Enables the use of your External Controller's (e.g. Scratch Live) contour.

Plug-ins

The two tables on this panel allow you to select and reorder the plug-ins that appear in your effect and transition lists.

Advanced

The settings on the Advanced preference panel are recommended for more advanced users.

Cache

The main slider in this window controls the amount of memory MixEmergency will allocate for caching video frames.

Important: if using GPU-accelerated video decoding, it is recommended to set this value to around a 1/4 of the memory of your GPU (e.g. if your GPU has 1024 MB of memory, you would set the cache size to either 200 MB or 300 MB).

External Control

The pop-up menu allows you to select the default action when an unlinked audio file is loaded.

Enable GPU-Accelerated Video Decoding - This option will cause MixEmergency to attempt to use the GPU to decode H.264 encoded video. This can result in significantly reduced CPU usage. This only affects the main 2 channels (i.e. the Sample Player doesn't take advantage of this). Not all hardware is capable of GPU-accelerated video decoding.

Display Beat Views - This option toggles the visibility of the Beat Views on the effect panel of the Control Window.

Lower full screen window level - This option lowers the window level of the output when full screen. This can allow other windows to display on top of MixEmergency. This is not recommended for general use.

Synchronize Output to Screen Refresh - Turning off this option may result in better performance, but will result in poorer image quality.

Loop Media longer than 1 minute - Selects whether to loop videos longer than one minute in length.

Zero Alpha Channel - Enables clearing of the alpha channel. This is useful if you're compositing the output of MixEmergency in another program via Syphon.

Delay Compensation

Delay Compensation allows you to compensate for any delay in video or audio in your system so that your video and audio will always appear in sync.

Enable - Enables Delay Compensation.

View Helper - When Delay Compensation is enabled, this will flash colours on both the preview views and the output screen. Use the Delay Compensation slider to align these.

Delay Time - Controls the offset for the delay compensation.

Below the slider are + and - buttons that allow you to offset the centre of the Delay Compensation slider by 1 second. This is useful if delay values are outside the range of the slider.

Notifications

Size - Controls the size of the notification overlay.

Position - Controls the vertical position of the notification overlay.

Transition - When this is enabled, changing the Transition will trigger the notification overlay.

Transition Parameter - When this is enabled, changes to the Transition Parameter will trigger the notification overlay.

Effect - When this is enabled, changing the Effect will trigger the notification overlay.

Effect Parameter - When this is enabled, changes to the Effect Parameter will trigger the notification overlay.

Sharing

Syphon Output

"Syphon is an open source Mac OS X technology that allows applications to share frames - full frame rate video or stills - with one another in realtime."

These settings allow you to toggle output via Syphon to other Syphon enabled applications.

NDI Output

"NDI, NewTek’s Network Device Interface protocol, is new technology for ultra-connected, IP-based video production."

These settings allow you to toggle output via NDI to other NDI enabled applications.

back to top

Info Window

The Info Window displays information about the current output performance and the loaded media sources. This window can be shown/hidden from the Window menu, or by using the keyboard shortcut ⌘0.

  • Display - This lists information about the output display. Of most interest is the Output FPS display (FPS is Frames Per Second). You can check this number to check the performance of your system (higher values are better). Note that the optimum value will be one close to the Refresh Rate.
  • Media 1/2 - This lists information about the current media source and may be useful for identifying incompatible files or problems with your system.

back to top

Messages Window

The Messages Window displays any warnings encountered when loading and playing media that may make the media unsuitable for complex mixing and scratching.

back to top

Recording and Exporting

MixEmergency allows you to record and export your performance. Only a small amount of data is recorded during the recording stage so that your system's CPU is not put under unnecessary stress.

Recording

Recording your performance couldn't be easier. MixEmergency records the minimum amount of performance data needed to reconstruct your performance. If selected, MixEmergency will also record an audio stream to an uncompressed file.

To record your performance:

  1. Select "New Recording..." from the Recording menu.
  2. Select a file to record to.
  3. Select whether to also record the audio.
  4. Begin recording by clicking the button labelled "Record".

You can then use MixEmergency as you would normally.

To stop recording, simply push the "Stop" button on the Recording window.

Exporting

Previously recorded performances can be exported from MixEmergency. Exporting can take quite a while to complete depending on the length of your recording and the compression format you have chosen to export to.

Before exporting a performance make sure that all external drives that contain media used during the performance are connected to your computer.

To export your performance:

  1. Select "Export a Recording..." from the Recording menu.
  2. Select the recording file to export.
  3. Choose the export options. You can choose the rendering pipeline dimensions, the scaling method, and whether frame blending is enabled. You can also choose an export preset (recommended), or select the custom preset to set your own output video and audio options.
  4. Begin exporting by clicking the button labelled "Export".

A window will appear while exporting that allows you to preview and monitor the progress of the export and to cancel the export if necessary.

back to top

Video Compression Guidelines

It is impossible to give a compression setting that satisfies all users, as factors such as computer performance, desired output dimensions and the desired level of compression artefacts are different for each user. Finding an optimal compression setting for your videos may initially involve some experimentation using different formats and compressions presets to determine the optimal settings for your computer.

A few key areas of compression will help with the performance of MixEmergency. Video should be compressed with keyframes every 12 to 25 frames. Longer distances between keyframes will result in a lot of unnecessary decoding, and can degrade the performance of MixEmergency.

The dimensions of the compressed image will depend on the performance of your computer and the output device that you intend on displaying to. For most situations, 720P (1280 x 720 pixels) will be sufficient. If you experience poor performance, you may need to recompress your video at decreased dimensions or lower bitrates.

It is recommended that you compress your video as H.264 video in a mov or mp4 container.

back to top

Quartz Compositions

There are currently 23 published inputs that are supported by MixEmergency. These can be used to allow your Quartz Composition to react to your controller (e.g. record velocity when controlled via Scratch Live).

  • Path - The file path of the Quartz Composition.
  • Deck - The video deck number (1 or 2).
  • AudioLevel1 - The audio level of the current channel's media (a number, 0..1)1.
  • AudioLevel2 - The audio level of the opposite channel's media (a number, 0..1)1.
  • AudioSpectrum1 - The audio spectrum of the current channel's media (a structure)1.
  • AudioSpectrum2 - The audio spectrum of the opposite channel's media (a structure)1.
  • Beat1 - The current beat position of the current channel's media (a number).
  • Beat2 - The current beat position of the opposite channel's media (a number).
  • BPM1 - The BPM of the current channel's media (a number).
  • BPM2 - The BPM of the opposite channel's media (a number).
  • Image1 - The output of the current channel's media (an image)2.
  • Image2 - The output of the opposite channel's media (an image)2.
  • MediaTitle1 - The title of the current channel's media (a string)1.
  • MediaTitle2 - The title of the opposite channel's media (a string)1.
  • MediaAlbum1 - The album title of the current channel's media (a string)1.
  • MediaAlbum2 - The album title of the opposite channel's media (a string)1.
  • MediaArtist1 - The artist of the current channel's media (a string)1.
  • MediaArtist2 - The artist of the opposite channel's media (a string)1.
  • Mix - The crossfader position (a number between 0 and 1).
  • Position1 - The play position of the current channel's media (a number, in seconds).
  • Position2 - The play position of the opposite channel's media (a number, in seconds).
  • Velocity1 - The velocity of the current channel's media (a number, can be positive or negative).
  • Velocity2 - The velocity of the opposite channel's media (a number, can be positive or negative).

Quartz Compositions are loaded at the current dimensions of the output display. If you experience low frame rates when playing Quartz Compositions, try lowering the Quality setting on the Display preference panel and then re-loading the Quartz Composition.

1 Only available when controlled by Serato DJ
2 Only available to Quartz Composition overlays

back to top

Parameter Window

The Parameter Window allows you to edit published inputs of Quartz Compositions. There are two Parameter Windows - one for media 1, and one for media 2. These can be shown/hidden from the Window menu, or by using the keyboard shortcuts ⌘6 and ⌘7.

Published inputs that have the type Number and a valid minimum and maximum value are assigned slider controls. Published inputs that have the type Boolean are assigned check-box controls. Any control that is a slider or button can be controlled via MIDI using the Control Mapping element. To map a MIDI control to a published input, follow the MIDI assignment instructions in the MIDI section of the manual.

Other published inputs, such as those of type Image, String, Index or Color, are also supported in the Parameter Window.

back to top

Performance Tuning

A number of factors can influence the performance of MixEmergency. The following is a rough guide to some of the features that can influence MixEmergency's performance.

Memory

MixEmergency uses your computer's memory to store video frames in an attempt to optimize video decoding performance. If the memory on your computer becomes low, this can cause MixEmergency's performance to deteriorate. The level of memory used can be set in the Advanced panel of the preferences. You can check the level of your computer's free memory using the Activity Monitor application on macOS.

If using GPU-accelerated video decoding, make sure that MixEmergency's cache size is set to a lower value. Often a good setting is to set this at around 1/4 of the RAM available to the GPU. For example, if your GPU has 1024 MB of RAM, set MixEmergency's Cache Size to between 200 MB to 300 MB. Higher values may degrade performance.

Quality

The quality slider in the Output panel of the preferences can be used to tune performance. For example, if you were to output MixEmergency to an external screen of size 1280 x 720, and your videos are of size 640 x 480, then setting the Quality slider to medium would be appropriate. This would cause MixEmergency to render internally (transitions and effects) at 640 x 480 instead of 1280 x 720, and should improve performance while maintaining the quality of your videos. You can use the Info window to determine the output dimensions, and the quality adjusted dimensions (i.e. the render pipeline dimensions).

Transitions/Effects

Some of the more complex transitions and effects can have an effect on performance. You should test your system with all the effects and transitions that you plan to use in a live situation beforehand.

back to top

Trouble Shooting

Low output frame rates and poor performance

  1. Close any un-used applications.
  2. Try reducing the size of the output window.
  3. Try disabling any effects.
  4. Try lowering the Quality slider in the Display panel of the preferences.
  5. Lower the cache size in the Cache section of the Advanced panel of the preferences if your computer's free memory is running low.
  6. Re-encode your video at a lower resolution.

Low frame rates when full-screen on secondary monitor

  1. Try decreasing the size of your secondary screen.
  2. Try lowering the Quality slider in the Display panel of the preferences.

For help with any other problems, please visit the Inklen support forum: http://www.inklen.com/forum/

back to top

Minimum Requirements - Mac computer - macOS 12.4 - Scratch Live 1.9.2, Serato DJ 1.6, or Serato DJ Pro