Table of contents

Welcome to EboSuite
Installing EboSuite
Basic concepts
The EboSuite application and the Output Window
Video codecs
EboSuite plug-ins
Instruments
eClips
eArrangement
eSampler
eSimpler
eISF
eVideoIn
eText2Syphon
Mixing
eTrackTransform
eBlend
eCrossfade
eFeedback
eOutput
eFX
eFX-ISF
33 basic eFX
Other
eConvert
eSyphonOut
eSyphonIn
ePoly
eComper
eLoopStutter

!1
Record the video output
eDecollect (Collect All and Save)
Important links
Error and warning messages

33 Basic eFX

Bend
LoFi
BlockBlur Median
BrCoSa
Noise
BulgeTwist OneHue
Chroma
Pointilize
Crop Polygonize
CrossHatch
RGB
DanPix RGBShift
Edge
RotaZoom
Fade Shape
Glutch Shine
HSBShift SineThreshold
HueRotate Slitscan
HueSat Slitsglow
Kaleido Wave
Kaputt WaveGlass
Levels

!2
 Welcome to EboSuite
With EboSuite you can treat video like audio in Ableton Live. EboSuite is a growing set of Max for Live plug-ins
that enable you to sample, manipulate, mix and edit video on up to 64 tracks simultaneously. Opening an
EboSuite plug-in automatically opens the EboSuite application. Since the EboSuite application runs outside of
Ableton Live, in a separate instance, Live’s performance is not affected while using EboSuite. Most video codecs
are supported (a.o Hap, H264, ProRes, Photo-JPEG etc.). The Hap codec is recommended since that codec is
optimised for live video triggering, mixing and manipulation (EboSuite comes with an easy to use plug-in to
convert video to Hap within Ableton Live). Video files with alpha channel and of any resolution are supported.
EboSuite is extremely easy to install; you can start sampling and mixing within a few clicks.

About this manual

EboSuite is under constant development and therefore the manual is updated on a regular basis. Download the
latest version on the support page on the EboSuite website. This manual describes EboSuite version 1.8 and is last
edited on 16 June 2021.

If you have any more questions or comments please visit the forum. There you’ll find more information about
EboSuite and we will reply as soon as possible when you post a question or comment there.

Tutorial videos are available about the use of EboSuite and some specific features.

If you have questions about the concepts and use of Ableton Live please refer to the Ableton Live manual.

!3
 Installing EboSuite
Installation requirements
- Mac OS 10.13+
- Ableton Live 9.5+ (64 bit only)
- Max for Live 7.3+

Installing
After ordering a full or trial license of EboSuite on the EboSuite website you will receive an email with a download
link for the EboSuite installer and a license code. The installer is packed in a .zip file together with the Quickstart
Guide. After unpacking the .zip file the installer is located in a folder called ‘EboSuite Installer’. The installer is
an .als file (an Ableton Live set) called ‘Open this Live set to install EboSuite.als’.

EboSuite will be installed in the User Library of the Ableton Live application that you use to open this .als file. For
this, the installer reads the preference file of the Ableton Live application, so make sure a valid and available User
Library is selected in the preferences.

When you open the Live set you will notice that Ableton Live will be closed immediately by the installer. This is
the beginning of the installation process, hereafter the installer will take you through seven simple steps. You will
be asked to agree with the end-user licensing agreement (EULA) and during the installation proces the installer
will show you the file path of the User Library EboSuite will be installed in.

The EboSuite installer will create a folder named EboSuite in the User Library. In this folder the installer will
install the EboSuite plug-ins and the main EboSuite application. The EboSuite application is a hidden file, so you
will not be able to see it in this folder. Please do not move this folder or the files in this folder to another location.
If you want to move EboSuite to another User Library, select this User Library in Ableton Live and run the

!4
EboSuite installer again (open the .als file). If you want to install EboSuite in the User Library of another version
of Ableton Live, just open the ‘Open this Live set to install EboSuite.als’ file with that version of Ableton live.

Registering EboSuite
After the installation is completed, copy the license code from the email to the clipboard (select the text and
press CMD-c) and open Ableton Live. You will find the EboSuite plug-ins in the User Library within Ableton Live.

Drag the eClips plug-in on an audio track. This will launch the EboSuite application in the background and open
the video output window. When the EboSuite application is launched for the first time, it will look for the license
code in the clipboard and it will register automatically. When registration is completed a pop window will appear
to confirm this and the name of the license owner will be shown in the top bar of the video output window. When
the license code is not available in the clipboard, registration will fail and a pop up window will warn about this. In
this case the EboSuite application will not launch and the video output window will not appear. To fix this delete all
EboSuite plug-ins from your Live set, copy the license code from the email and return to Ableton Live and add an
eClips plug-in again.

!5
Registering EboSuite while in demo mode
When EboSuite is running in demo mode it will not ask for a license key on start up anymore. To register while in
demo mode, copy the license key from the email and select ‘Enter License Code’ from the EboSuite menu.

Settings in Ableton Live

We tried to make the installation and licensing proces as easy as possible. Once EboSuite is installed and
registered you can start video sampling, mixing and editing right away. Nevertheless there are a few settings in
Ableton Live that can influence EboSuite’s performance. Therefore, please check the following settings in
Ableton Live:
- make sure the User Library selected in the Ableton Live preferences is available. The EboSuite installer will
automatically read the preference file of Ableton Live and install EboSuite in the User Library that is selected
there. If this User Library is unavailable when you start using Live (e.g. when it is located on an external drive
that is disconnected) you will not be able to launch EboSuite and the plug-ins will show an error message.

- select the appropriate audio buffer size (Preferences/Audio/Latency/Buffer Size). A smaller buffer size will
improve the audiovisual sync and performance of EboSuite, but will have a heavier load on the CPU. We advice
you to try different settings and look for a setting that works best with your set-up. A buffer size of 128 or 256
samples will work fine in most cases.
- (Ableton Live 9 only:) make sure that the latest version of Max is installed and selected in Live’s preferences
(Live/Preferences/File Folder).

!6
 Basic concepts

Contents
Currently EboSuite consists of 51 plug-ins and the main EboSuite application.
- eClips - adds video playback to Session View
- eArrangement - use videos on audio tracks in Arrangement View
- eSampler - trigger, pitch and scratch video
- eSimpler - turn Ableton Live’s Simpler into a video sampler
- eISF - use ISF shaders to generate visuals
- eVideoIn - use the video stream of a webcam, iPhone or iPad in EboSuite
- eText2Syphon - send the name of a clip over Syphon to eSyphonIn or to other video applications
- eTrackTransform - position, scale, rotate individual tracks
- eBlend - use blending modes to mix video tracks
- eCrossfade - use visual crossfade effects to mix videos
- eFeedback - create a video feedback loop on the master track with different feedback modes
- eOutput - control the output window from within Live
- eFX-ISF - use ISF shaders to generate and/or manipulate visuals
- eFX - 33 modular, stackable visual effect plug-ins for realtime image manipulation and processing
- eConvert - convert video to Hap codec
- eSyphonOut - send the video output of single tracks and/or the master track to other video applications
- eSyphonIn - use the video stream of other video applications in EboSuite
- ePoly - create polyphonic and polyscopic compositions
- eComper - consolidate a MIDI clip to a video file
- eLoopStutter - bring dynamic ‘beat repeat’-like effects to eClips.

Video tracks
Currently up to 64 video tracks can be used simultaneously with EboSuite. 512 video files can be used in a single
Live Set. In Live 10 maximum 512 videos can be loaded on an audio track in Session View, 256 in Live 9. The
specifications of your hardware (CPU, GPU) might limit the amount of tracks that you can use simultaneously.

Mixing videos
To mix videos you first have to create at least two video tracks by adding at least two eClips, eVideoIn,
eSyphonIn and/or eSampler plug-ins to your Live set. By default the opacity of the video tracks is linked to the
volume sliders in Live’s audio mixer. The order of the tracks determines which track is on top and therefore will
be visible when its volume/opacity is set to maximum. The right most track (Session View) or bottom most
track (Arrangement View) will be on top. Changing the position order of the tracks in Live’s Arrangement or
Session View will also change the order in the video mix. Use the eBlend plug-in to blend video tracks. Assign
the tracks to AB crossfade sources and use the eCrossfade plug-in to add video mix effects.

Using Warped clips

When you use Live 9 or 10 you need to save the Warp markers when you enable or change the Warp markers.
Otherwise eClips, the eSampler and the eSimpler will not be able to use the Warp markers, which leads to
unexpected results, like freezing video, out-of-sync video and black output. Click the ‘save’ button in the Sample
section of the audio clip playback properties. Each time you make changes to the Warp markers you need to save
them to see the effect of your changes. Note: When you use Live 11 you will not have to save warp markers.
!7
The reason for this limitation is that Ableton does not give acces to the Warp markers in Live 9 and 10. We can
only use one set of Warp markers that is stored in the .asd file after pressing save. When you change the Warp
markers and press save, the video playback is automatically updated (this takes more or less one second).
A video clip can only have one set of Warp markers. So if you load multiple instances of a video clip in your Live
set, editing the Warp markers from one video clip (and thus saving them) will change the Warp markers for all
instances (since you need to save them to enable eClips to use them). Note: When you use Live 11 you will not
have to deal with these issues.

Video codecs and image files

EboSuite is compatible with many video codecs, like Hap, H264, ProRes, MPEG-4, DV and Photo-JPEG. We
recommend you to try out different codecs, compression settings and image sizes to find out what works best in
your situation and with your hardware configuration.

Important note: Choosing the right codec and compression settings is crucial for optimal performance and
reliability of EboSuite. Only the Hap codec is optimised for live video applications, so we recommend you to use
Hap encoded videos. You’ll need an SSD drive to playback Hap properly. Read more about video codecs in the
Video codecs section of this manual.

EboSuite’s eSampler and eSimpler handle image files as well, like .jpg, .png etc.

Unfortunately the eClips plug-in doesn’t handle image files anymore, because Ableton Live doesn’t accept
image files on audio tracks anymore (since Live 10.10+).

Error en warning messages

EboSuite will warn you when an unsupported or unexpected situation is detected by showing an error or warning
message. You can open and close the error and warning message section of the plug-in interface with the small
arrow in the right-bottom of the interface. When there is an error or warning message the arrow wil turn yellow
(warning) or red (error) and the error/warning section will unfold to show the message. When the unsupported or
unexpected situation is resolved the error/warning message will disappear automatically. Refer to the ‘Error and
warning messages’ section of this manual to see a list of the error and warning messages.

!8
Dials/Sliders
General information about dials and sliders:
- The value is visible when you move the mouse pointer over the dial/slider or the label.
- You can change the value with the mouse, but also by entering the value with keys and pressing enter
(for some parameters which use a custom or changing value range this can react a bit unexpected).
- You can have fine control with the mouse when you hold the shift button.
- If a dial has an triangle at the top you can also click on the triangle to apply that ‘center’ value.

Info View
Use Ableton Live’s Info View to learn more about EboSuite’s interface elements and functions. Most interface
elements will show an Info View description when the mouse pointer hoovers over the element. The Info View
section needs to be revealed to show this. To reveal it, click on the triangle in the lower left corner of Live’s
interface. You can find more information about Info View in the Ableton Live manual.

!9
 The EboSuite application and the Output Window

The EboSuite application will automatically be launched when you add an eClips or eSampler plug-in to your
Ableton Live set. The application runs in the background in a separate instance., so all video processing is done
outside Ableton Live to maximise performance and reliability. When the EboSuite application is launched the
video output window will appear.

When the application is active in the foreground (click inside the output window to bring the application to the
foreground) the application’s menu bar will appear at the top of the desktop.

The EboSuite application can only be controlled from the menu bar and from the EboSuite plug-ins in Ableton
Live. The menu bar contains the following items:

- EboSuite
- About EboSuite - information about EboSuite
- Licensed to… - name and email address of licensee
- Services - no services apply
- Hide EboSuite
- Hide Others
- Show All
- Quit EboSuite

- File
- Close - this will close the output window and quit the EboSuite application

!10
- View
- View Statusbar - this will add the statusbar to the output window showing the current window size and
the amount of free VRam

- Always on top - this will force the output window to always stay on top of other windows, even when
another application is active in the foreground.

- Enter Full Screen - this will make the output window fill the whole screen

- Window
- Minimise - this will minimise the output window and move it to the dock
- Output sizes - a selection of default output window sizes
- Bring All to Front

The output window can also be controlled using the eOutput plug-in. You can also set the output window to full
screen mode by right-clicking (or ctrl-click) the EboSuite icon in the Dock in the Finder.

!11
 Video codecs

EboSuite can handle many video codecs, like Hap, H264, ProRes, MPEG-4, DV and Photo-JPEG. We
recommend you to try out different codecs, compression settings and image sizes to find out what works best in
your situation and with your hardware configuration.

Important note: Choosing the right codec and compression settings is crucial for optimal performance and
reliability of EboSuite. Only the Hap codec is optimised for live video applications, so we recommend you to use
Hap encoded videos. You’ll need an SSD drive to playback Hap properly.

Hap is a video codec that is optimised for live video mixing, triggering and manipulation. This codec offers you the
best performance and reliability in EboSuite. There are four variations of the Hap codec: Hap, Hap Q, Hap Alpha
and Hap Q Alpha. Hap Alpha and Hap Q Alpha support an alpha channel (transparency), Hap and Hap Q do not.
The file size of a Hap compressed video is typically large. Since video decompression is handled by the GPU, a fast
GPU (graphics card) is needed for good performance. Since data streams are large, a fast harddisk (SSD drive
recommended) as well.

Use EboSuite’s eConvert plug-in to convert your video files to the Hap or Hap Alpha codec within Ableton Live
and load them directly in the eSampler or on an audio track in Session View. You can read more about the
eConvert plug-in here. You can convert multiple videos at once with the AVF Batch Converter.

Hap is not supported by Mac OS by default. You don’t have to install the Hap codec to work with EboSuite, but
we recommend that you install the HAP codec anyway to be able to playback Hap encoded videos in Ableton
Live’s Arrangement View and with QuickTime player 7 (unfortunately not in the latest version of QuickTime
player). You can read more about the Hap codec here.

Apple ProRes is used by many professional video editors and motion graphic designers, but is not optimised for
live video mixing, triggering and manipulation. There are five variations of the ProRes codec: ProRes 422, ProRes
422 LT, ProRes 422 HQ, ProRes 422 Proxy and ProRes 4444. ProRes 4444 supports an alpha channel
(transparency), the ProRes 422 variations do not. When you don’t need an alpha channel we advice you to use
ProRes 422 LT. The file size of a ProRes compressed video is typically medium to large. A fast CPU and harddisk
(SSD drive recommended) are needed for good performance when playing/mixing multiple videos at the same
time.

H264 is a very popular codec, but is not optimised for live video mixing, triggering and manipulation. H264 does
not support an alpha channel (transparency). The file size of a H264 compressed video is typically small. The
compression settings (quality/data rate/image size) have a big impact on the performance of H264 videos in
EboSuite. We recommend you to try out different compression settings and image sizes to see what works best in
your situation and on your system. A fast CPU is needed for good performance when playing/mixing multiple
videos at the same time. Because the data streams are small H264 works pretty good on HDD drives, but a SSD
drive is recommended.

MP4 is a container, not a codec. A MP4 file can contain different video codecs, but H264 is very common. Use
OSX Finder’s ‘Get Info’ option (CMD-i) to determine a video file’s codec.

!12
 EboSuite plug-ins

eClips

Use the eClips plug-in to add video playback functionality to Ableton Live’s Session View. Drag video files into
Session View clip slots and play and treat them like audio clips (edit Warp markers, loop points, start/end point
etc.).

Adding an eClips plug-in to your Live set

To add an eClips plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library within
Ableton Live to an audio track. An eClips plug-in can only be used on an audio track in Session View.
Note: The eClips plug-in only works with clips on audio tracks in Session View. Use the eArrangement plug-in
to use movie clips on audio tracks in Arrangement View.

Using eClips for the first time

When you use the eClips plug-in for the first time, Ableton Live will show an error message warning you that
Session View does not support video playback. But that is exactly what the eClips plug-in will add! To avoid this
interruption in the future please select ‘Don’t show again’ and press ‘OK’. Now you won’t see this warning ever
again and rightfully so, because thanks to EboSuite Session View supports video playback now.

!13
Loading a video
Simply drag a movie file into a Session View clip slot to play it in Session View. The audio track will be played by
Ableton Live, the video track by the EboSuite application. Many video codecs are supported, but the Hap video
codec is preferred, since this video codec is optimised for live video playback (see the section about video
codecs).

Warping, looping, editing

Using the eClips plug-in enables you to treat video files like audio clips and edit their Warp markers, loop points,
start/end points etc.
Note: When you use Live 9 or 10 you’ll need to press the ‘save’ button in the Sample section of the audio clip
playback properties each time you edit/change the Warp markers. See the ‘Using Warped clips’ section of this
manual for more information.

Opacity Mode
The opacity of the video is automatically linked to the volume slider of Ableton Live’s audio mixer. A lower volume
will result in a more transparant video (fade out). You can control the video opacity manually by setting it to
Manual in the eClips interface.

!14
 eArrangement

Use the eArrangement plug-in to use videos on audio tracks in Ableton Live’s Arrangement View and manipulate
them with visual effects and mix them with other video tracks.
Important note: the eArrangement plug-in only works in Live 11!

Adding the eArrangement plug-in to your Live set

To add an eArrangement plug-in to your Live set just drag the eArrangement plug-in from the EboSuite folder in
the User Library within Ableton Live to an audio track in Arrangement View.
Note: The eArrangement plug-in only works with clips on audio tracks in Arrangement View. Use the eClips
plug-in to use movie clips on audio tracks in Session View.

Loading a video
Simply drag a movie file on the audio track in Arrangement View. The audio will be played by Ableton Live, the
video track by the EboSuite application. Many video codecs are supported, but the Hap video codec is preferred,
since this video codec is optimised for live video playback (see the section about video codecs). When you load a
movie file on an audio track in Arrangement View for the first time, Ableton Live’s Video Window will open
automatically. You can close this window, since video playback will no be handled by the EboSuite application and
will be visible in the EboSuite output window.

Warping, looping, editing

Using the eArrangement plug-in enables you to treat video files like audio clips and edit their Warp markers, loop
points, start/end points etc.

Opacity Mode
The opacity of the video is automatically linked to the volume slider of Ableton Live’s audio mixer. A lower volume
will result in a more transparant video (fade out). You can control the video opacity manually by setting it to
Manual in the eArrangement plug-in’s interface.

!15
 eSampler

The eSampler is a fully functional video sampler. Drag audiovisual clips into the sampler and produce video beats
and melodies, trigger videos live, simulate video scratching or use it in ‘Video only’ mode to visualise your own
sounds.

Adding the eSampler to your Live set

To add an eSampler to your Live set just drag the eSampler plug-in from the EboSuite folder in the User Library
within Ableton Live to a MIDI track. An eSampler can only be used on a MIDI track. You can use up to 127
eSamplers on one track using a Drum Rack. The eSampler can be used in both Arrangement View and Session
View.

Loading a sample
The eSampler accepts many video codecs, like H264 and ProRes, but the Hap video codec is preferred, since the
eSampler is typically used for advanced video triggering and the Hap video codec is optimised for that. You can
convert the loaded video sample (region of the clip) into the Hap codec within the eSampler using the File Region
Editor.

Video/audio files of any duration can be loaded in the eSampler, but the audio track will be ignored of samples
longer than two minutes (and an error message will be shown). Samples longer than one minute will trigger a
warning message. We recommend to edit long files to short samples to save memory space. You can do that with
an external video editor (like Quicktime Player 7 Pro) or by loading a video on an audio track in Arrangement
View or in a clip slot in Session View and set the start and end marker before dragging it into the eSampler (read
the section below for more detailed information about this) or you can use the File Region Editor to shorten (or
lengthen) the loaded sample.

There are four ways to load a video/audio file into the eSampler:
- drag a Hap encoded video file directly from the Finder into the eSampler. Make sure to drag the video in the
dropzone of the eSampler’s interface. If you drop the video file outside of the eSampler (e.g. in a cell of a
Drum Rack), Ableton Live will automatically replace the eSampler for a Simpler and load the audio track of the
video file in the Simpler (in this case select ‘undo’ to go back). Make sure the video file is not too long.

!16
- convert a video file with EboSuite’s eConvert plug-in to the Hap of Hap Alpha codec and then drag it from
eConvert’s interface into the dropzone of the eSampler. Read more about the eConvert plug-in and exporting
to the eSampler and eClips plug-ins here.

- load a Hap or Hap Alpha encoded video file into an audio track in Arrangement View (Hap codec needs to be
installed to view Hap encoded videos in Live’s standard video window). Edit the start and end point to select
which part you want to load in the eSampler. Simply drag the video clip into the eSampler’s dropzone. This is a
great way to cut a video file into shorter video samples to save memory.

- load a Hap encoded video file in a clip slot of an audio track with an eClips plug-in loaded in Ableton Live’s
Session View. Edit the start and end point to select which part you want to load in the eSampler. Simply drag
the video clip into the eSampler’s dropzone. This is a great way to cut a video file into shorter video samples to
save memory.

Video files without an audio track

When you load a video without an audio track in the eSampler (or a video longer than 2 minutes, so the audio track will be
ignored) a warning will be shown in the interface. Plus, a grid will be shown in the audio waveform display to give feedback
about the zoom level and postion of the start cursor.

!17
Go back to the original source video file of a cropped video clip
You can easily go back to the original video file that the cropped video sample is part of. Just drag the file name
from the eSampler’s interface (in the audio waveform section) to a clip slot in Session View or on an audio track
in Arrangement View. This will load the original longer video file with the start and end markers set to the
beginning en end points of the sample. This way you can easily adjust the start and end point of the cropped video
sample or cut another video sample out of the longer video file.

Trigger video samples

After loading a video file in the eSampler you can trigger this video sample with MIDI notes from a MIDI clip on
the MIDI track that the eSampler is loaded on (or a track that is routed to this track (see the Ableton Live’s
manual for more information about MIDI routings)) or with an MIDI keyboard, drumkit, Push or any other MIDI
controller that sends out MIDI notes.

When only one eSampler is loaded on a MIDI track, the eSampler will be mapped to the entire keyboard of your
MIDI controller. Use Ableton Live’s MIDI effects to change this mapping. Using a Drum Rack you can assign
multiple eSamplers to different keys and key ranges.

Zoom in/out
There are two ways to zoom in and out on the audio waveform display:
1. Use the + and - icons in the audio waveform display.
2. Command-click in the audio waveform display and move the mouse up/down. To move the zoom area move
the mouse to left and right.

The zoom level will be shown next to the - and + buttons in the display. When the mouse pointer is positioned on
the audio waveform display, the time (in ms) of the beginning and end of the zoomed area will be shown in the
upper corners of the display. Click the - - button in between the -/+ buttons to reset the zoom level back to 0.

Editing Start point

There are two ways to change the start position of a sample:
1. drag the 'Start' dial (hold CMD for finetune)
2. click in the waveform

Pitching and tuning

Turn on tuning to be able to play a melody or to (fine)tune your sample’s pitch. When changing the sample’s pitch
the playback speed will not be affected. The eSampler is equipped with various playback options to manage pitch
sound quality and CPU usage. The different modes are:

!18
Pitch modes: Quality modes:
- Tuning off - Basic
- Basic - Good
- Monophonic - Better
- Rhythmic - Basic + Formant
- General - Good + Formant
- Efficient - Better + Formant
- Granular

The ‘Formant’ Quality modes will result in a more natural sound when pitching voices, but are more CPU intensive. The
‘Efficient’ Pitch mode will is the least CPU intensive mode, but introduces a slight latency in the audio.

Note: when Basic, Monophonic, Rhythmic, General or Efficient mode is selected Loop Start can’t be changed (and
therefore will be the same as Start).

Granular mode
When Granular mode is selected the audio of the movie file will be split into grains, opening up new ways to creatively
manipulate the video sample. Control playback speed in real time and control the grains of the audio file separately.
The interface of the eSampler will unfold, revealing the grain controls, when Granular mode is selected. The grain
controls are:
- Grain size - control the size of the grains in real time. This will have great effect on the sound of the
sample. A small size will result in a harsher, glitchy sound.
- Grain Overlap - this will make the sound smoother
- Stereo Spread - grains will be spread out of the stereo spectrum, creating a rich, full sound.
- Position Randomness - this will have great effect on the sound of the sample. Large numbers will
result in a noisy, but rich and full sound. Small numbers will result in a smooth sound in combination
with a large grain size. In combination with a small grain size a small position randomness will result in a
very noisy sound.
- Maximum number of grains - more grains will make the sound smoother, but CPU usage heavier.
- Number of grains used - more grains will make the sound smoother, but CPU usage heavier.

Note: when Granular mode is selected Loop is disabled.

!19
 Watch the tutorial video about the Granular Playback Mode here

Speed
Use the Speed dial to control the video sample’s playback speed in real time. When tuning is disabled, changing the
speed will also affect the pitch, similar to pitch bending. When tuning is enabled, changing the speed will not affect the
pitch, similar to time stretching. When tuning is enabled the minimum playback speed is 0.1x the original speed and the
maximum playback speed is 3.5x the original speed. This speed value is combined with the speed value determined by
the warp markers. The combined value can not be higher or lower than 0.1x or 3.5x the original speed. This can lead to
unexpected behaviour. When tuning is disabled the the minimum playback speed is 0 and the maximum playback
speed is 3.5x the original speed.

Warped video
If a warped clip is dragged into the eSampler the warp option appears (this will not appear when you drag a file from the
library or finder). A copy is made of the warping information that is stored in the .asd file at the moment of dragging.
Engaging warp means that it will time stretch the video, so that it plays according to the current tempo (please note
that changing the tempo while a note is held is not supported yet). Tuning must be on to enable the timestretch/
pitching engine, and the tuning mode that is chosen will affect the sound (and cpu load) of the warped result.

Playback modes: Normal, Loop, OneShot, Slices

The eSampler has 3 playback modes, which can be selected using the Playback mode dropdown menu:
- Normal Playback
- Looped Playback
- OneShot Playback
- Slices

!20
Normal Playback - Samples will play without looping and stop when a note off message is received. Note: warping is
only possible in this mode.

Looped Playback - When this mode is selected a portion of the loaded sample region is repeated. The start of this
region is indicated with the LoopStart parameter and the loop end is determined by the LoopLength parameter. The
LoopStart cannot be changed during a note, it is applied at the start of each note. The LoopLength can be changed
immediately if the LoopStart is zero, otherwise it is also applied at the start of the next note (the label of the parameter
will become grey if it cannot be applied immediately). The LoopLength and the LoopStart can be set by changing the
parameters with the mouse or by dragging the triangles in the waveform view.

You can choose between three Loop Modes which determine the range/values of the LoopStart and LoopLength
parameters:
- Absolute: this allows you to set the Loop parameters in milliseconds with a maximum of 2000ms.
- Relative: the value of the Loop parameters is now presented as a percentage of the available time. This means
that changing the starttime will change the LoopLength (and that changing the LoopStart will also change the
LoopLength)
- Synced: in this Loop Mode the LoopStart and LoopLength is linked to the current tempo (please note that
changing the tempo while a note is held is not supported yet).

OneShot Playback - When this mode is selected the note length is defined by the Duration parameter instead of the
note off message. The grey area in the waveform display visualizes the duration time (see below). The duration time can
be edited using the dial or by dragging the end of the grey area. Duration time is defined as a percentage of the
sample’s area between start point and sample end. Note that when Legato is enabled, samples loaded in different
eSamplers (in a drum rack for example) will cut each other off, which is useful for different applications (finger
drumming for example).

!21
Slices - When this mode is selected the eSampler will create multiple start points (slices) and map these slices to
different midi notes (from C1 and up). You can always manually add/delete slices by Alt+Clicking in the waveform.

Use the ‘Fill Slices’ button to create slices. After clicking this button a menu will appear, offering four ways to create
slices:
- Analysed - EboSuite will analyse the current audio buffer and create slices
automatically using the sample start as the start point of the analysis.
- Transients - Transients in the audio file, detected by Ableton (and stored in
the .asd file), will be used to create slices. Note: you need to edit the
transients manually and store them before EboSuite can use them. Read
below how to do this.
- Warp Markers - The Warp Markers stored in the .asd file are used to create
slices.
- 1/4 Beats - Slices are created on every 1/4th beat, according to Live’s
current overall BPM setting. Slices are created from the sample start point.
- 1/8 Beats - Slices are created on every 1/4th beat, according to Live’s current
overall BPM setting. Slices are created from the sample start point.
- Clear - When you select this option, all current slices are deleted.

When the slices are created you can add more slices or delete slices by Alt+Clicking in the waveform.

You need to edit transients manually and store them before EboSuite can use them to create slices. This is due to the
fact that Ableton doesn’t allow direct access to the transients unfortunately. To edit the transients load the video on an
audio track and open the sample section of the clip editor. When Warp is enabled, the transients are visible above the
audio waveform. Ctrl+Click on a transient and select ‘Delete Transient(s)’. Deleting a transient and pressing ‘Save’, will
update all current transients in the .asd file so EboSuite can use them to create slices.

Playback will stop automatically when the end of a slice is reached, even if a MIDI Note Off message has not been
received (‘the key/note is still pressed’), unless ‘Thru’ is enabled. When ‘Thru’ is enabled playback will continu until a
MIDI Note Off message is received (‘the key/note is released’).

!22
When ‘Gate’ is set to ‘Trigger’, playback will continu until the end of the sample even if a
MIDI Note Off message is received. Playback will only stop when an other MIDI Note On
message is received (another slice is triggered).

When Legato is enabled, audio and video playback will be stopped when another eSampler/eSimpler is triggered in the
same Drum Rack. When Legato is disabled, audio playback will continu and video playback will be interrupted when
another eSampler/eSimpler is triggered in the same Drum Rack. Video playback will continu when the interrupting
sample finishes before the earlier triggered sample is finished (see ‘Playing multiple videos on one MIDI track’ below).

Note: when slicing is enabled, tuning is automatically disabled (including the granular playback mode). Currently
sliced samples can not be tuned.

Each slice can have different settings for 11 parameters. This means that you can have,
for example, a different gain, speed, panning, pre-roll and freeze-time for each
individual slice. This gives you much more creative control over the slices. For three
parameters (Tune, Speed and Gain), these settings are relative to the general setting
(added/subtracted). The other parameters will overwrite the general setting.

Press the Follow button to enable Auto Select. When Auto Select is enabled, an
incoming MIDI note will select the slice mapped to that note.

When the Preview Slice button is enabled, slices will be triggered (played) when
they are selected. Use the < and > buttons next to the Preview Slice button to
select the previous or next slice.

Slice editing
- Click on a slice to select a slice
- ALT-Click in the waveform to add or delete a slice
- CTRL-Click near the selected slice to move it
- CMD-Click+vertical drag in the waveform to zoom in/out
- CMD-Click+horizontal drag in the waveform to move through the waveform

TIP: Use 1/4 Beats and 1/8 Beats slice modes to play long video files.
Many people ask us if we can make videos on audio tracks in Arrangement View playable in EboSuite. Unfortunately
EboSuite can’t support this because Ableton doesn’t give us enough access to what is happening in Arrangement View.
But you can use the 1/4 Beats and 1/8 Beats slice modes to play long video files more easily and to do basic video
editing (like you are use to with videos on audio tracks in Arrangement View). Place 1/4th or 1/8th notes chromatically
in a MIDI clip. When the clip is played the slices will be stringed together to form the entire video. When you start clip
playback half-way, the video will start half-way (like videos on audio tracks in Arrangement View) and not from the
beginning.

!23
Copy and duplicate parts of the clip to do basic video editing.

You can adjust the beginning and end of the clip, because Live remembers the notes before and after clip start/end.

This way you can use EboSuite and all it’s realtime effects and mix features in a more conventional ‘video editing’ way.

Pan
Change the panning of the sample’s sound by dragging the 'Pan' dial.

Gain
Change the gain of the sample’s sound by dragging the 'Gain' dial.

ADSR
The eSampler is equipped with an audiovisual ADSR. Changing the ADSR values with the corresponding ‘ADSR’
dials will change the Attack, Decay, Sustain and Release time of the velocity of the sound and opacity of the
video simultaneously.

!24
Vel to opacity
When ‘Velocity to opacity’ is enabled the opacity of the video will change simultaneously with the velocity of the
incoming MIDI note (and therefore the sound).

Env to opacity
When ‘Envelope to opacity’ is enabled the opacity of the video will change simultaneously with the ADSR’s
velocity shape.

Legato
When ‘Legato’ is enabled samples will continu playing until another sample is triggered.

Video only / Audio only / Audio+Video

In ‘Video only’ mode the sound of the sample will be disabled, in ‘Audio only’ mode the video of the sample will be
disabled. ‘Audio+Video’ mode is the default mode. When a video file without audio track is loaded a warning will
be shown and the eSampler will automatically switch to ‘Video only’ mode.

Freeze
Use the Freeze dial to freeze the last or first frame of the sample when playback is finished. The last frame will
freeze when the dial is set to a positive value (freeze 0 to 1000 ms). When the dial is set to the maximum positive
value the last frame will freeze indefinitely. The first frame will freeze when the dial is set to a negative value
(freeze 0 to 1 second). When the dial is set to the maximum negative value the first frame will freeze indefinitely.
Note: ‘Env to Opacity’ should be disabled to see this

VOffset
Use the VOffset dial to change the synchronicity between the audio and video track of a sample to correct an
error in synchronicity or for artistic reasons, like to focus on a certain action or to add variation. Use the dial to
delay or advance the video track -1000 ms. to +1000 ms.

!25
PreRoll
When PreRoll is enabled a note with velocity 0 will play back the sample with an altered start time. The time
defined by the PreRoll dial is subtracted from the sample’s start time. This will make the sample start at an earlier
point in the video clip, showing the events leading up to the original sample start. This is very useful to show a
sample in it’s full context. When the dial is set to 0, PreRoll is disabled. When the dial is set to a value higher than
0, PreRoll is enabled and notes with velocity 0 will act as ‘PreRoll notes’.

Example: When a hammer hits a log, the impact sound starts at the moment that the hammer touches the log.
Therefore it is obvious to set the start point at this moment in time. But visually you will lose a vital part of the
visual: the hammer heading towards the log. By setting a PreRoll time and adding a note with velocity 0 before
the original note, the events before the original note are revealed. The hammer will move towards the log
(PreRoll note) and then hit the log (original note).

A PreRoll note plays back the visual part of the sample only, not the sound. Try different PreRoll times to find
the right visual effect. If you choose a high PreRoll time, but place the note close to the original note, the visual
effect will get more ‘cartoony’ and a visual rhythm will look more ‘snappy’.

Watch the tutorial video about Pre Roll here

!26
Racks
Up to 127 eSamplers can be loaded into a Drum Rack. Load an empty Drum Rack and fill its pads with eSamplers
or right-click on the titlebar of the eSampler and select ‘group to Drum Rack’ to create a Drum Rack (read more
about Drum Racks in the Ableton Live manual).

File Region Editor

Click the arrow in the lower right corner of the eSampler’s interface to reveal the ‘File Region Editor’. Use this
editor to increase or decrease the length of the loaded region of the current file, while maintaining the start
position and other settings. You can also use the File Region Editor to convert the currently loaded video sample
(the loaded region of the source video) to the Hap video codec.

Decreasing the length will free up RAM. This is especially useful when only a small part of the loaded file is used in
the composition and you need to free up RAM space to load more samples. This makes it easier to work with
lengthy video files in the design phase of the composition process, giving you the flexibility to try out different
start points in a file. In a later stage, when it is clearer which portion of the files will be used in the composition you
can easily remove the unused parts.

You can also set the region in point before the beginning of the loaded region by entering a negative value in the
number box. This will increase the length of the region. Increasing the length will reveal the events that are
happening in the parts of the file that were not loaded initially. This makes it easy to search for other parts of the
file that might be interesting to use in your composition.

!27
Use the number boxes to set the new start and end point. Clicking the Load New Region button will reload the
file with the new start and end time. Clicking the Load Complete File button will load the complete source file. In
both cases the start time and other settings will not change. Because the parameter settings remain the same,
changing the file region will not affect the composition, except for the behaviour of the OneShot Duration and
the loop length in Relative Looped Playback mode, since the length/duration in these two cases is related to the
time between the start point and the end of the file.

File Region Editor - Convert to Hap

When the Convert to Hap button is pressed, the eSampler converts the currently loaded video sample to the Hap
video codec. This will create a new video file next to the original video file on your harddisk. The eSampler will
automatically replace the loaded video sample with this newly created Hap encoded video file. We recommend
you to convert video samples that you use a lot, use for advanced video triggering or combine with many other
samples simultaneously. The Hap video codec is optimised for live video and therefore will offer you the best
performance and reliability in EboSuite when you are using a Solid State Drive (SSD).

Watch the tutorial video about the File Region Editor here

Link
Use the eSampler’s link feature to trigger multiple eSamplers at the same time. This is be useful for different
cases. For example to add audio to your video sample to enhance the sound or to add sound to a silent video.
Another use would be to trigger multiple eSamplers on different audio tracks simultaneously to create polyscopic
video sample groups.

To link an eSampler to another eSampler do the following:

First open the Link Editor by clicking on the arrow icon in the lower right corner of the eSampler’s interface.

Now, press the ‘Link’ button. This will trigger the eSampler (1) to ask you to select an eSampler (2) to link to.
Navigate to the eSampler (2) you want this eSampler (1) to link to. When you’ve selected this eSampler (2),
Ableton will jump back to the linked eSampler (1) and the button will now show the option to break the link,
‘Unlink’.

!28
This eSampler (1) will act as a slave to the eSampler (2) you have linked it to (the master). The master eSampler
(2) will now send all incoming MIDI triggers to the slave eSampler (1). In the slave eSampler the Tune, Speed and
Loop dials/pop-ups will be disabled. The slave eSampler will use the Tune, Speed and Loop settings of the master
eSampler. Click on the Show Master button to move quickly to the master. Use the Tune Offset number box to
change the slave’s tuning relative to the master. You can link any eSampler on any audio track with each other.

Load in RAM
When Load in RAM is enabled the video will be loaded into RAM and playback from RAM instead of streamed
from harddisk. This is particularly useful when harddisk speed is limited and therefore is causing problems when
playing multiple large video files simultaneously (like Hap encoded videos).

Playing multiple videos on one MIDI track

A Drum or Instrument Rack enables you to use multiple eSamplers on a single MIDI track. When triggering
multiple eSamplers at the same time on a single MIDI track, the sound of all video samples will be audible, but
only the video of the last triggered sample will be visible. When a sample is triggered while another sample is
playing, the sound will be mixed in with the sound of the first played sample, but the video will interrupt the video
playback of the first played sample. When the second sample is stopped while the first sample is still playing the
video of the first sample will be visible again.

!29
 eSimpler

Use the eSimpler plug-in to turn Ableton’s Simpler into a video sampler. Or use it without a Simpler as a very
light video sampler to keep your Live set undemanding and quick to load.

Adding an eSimpler plug-in to your Live set

To add an eSimpler plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to a MIDI track. An eSimpler plug-in can only be used on a MIDI track.

Using the eSimpler in combination with the Simpler

When the eSimpler is placed in front of a Simpler on a MIDI track, the eSimpler will automatically check if a
movie file is loaded in the Simpler. When a movie is loaded the eSimpler will automatically load the movie file and
set the playback position correctly. When a MIDI note is received, the eSimpler will playback the video, while the
Simpler plays the audio, effectively turning the Simpler into a video sampler.

Vel to Opacity
When ‘Velocity to opacity’ is enabled the opacity of the video will change simultaneously with the velocity of the
incoming MIDI note (and therefore the sound).

1-Shot
The eSimpler will notice when the Simpler is set to 1-Shot mode. The eSimpler will automatically switch to 1-Shot
as well and use the same duration time as selected in the Simpler.

!30
Warping
The eSimpler will notice when Warping is enabled in the Simpler. The eSimpler will automatically read the Warp
Markers of the file (in the .asd file) and Warp the video.

Because the eSimpler relies on the default information stored in the .asd file you can not use the
x2, :2 and ‘warp as’ buttons. This limitation is due to the restrained access Ableton gives to the
Simpler’s parameters.

Looping
The eSimpler will notice when Looping is enabled in the Simpler. The eSimpler will automatically read the Loop
settings and loop the video according to the settings in the Simpler.

Slicing
Slicing is not supported yet. This limitations is due to the restrained access Ableton Live gives to the Simpler’s
parameters. When slicing is selected, the eSimpler will show a warning notification, because this might mean audio
and video are out of sync. Click on the warning notification button to turn Slicing off.

Freeze
Use the Freeze dial to freeze the last or first frame of the sample when playback is finished. The last frame will
freeze when the dial is set to a positive value (freeze 0 to 1000 ms). When the dial is set to the maximum positive
value the last frame will freeze indefinitely. The first frame will freeze when the dial is set to a negative value
(freeze 0 to 1 second). When the dial is set to the maximum negative value the first frame will freeze indefinitely.

Using another movie file in the eSimpler

It is also possible to load a different movie file into the eSimpler. In this case the eSimpler will not automatically
set the start position. The start position should be set manually using the ‘Start’ dial.

Using the eSimpler without a Simpler

The eSimpler will also work without a Simpler next to it. This way you can use the eSimpler as a very light video
sampler (without audio output) to keep your Live set undemanding and quick to load.

Watch the tutorial video about the eSimpler here

!31
 eISF

The eISF plug-in enables you to use ‘ISF shaders’ in your Live set. The eISF plug-in is optimised for generative
shaders. The eFX-ISF plug-in is optimised for filters/FX shaders.

Adding the eFX-ISF plug-in to your Live set

To add the eISF plug-in to your Live set, just drag the plug-in from the EboSuite folder in the User Library within
Ableton Live to a MIDI/audio track.

What are ISF shaders?

ISF shaders are pieces of code that deform an incoming video stream or generate visuals. Learn more about ISF at
https://www.interactiveshaderformat.com/about.

How to use ISF shaders

There are more than 1500 ISF shader files available at https://www.interactiveshaderformat.com. You can easily
download these shader files and load them into the eISF or eFX-ISF plug-ins. The eISF plug-in will automatically
generate an interface that suits the functionality of the shader file, so you can control it live in your Live set and
automate it’s behaviour.

!32
Downloading ISF shader files
It is very easy to download ISF shader files. Goto https://www.interactiveshaderformat.com and log-in with your
Facebook account. Now, look for an ISF shader you like. You can easily try out the shaders on the ISF website.
When you found an ISF shader you like, press the download button in the top menu bar next to your user name.
Note: the ISF website has recently been updated. This manual describes the old website, but the basic principles
are still the same.

!33
Importing ISF shaders into the eISF and eFX-ISF plug-ins
Collect downloaded ISF shaders in EboSuite’s ISF folder. You’ll find this folder in the eFX folder residing in the
EboSuite folder. So, the file path of this folder is:

ISF shaders in this folder will automatically appear in the file browser of the eISF and eFX-ISF plug-ins. You can
organise the shader files in sub-folders. User the update button to update the browser when you made changes to
the folder structure or when you added new files.

The ISF shaders browser

Use the shader browser in the ISF plug-ins to find and load a shader into the ISF plug-in. The shader browser
consists of four sections:
1. Folder Selection Menu - Use this menu to search and select a folder in the EboSuite/eFX/ISF folder. Select a
folder from the list, or select ‘Go directory higher’ to move one folder up.
2. ISF Shader-type Selection Buttons - Use the 'FX' or 'Generator' buttons to filter out FX shaders or generator
shaders, so only they will show up in the Shader Selection Menu.
3. ISF Shader Category Selection Menu - Available categories for the selected shader-type will be shown in this
list. Select a category to filter out shaders, so only these shaders will show up in the Shader Selection Menu.
4. Shader Selection Menu - Use this menu to find and select an ISF shader.

Use the refresh button (5) to reload the currently loaded ISF shader and refresh the Shader Selection list.

Set the render resolution

Use the Render Resolution Menu to determine at what resolution the ISF is
rendered. You can choose to match this with your current render resolution of
EboSuite output window or choose a lower or higher resolution. ISF shaders can be
demanding for the GPU to process, so try out different render resolutions for
optimal performance.

Opacity
Use this menu to determine how the opacity is controlled. You can choose to set the opacity manually (or with
automation) or link opacity to the tracks volume or to the clip start/stop.

!34
Controlling ISF parameters
The eISF and eFX-ISF plug-ins will automatically generate an interface that suits the ISF shaders behaviour.

All interface elements can be automated or controlled live. Hoover over de parameter name to see the name as it
will appear in the automation parameter menu.

Editing ISF shaders

You can edit the ISF shaders easily within Ableton Live. Each time you save your edits they will be applied directly,
so you can check the effect of your work immediately in Live. You can edit the shaders in two ways:
- in the ISF plug-ins themselves
- in the ISF Editor developed by VIDVOX (the creators of ISF)

Editing ISF shaders in the ISF plug-ins

Click on the ‘Show code and credits’ button to view the shader code and information about the author. You can
edit the code in this window, making it very easy to fine-tune your shader or to make alterations to an existing
shader to make it fit perfectly in your composition.

When the code viewer is opened a few new interface elements will appear in the ISF plug-in’s interface.

!35
Use the ‘Save’ button to save your edits. The shader will be reloaded and your changes will be applied directly. This
means that added interface elements (like sliders, buttons, menu’s etc.) will appear in the ISF plug-in’s interface
directly and new functions or altered variables, constants etc. in the code will be used immediately to generate the
image. Note: the code viewer doesn’t give feedback about errors and there is no undo function. Use the ISF
Editor (see below) for more advanced editing.

Use the ‘Copy UI code’ menu to copy the code necessary to add a slider, toggle, menu, color
selector or button. Once a menu item is selected the code is copied to the copy buffer and you
can paste it into the shader code using the CMD-v keyboard shortcut. Once the altered shader
is saved the interface elements will immediately appear in the ISF plug-ins interface.

Use the ‘Save as new’ button to save a copy of the shader. This newly created copy will be placed in the same
location as the original shader and will be loaded in the ISF plug-in. We recommend you to use this ‘Save as new’
feature to create a copy of your shader before editing it.

Editing ISF shaders in the ISF Editor

Click on the ‘Open in ISF Editor’ button to open the shader in the ISF Editor developed by VIDVOX, the
creators of ISF. To use this feature you’ll need to have version 2.9.9 (or later) of the ISF Editor installed. Click on
the ‘?’ button to download version 2.9.9.

!36
The ISF Editor is a separate application, but each time to you save your edits the shader will automatically be
reloaded and updated in the ISF plug-in. Your changes will be applied directly and the interface will change
according to your edits. This way, you see the effect of your work immediately in Ableton Live.

Use the ‘Make Duplicate’ button to create a duplicate of the shader. This newly created copy will be placed in the
same location as the original shader and will automatically be loaded in the ISF plug-in. We recommend you to
use this ‘Make Duplicate’ feature to create a copy of your shader before editing it.

Tips for Getting Started

There are some great online resources for learning how to write your own shaders and ones that can be used as
starting points for remixes:

ISF Documentation: Quickstart / Reference / Conversion Tips

Introductions to GLSL: The Book of Shaders / Fragment Foundry
2D SDF functions: Pixel Spirit Deck / Pixel Spirit Deck in ISF
Ray Marching: Jamie Wong tutorial
Remixing: ISF sharing site / Shadertoy / GLSL Sandbox
Advanced topics: Inigo Quilez articles / ISF Primer
Also be sure to try Google search :))

Standard ISF shaders

Currently EboSuite comes with 253 standard shaders. Three shaders developed by EboStudio (Blending Boxes,
Texture Deform and Tunnel) and 250 shaders developed by VIDVOX (the creators of the ISF format).

You’ll find three other shaders developed (remixed) by EboSuite on the EboSuite channel on the ISF website.
https://www.interactiveshaderformat.com/u/ebosuite. You can easily download these shaders and add them to
your EboSuite ISF library (see description above).

Watch the tutorial video about the eFX-ISF plug-in here

!37
 eVideoIn

Use the eVideoIn plug-in to use the video stream of a webcam, iPhone or iPad in EboSuite.

Adding an eVideoIn plug-in to your Live set

To add an eVideoIn plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to a MIDI/audio track. You can use multiple eVideoIn plug-ins in your project to connect
multiple cameras or iPhones/iPads.

Selecting the video input source

Use the upper dropdown menu to select the video input source. Connected cameras and iPhones/iPads will
automatically appear in this menu. When a selected device is not available anymore, ‘Unavailable’ will appear after
it’s name.

Selecting the resolution

When a video input source is selected you can select the resolution of the incoming video stream in the lower
dropdown menu. You can choose a High, Medium or Low preset, that will result in a device specific preset value of
the resolution. Alternatively you can request a custom resolution, but there is no guarantee you will achieve the
exact resolution you request, because it might not be supported by your device. EboSuite will automatically select
the resolution supported by your device that is closest to the requested resolution.

Preview window
Use the ‘Enable Preview’ toggle to activate and open the preview window. You can make it stay on top of other
windows (like Ableton Live’s interface) by enabling ‘Preview Always On Top’.

Link Opacity To Volume

When Link Opacity To Volume is enabled, the volume fader of the track will control the opacity of incoming video
stream. Disable this feature to control opacity manually or with track automation.

!38
 eText2Syphon

Use the eText2Syphon plug-in to send the name of clips as a video stream through Syphon to the eSyphonIn
plug-in (to use it in your video mix) or to other video applications that support Syphon.

Note 1: You’ll need an eSyphonIn plug-in on a MIDI/audio track in your Live set, to receive the Syphon stream
generated by this plug-in to be able to use it in your video mix.

Note 2: You can use this plug-in stand-alone, without the EboSuite application, to send text from Ableton Live
to any video application that supports Syphon.

Adding an eText2Syphon plug-in to your Live set

To add an eText2Syphon plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to a MIDI/audio track.

Editing text
The eText2Syphon plug-in reads the name of the playing clip on the
track it is loaded on. So to edit the text, simply edit the names of the
clips on the track. Trigger the clips to send the text (the clip name) to
any Syphon receiving application.

Using the text in your video mix

The eText2Syphon plug-in sends text through Syphon to Syphon receiving applications. The track name is used as
the Syphon stream name. Change the track name to set the Syphon stream name. To receive the Syphon stream
in your video mix, load an eSyphonIn plug-in on any track in the Live set (for example on the track where the
eText2Syphon plug-in is loaded) and use the Syphon stream menu to select the stream from the eText2Syphon
plug-in.

!39
Set the text color
There are two ways to set the text color. When Color type is set to ‘Clip Color’, the
color of the clip is used to set the text color. When color type is set to ‘Custom’, you
can use the color picker to set the text color.

Set the render resolution and preview window

You can set the text resolution independently from EboSuite’s output
resolution. This setting determines the resolution of eText2Syphon’s Syphon
stream. Enable the ‘Window’ checkbox to open a preview window.

!40
 eTrackTransform

With the eTrackTransform plug-in you can position, scale and rotate individual video tracks to arrange them.

Adding the eTrackTransform plug-in to your Live set

To add the eTrackTransform plug-in to your Live set just drag the plug-in from the EboSuite folder in the User
Library within Ableton Live behind a video track (a MIDI/audio track with an eSampler, eClips, eSyphon or
eVideoIn plug-loaded).

Multiply
Use the Multiply parameter to increase or decrease the range af the position/scale/rotation dials.

Smooth
Use the Smooth parameter to even out the motion of the position/scale/parameter. Increasing this parameter will
make the eTrackTransform plug-in smoothen value changes to reduce noise and to create a more continuous,
fluent, natural motion.

Uniform Scale
Enabling Uniform Scale lets you change the width and height of the video track separately.

!41
 eBlend

Use the eBlend plug-in to mix video tracks with blending modes.

Adding the eBlend plug-in to your Live set

To add the eBlend plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live behind a video track (a MIDI/audio track with an eSampler, eClips, eSyphon or eVideoIn plug-
loaded).

Mode
Use the dropdown menu to select a blending mode. Currently 25 blending modes are available:
- Normal - Linear Light Pin Light
- Darken - Hard Mix
- Multiply - Difference
- Color Burn - Exclusion
- Linear Burn - Subtract
- Lighten - Divide
- Screen - AdditiveSub
- Color Dodge - AdditiveSubInv
- Additive - ColorAdd
- Overlay - ColorSub
- Soft Light - ColorSubInv
- Hard Light - AlphaSubInv
- Vivid Light

!42
 eCrossfade

With the eCrossfade plug-in you can mix your video tracks in real time using different blend modes and visual
effects (currently ten available).

Adding the eCrossfade plug-in to your Live set

To add the eCrossfade plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to any track.

Mixing videos
Read more about mixing videos in the ‘Mixing videos’ section of this manual.

Crossfading
To use the eCrossfade plug-in’s visual effects you’ll have to assign at least two video tracks to the AB crossfade
sources. Once assigned you can control the audio and video mix between these tracks with Ableton Live’s
crossfader or manually, note that the opacity of the video tracks is already linked to the volume slider, even when
there is no eCrossfade plug-in loaded.

When the is loaded on a track you can select different crossfade video effects to enhance your mix. Currently
there are ten crossfade effects available:

- Xfade - standard opacity fade from A to B

- Additive - fade from A to B using additive compositing

!43
- Multiply - fade from A to B using multiply compositing
- Difference - fade from A to B using difference compositing
- Luma - fade from A to B using luma keying
- Chroma - fade from A to B using chroma keying
- WipeSide - wipe from A to B
- WipeMid - wipe from A to B
- WipeCircular - wipe from A to B
- WipeVertical - wipe from A to B

Alternate on beat
Use the ‘Alternate on beat’ toggle when more than one video track is assigned to a crossfade channel (set to ‘A’ or
‘B’). When the Alternate on beat toggle is checked, EboSuite will automatically switch on the beat between video
tracks that are assigned to the same crossfade channel.

!44
 eFeedback

Use the eFeedback plug-in to create a video feedback loop on the master track with different feedback modes

Adding the eFeedback plug-in to your Live set

To add the eFeedback plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to the master track. Note that the eFeedback plug-in works on the master track only.

Mode
Select the feedback mode with the dropdown menu. The feedback mode determines how the video output is
mixed back into the video mix. Currently ten modes are available:
- Xfade (Default)
- Xfade inv
- Additive
- Multiply
- Difference
- Difference inv
- WipeSide
- WipeMid
- WipeCircular
- WipeVertical

!45
 eOutput

Use the eOutput plug-in to control the output window. The output window settings are saved within the Live Set.

Adding the eOutput plug-in to your Live set

To add the eOutput plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to the Master track. The eOutput plug-in can only be used on the Master track.

Full Screen dropdown menu

Use the Full Screen dropdown menu to set the output window to full screen. The available output screens will be
listed in the menu.

Window Position number boxes

Use the X and Y number boxes to position the output window. When dragging the output window with the mouse
to another location, these settings will be updated automatically.

Window Size dropdown menu

Use the Window Size dropdown menu to select a window size preset. When a preset is selected the Window Size
number boxes will be disabled.

Window Size number boxes

Select ‘custom’ in the Window Size dropdown menu to enable the Window Size number boxes. Use these number
boxes to set the output window to any size. When changing the output window size with the mouse, these settings
will be updated automatically.

Render Resolution dropdown menu

You can set the render resolution independent from the output window size. This is very useful when using Syphon
to send the master video output in high resolution to another application for example. Use the Render Resolution
dropdown menu to select a render resolution preset. When a preset is selected the render resolution number
boxes will be disabled.

!46
Render Resolution number boxes
Select ‘custom’ in the Render Resolution dropdown menu to enable the Render Resolution number boxes. Use
these number boxes to set the render resolution to any size.

Set to % of render resolution

Press these button to set the window size relative to the render resolution.

Always on top
This will force the output window to always stay on top of other windows (the Ableton Live window for example).
When Ableton Live is in full screen mode EboSuite’s output window can not be on top of the Ableton window.

Title bar / Status bar

Turn the title bar and/or status bar on/off.

!47
 eFX-ISF

The eFX-ISF plug-in enables you to use ‘ISF shaders’ in your Live set. The eFX-ISF plug-in is optimised for filters/
FX shaders. The eISF plug-in is optimised for generative shaders.

Adding the eFX-ISF plug-in to your Live set

To add the eFX-ISF plug-in to your Live set, just drag the plug-in from the eFX folder in the EboSuite folder in
the User Library within Ableton Live behind an eClips, eSampler or eSimpler plug-in.

Set the render resolution

The render resolution of the ISF shader is determined by the resolution of the movie/image file loaded in the
eClips, eSampler or eSimpler plug-in or the resolution setting of the eVideoIn or eSyphonIn plug-ins. ISF shaders
can be very GPU demanding, so be aware that if you use large movie files (e.g. 1080p) the frame rate might drop,
especially when using multiple ISF shaders at the same time. Use smaller size videos (e.g. 540p or even 360p) or
a combination to optimise the performance.

Opacity
Use the playback and opacity controls of the eClips, eSampler, eSimpler, eVideoIn or eSyphonIn plug-ins to start/
trigger the ISF shader and control it’s opacity.

More information
Most features of the eFX-ISF and the eISF plug-in work in the same way, learn more about how to use the eFX-
ISF plug-in in the section of this manual about the eISF plug-in. There you’ll find more general information about
ISF shaders as well.

!48
 Basic eFX

eFX are modular, stackable visual effect plug-ins for realtime image manipulation and processing.

eFX plug-ins
Currently EboSuite comes with 33 eFX plug-ins:

- Bend - bend / creative distort effect

- BlockBlur - diffuse the image
- BrCoSa - change brightness, contrast and saturation
- BulgeTwist - creative distort effect
- Chroma - make a color range transparant
- Crop - remove the outer parts of the image
- Crosshatch - creative distort effect
- DanPix - creative distort effect
- Edge - add contrast to sharp color changes in the image
- Fade - manipulate the alpha channel of the image
- Glutch - creative distort effect
- HSBShift - manipulate the color range / creative distort effect
- HueRotate - manipulate the color range
- HueSat - manipulate the saturation level
- Kaleido - mirror and repeat parts of the image to create symmetrical patterns
- Kaputt - creative distort effect
- Levels - move and stretch the brightness levels of the image histogram
- LoFi - creative distort effect
- Median - average the colors in the image
- Noise - creative distort effect
- OneHue - focus on one color in the image and manipulate this color
- Pointilize - convert the image in a set of black and white points

!49
- Polygonize - creative distort effect
- RGB - adjust the red, green and blue channels
- RGBShift - position and scale the red, green and blue channels
- RotaZoom - tile and rotate the image
- Shape - generate an image mask and adjust the alpha, red, green and blue channels of the area outside the mask
- Shine - make the image glow
- SineThreshold - creative distort effect
- Slitscan - creative distort effect
- Slitsglow - creative distort effect, especially useful for high contrast images
- Wave - wave / creative distort effect
- WaveGlass - creative distort effect

Adding eFX plug-in to your Live set

To add a eFX plug-in to your Live set just drag the plug-in from the eFX folder in the EboSuite folder in the User
Library within Ableton Live behind a video track (a MIDI/audio track with an eSampler, eClips, eSyphon or
eVideoIn plug-loaded). With an eFX plug-in on the Master track you can manipulate the image of the final mix.
With an eFX plug-in on an individual track you can manipulate the image of the video output from that track.

Grouping
You can group eFX and load them in an instrument rack. You can not load eFX plug-ins on a Return track or use
them in a chain in a Rack.

Smooth
Each eFX plug-in has a Smooth controller. Use the Smooth controller to even out the motion of the effects.
Increasing this parameter will make the eFX plug-ins ignore rapid value changes to reduce noise and to create a
more continuous, fluent, natural motion.

!50
 eConvert

EboSuite works with most video codecs, but works best with Hap or Hap Alpha encoded videos. With the
eConvert plug-in you can easily convert video files to the Hap or Hap Alpha codec within Ableton Live. You can
drag the newly created video file directly from eConvert’s interface to a Session View clip slot or the eSampler
for further use.

Adding the eConvert plug-in to your Live set

To add the eConvert plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to a any track. For the eConvert plug-in to work the EboSuite application needs to be active.
Add an eClips or eSampler plug-in to your Live set to launch the EboSuite application.

Select a video to convert

There are three ways to select a video file that you want to convert to Hap.
- you can select a (portion of a) video clip in the Arrangement View or a video clip in a clip slot in Session View
and press the ‘Convert selected clip’ button in the eConvert’s interface.

- you can drag a video clip from an audio track in Arrangement View or Session View into the dropzone in the
eConvert’s interface.

!51
- you can drop a video file from the Finder into the dropzone in the eConvert’s interface.

Crop to clip start/end

When ‘Crop to clip start/end’ is enabled, the eConvert plug-in will use the video clip’s start en end point markers
to crop the converted video file. Use this feature to save on render time and file size. When preparing video
samples for the eSampler this feature is very useful, because you will typically need short samples.

Support alpha channel

Make sure to enable ‘Support alpha channel’ when you are converting video files that contain an alpha channel.
The resulting video will be encoded with the Hap Alpha codec.

Batch conversion
The eConvert plug-in currently does not support batch conversion. To convert multiple files at once use the AVF
Batch Converter application. You can read more about the AVF Batch Converter application here.

Supported codecs
Both the eConvert plug-in and the AVF Batch Convertor make use of apple's current video framework,
AVFoundation. This framework does not support older video codecs. Currently both convertors support a.o.
Apple ProRes 422 and ProRes 4444, H264 and Photo-JPEG. If you want to convert another codec you first
need to convert it to one of these codecs, this can be done automatically using Quicktime Player 10. If you open
a file in Quicktime Player 10 that is not supported by AVFoundation it will automatically encode it to H264 (if
the codec is not too exotic). It will automatically create a copy next to the original file and add '(Converted)' to
the file name. You can can then drag this file to eConvert to convert it to HAP. Quicktime Player 7 Pro is a great
alternative for Quicktime Player 10, because it offers more export options and reads more older codecs. Note
that there is a difference between the term ‘file format’ and ‘codec’. The file format denoted by the extension
(such as .mov, mp4, m4v and .mpg) does not tell you how the video is compressed internally (codec).

!52
 eSyphonOut

Use the eSyphonOut plug-in to route the output of your video tracks to other video applications like VJ-, video
mapping- or visual effects software or to the Syphon Recorder application.

Adding the eSyphonOut plug-in to your Live set

To add the eSyphonOut plug-in to your Live set just drag the plug-in from the EboSuite folder in the User
Library within Ableton Live to the Master track or a MIDI/Audio track containing one or more eSamplers or an
eClips plug-in. Use the eSyphonOut plug-in on the Master track to output the final mix (including crossfade
effects) to another application. Use the eSyphonOut plug-in on an individual track to output the video output
from that track solely to another application.

Set the Syphon stream name

The Syphon stream name is the name that will appear in the target application, so it is recommended to choose a
clear, recognisable name to avoid confusion. When naming the stream is set to ‘Auto’ the stream will be named
after the Ableton track on which the eSyphonOut plug-in is loaded. When naming the stream is set to ‘Manual’
you can enter a custom name.

Vertical flip texture

In some cases the texture will be flipped vertically when it is received by the target application. Use this feature to
correct this.

!53
 eSyphonIn

Use the eSyphonIn plug-in to use the video stream of other video applications or an EboSuite video track
(containing an eSyphonOut plug-in) in EboSuite.

Adding the eSyphonIn plug-in to your Live set

To add the eSyphonIn plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to a MIDI/Audio track.

Select the Syphon stream

Available Syphon streams will appear in the dropdown menu. Simply use this menu to select the stream.

Link Opacity To Volume

When Link Opacity To Volume is enabled, the volume fader of the track will control the opacity of the incoming
Syphon stream. Disable this feature to control opacity manually or with track automation.

!54
 ePoly

Use the ePoly plug-in to control multiple eSamplers at the same time to create polyphonic/polyscopic
compositions.

Adding the ePoly plug-in to your Live set

To add the ePoly plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library within
Ableton Live to a MIDI track.

Polyphonic/Polyscopic
The ePoly plug-in distributes incoming MIDI notes over eSamplers on MIDI tracks to the right side of the MIDI
track it is loaded on. This way you can control multiple eSamplers on different MIDI tracks at the same time to
create harmonies (polyphonic). Because the eSamplers are loaded on different MIDI tracks you can combine
them individually with eFX and an eTrackTransform plug-in to create a visual arrangement (polyscopic).

ePoly will automatically look for eSampler plug-ins on MIDI tracks to the right side of the track it is loaded on.
ePoly will show these tracks in the interface, represented as green dots.

Polyphony pop-up menu

Use the polyphony pop-up menu to set the maximum number of notes that are allowed to play simultaneously
(and are distributed over an equal number of eSamplers). According to the selected Mode.

!55
Mode
This parameter determines how the incoming notes are distributed. The following allocation modes are available:
- First: incoming MIDI notes will be send to the first non playing voice (eSampler on MIDI track to the right side)
- Up: incoming MIDI notes will be send to the first non playing voice increasing from previous
- Up/Down: incoming MIDI notes will be send to the first non playing voice increasing from previous and going
back down from max (outer voices are used less)
- Random: random, but without repetition
- Oldest: available note with longest off time

Stealing
If you play more than the maximum number of notes you can choose to overtake running notes in various ways.
(There is one exception: if the value of this parameter is ‘Mode’ than the Mode parameter has priority and can
overtake notes before the maximum number is reached). The following stealing modes are available:
- Off: off
- Highest: highest playing
- Lowest: lowest playing
- Mid: NOT highest/lowest playing
- Random: random
- Oldest: longest on
- Closest: closest note number
- Mode: using allocation mode without checking if it is playing or not

Reset
Allows you to reset the Mode and Stealing history in order to be able to have a reproducible result.

Watch the tutorial video about ePoly here

!56
 eComper

Use the eComper plug-in to consolidate a MIDI clip to a video file without leaving Ableton Live. You can drag the
newly created video clip directly from eComper’s interface to a Session View clip slot, to use it immediately in
your Live set.

Adding the eComper plug-in to your Live set

To add the eComper plug-in to your Live set just drag the plug-in from the EboSuite folder in the User Library
within Ableton Live to a MIDI track containing one or more eSamplers. The eComper plug-in can only be used on
a MIDI track and can only create a video clip using the video samples that are loaded in the eSampler plug-ins on
that track.

Consolidate a MIDI clip to a video file

Once an eComper plug-in is loaded on a MIDI track containing one or more eSamplers, just select a MIDI clip on
that MIDI track and press the ‘Convert selected clip’ button on the eComper’s interface. After pressing this
button you will be asked to type in a name for the newly created video file and to select a destination. The
eComper will store the video file in this location and will show a Quicktime icon in the eComper’s interface that
links to the video file. You can now easily drag the newly created video file directly from the eComper’s interface
to an eSampler or on an audio track for further use by dragging the icon to that location.

Rendering versus compiling

The eComper does not actually ‘render’ a movie file, but rather ‘compile’ a movie file. Based on the order of
MIDI notes in a MIDI clip it will copy/paste the video fragments assigned to those notes in the same order and

!57
save them as a new video file. The eComper only takes the start point settings into account and ignores other
settings, like the ADSR, velocity, pitch, audio effects, automation etc. The eComper works great for compiling
basic video edits and video beats. Read the ‘Record the video output’ section of this manual to learn how to
record more complex video edits, melodies and video mixes.

Adding an alternative audio track to the compiled video file

Because the eComper doesn’t take velocity, the ADSR or audio effects into account, you can drop an alternative
audio file into the dropzone in the eComper’s interface, that then will be added to the compiled video file. You can
for example first render the audio of the MIDI clip using Ableton Live’s audio export feature (with all the audio
effects and velocity changes) and then drop this audio clip into the dropzone in the eComper’s interfac

!58
 eLoopStutter

Use the eLoopStutter plug-in to bring dynamic ‘beat repeat’-like effects to eClips.

Stutter On/Off
When the stutter effect is turned on it starts looping a smaller portion of the clip, starting from the current
playback position. When stuttering is turned off it continues at the point where it would have been if stutter
hadn't been engaged.

Note: The clip needs to be warped to use eLoopStutter (and of course the .asd needs to be saved for EboSuite to
use this information).

Stutter length buttons

Press the stutter loop length buttons while stutter is still ON to change the looplength.

Map as Single parameter

eLoopStutter can be controlled in two ways:
- With separate buttons for the loop length and stutter enabling (for example when you want to
control it with a MIDI interface with buttons or keys).
- With one parameter (when you want to control it with one dial).

!59
Load RAM
If you start the stutter effect with a small loop you will notice that you can hear a bit more than the desired loop.
This is because Ableton has already pre-buffered the clip's playback from the disk (this is also dependent on your
harddrive's speed). If you load the clip’s audio track into RAM looping will be instantaneous. To make it easier to
control the RAM settings for each clip, a button is included in the eLoopStutter’s interface for this. This button
has the same effect as the RAM button in the clip’s Sample View (so the status of this button will change
simultaneously). Please note that this might fill your system's RAM if you forget to unload it after use.

eLoopStutter works best on longer clips, such as full songs. On short loops it might lead to some odd results
where the 'stutter-loop' contains a portion of silence or that the playback stops when you disengage the effect.

This effect can also be used with audio-only clips of course. Most effects can be achieved by Ableton's ‘beat
repeat’ already, but the different way the parameters are handled makes it still worthwhile to check it out with
audio-only clips.

!60
 Record the video output

The eSyphon plug-in is particularly useful to record your final mix. To do this add an eSyphon plug-in to the
Master track and download the Syphon recorder application.

Select your Syphon stream on the bottom-left side of the Syphon Recorder’s interface (‘Master - EboSuite’ in
the example shown above). In most cases this will be done correct automatically. Next, just press the ‘Snapshot’
button (to make a picture) or ‘Record’ button (to make a movie).

Adding audio to your movie recording

The Syphon Recorder application only records the video output. To add audio to your recorded movie do the
following:
- in case of a live performance: record the audio in Ableton Live during the performance on an audio track
- when not a live performance: render the audio of your composition using Ableton Live’s export audio feature
- drag the movie file recorded with Syphon Recorder to an audio track in Ableton Live. This will open Ableton
Live’s standard video output window.
- drag the recorded/rendered audio file to an audio track below the movie file in Ableton Live
- sync the audio and movie file by moving the audio file
- export the audio and video tracks to a new movie file using Ableton Live’s export audio/video feature. Learn
more about exporting video from Ableton Live using the standard export function in the Ableton Live manual.

Watch the tutorial video about Syphon Recorder here

!61
 eDecollect

eDecollect is a helper for EboSuite. It can be used to make Ableton Live sets work again that have been saved with
the ‘collect all and save’ option with the ‘Files From User Library’ option enabled.

We advice you to to exclude files from the User Library when you use the ‘collect all and save’ functionality. If you
need to include the files from the User Library for some reason, you will need the eDecollect application to make
the collected project work with EboSuite.

The reason for this is that Ableton Live will create copies of the EboSuite plug-ins in the project folder, when
‘Files from User Library’ is enabled. Live will load these copies when the collected project is opened. All EboSuite
files need to stay together in the EboSuite folder in Ableton’s User Library, so all EboSuite plug-ins will show an
error message.

Use the eDecollect application to fix this issue. It works by simply dragging the ‘.als’ file into the drop area. It will
make a new file in the same location ending with ‘_decollected.als’ (be aware that it will directly overwrite existing
files with that name). It is also possible to perform this action on multiple files at once.

eDecollect is not installed by the EboSuite installer. You can download the eDecollect application here.

!62
 Important links

Video tutorials:
https://ebosuite.com/support/

Download location of the installer:

http://www.ebostudio.info/EboSuite/EboSuite_Installer_QSG.zip

Download location of the example projects and video sample:

http://www.ebostudio.info/EboSuite/EboSuite_Examples.zip

Location of the full manual:

http://www.ebostudio.info/EboSuite/EboSuite_manual.pdf

Download location of the HAP batch converter:

https://github.com/Vidvox/hap-in-avfoundation/releases

More information about the HAP codec:

https://github.com/vidvox/hap-qt-codec/releases/

Download location of the ISF Editor:

www.ebostudio.info/isfeditor

More information about ISF (Interactive Shader Format):

www.interactiveshaderformat.com

Download location of Quicktime 7:

https://support.apple.com/kb/dl923?locale=en_US

More information about Syphon:

http://syphon.v002.info/

Download location of the eDecollect application:

http://www.ebostudio.info/EboSuite/eDecollect.zip

!63
 List of possible error and warning messages (incomplete)

General errors and solutions:

- EboSuite application -or- [device name] is not in the correct location in the user library
The EboSuite plug-ins need to be in the EboSuite sub-folder of the current User Library. This folder also
contains the (hidden) EboSuite app. If you see this error you probably did on of the following things:
a. used Collect All and Save with the ‘User Library’-option enabled (see FAQ)
b. changed your User Library location
c. changed the file location/folder names in a different way.
If the reason is ‘a’ you can right click on the top bar of a plug-in (next to the title) and select ‘manage device
file’ and point to the correct versions in the ‘user library’ (there is an Ableton bug here that sometimes the
eSampler can forget the sample it was pointing to).
If the reason was ‘b’ or ‘c’ you can manually correct the location of the EboSuite files or simply run the installer
again.

- Version mismatch, please reinstall

This happens when there are EboSuite plug-ins with a different version than the EboSuite app. It is best to run
the installation again with the latest version of the installer.

- Click to restart EboSuite App

When you accidentally close the EboSuite application (or when it has stopped for some reason) you can click
here to start it again.

Errors and warnings and solutions per plug-in:

eClips
- There is already an eClips device in this track, this device is disabled
- Delete the plug-in
- Warping is on but warp markers could not be found. Save them first to use them (= warning)
- Save the warp markers
- You are using an old version of Max, please install a new version
- Check the Ableton preferences if the latest version of Max is installed and selected
- Clip slot is too high (max=256)
- Delete clips from clip slots to create space
- Current clip is not playable, please convert to Hap
- Use the eConvert plug-in to convert video to Hap codec
- Current clip has no video (= warning)
- No action needed

!64
eSampler
- File not playable, please convert to Hap.
- Use the eConvert plug-in to convert video to Hap codec.
- You are using an old version of Max, please install a new version
- Check the Ableton preferences if the latest version of Max is installed and selected
- File has no video. (=warning)
- No action needed.
- File is long (> 1min). Select a smaller region of the clip by adjusting the start- and end-markers. (=warning)
- We recommend you to crop the video to a shorter size, read this section for more info.
- File was too long, automatically truncated to 2 min. Select a smaller region of the clip by adjusting the start-
and end-markers.
- We recommend you to crop the video to a shorter size, read this section for more info.

eComper
- This device only works on a MIDI track with eSamplers.
- Delete or or move the plug-in.
- Selected MIDI clip is empty.
- Select another MIDI clip.
- No MIDI clip selected.
- Select a MIDI clip before pressing the ‘Convert selected clip’ button.
- Selected clip is not on this track.
- Select a clip that is on the same track or move the eComper to that track.
- Selected clip is not a MIDI clip.
- Select a MIDI clip.
- No MIDI effects allowed.
- Delete the MIDI effects.
- Selected MIDI clip results in empty movie.
- Select another MIDI clip.
- Finished unsuccessfully.
- Try again or select another MIDI clip.
- At least one of the MIDI notes has no video associated with it, see Max window for more info. (= warning)
- No action needed, but you might want to check the MIDI clip.
- Data received is incomplete, please retry
- In some rare cases it is possible that the eComper can’t make an edit, please try again.

eSyphon
- This device only works on the master or on a track with a eClips or eSampler device.
- Move the plug-in to a track with an eClips plug-in, an eSampler or the Master track.
- The EboSuite app needs to be active for this device to work. Load at least one eClips or eSampler.
- Add an eClips or eSampler to your Live set.

!65
eCrossfade
- This device only works on the master track.
- Move the plug-in to the Master track.
- There can be only one instance of this device.
- Delete the plug-in.
- The EboSuite application needs to be active for this device to work. Load at least one eClips/eSampler plugin.
- Add an eClips or eSampler to your Live set.

eConvert
- The EboSuite application needs to be active for this device to work. Load at least one eClips or eSampler
plug-in.
- Add an eClips or eSampler to your Live set.
- Finished unsuccessfully.
- Retry or check the video file for errors.
- Failed because this codec is not supported.
- Convert the video to another codec using Quicktime Player 10 or 7 Pro and load it into the eConvert
again (read this section for more info).
- Cannot crop to start/end because Warp markers could not be found. You need to save these first. (= warning)
- Save the Warp markers.
- This file type is not accepted. (= warning)
- Convert the video to another codec using Quicktime Player 10 or 7 Pro and load it into the eConvert
again (read this section for more info).

!66