@import((rwml-menu))
My Graphic
Logo Zwobot Visuals for Ableton Live

Zwobot v1.6 User Guide

last update 10 Dec 2018

My Graphic

(Summary of all Zwobot modules)

My Graphic

How To Install

• Ableton Live 9 user: Make sure you have the latest version of Max for Live installed! Zwobot is not working with Max7.2.5 and below. Max 7.3.5 (march 2018) is the most stable version to work with Zwobot in Ableton Live 9.

• Ableton Live 9 and Live 10 user: Install all necessary external Max packages via the Max Package Manager.
See video

• Put Zwobot and modules in any folder you want. Add Folder in the Ableton Browser. That's it!

• Audio-buffer settings influences the fps of Zwobot. Change your audio-buffer settings in Ableton Live and try what's best for you to work with Zwobot & Ableton Live. The higher the buffer settings in Ableton Live, the less GUI lag you'll have. A good value to start is 512 samples.
 
My Graphic

Feature Overview Zwobot

General Functions



Please do not use the ON/OFF button (Device Activator) to temporarily deactivate Zwobot. Zwobot has different rules than audio plug-ins. If you want to temporarily disable Zwobot, simply use the Engine ON/OFF in the Monitor module or use the Pass Module key with the FX modules.

Click on the Zwobot logo and you'll sent a manual Beat-Control signal.

Set your beat clock rate for the Zwobot Beat Function. You can set the clock rate up to 1/16th. If Beat is enabled, it will send a clock to Zwobot and all effects, and if available, you can set this clock to your dialers/effects. more info at the Beat Control section

"Fullscreen" sets your main output window to fullscreen on your 2nd monitor/projector. Linked/Float binds your output window to Ableton live. If floating is set, your window is independent from Ableton Live. This is most important for Mac users. If you lost your window reset it in the Zwobot Monitor module.

Simple mirror and kaleidoscope effect.

Zoom video on X or Y axis.

Color FX - Darken, Invert, Invert2, Plastik, Grinder. These effects are pre module FX. (see video routing)

This is your main X-Fader for the 2 video players. Here there are different X-Fade transition effects. (X-Fade, Door, Scale etc.) If the Beat-Function is enabled you can run the whole thing automatically, and you can set different transition modes in the Zwobot Monitor module.

Swap instantly A/B video channel.

The A/B filter calculates the 2 videos from A and B in different mathematical modes. (as in Photoshop) The mixing filter only works in standard X-Fade mode.

Activate the audio of the playing movie clip. You can change the audio X-Fade behavior of the movie clip in the Monitor module.

This LED indicates if an FX is connected to Zwobot. If it is blue, the video stream will work. Click on this LED and the FX module will be bypassed by the FX chain and the LED will turn red.

Enable Sound Reaction (SR) for the X-Fade dialer. The dialer will move depending on the set frequency (hi/low). You can adjust the (hi/low) frequency ranges in the Monitor module. You need audio on the Ableton Live Track where Zwobot is located to use this function.

Choose FX module (if called). The fx connector is working like a guitar foot pedal series connection. more info at the Connector section


Player Functions



Play/Pause.

Play mode (loop, palindrome, next).

If you have dropped a complete folder or loaded it via rack modules you can access all videos here via drop down menu.

The Repeat-Dialer repeats the video-clip/image file to the main Ableton Live BPM beat count. This function is independent from the main Beat-Function in Zwobot. Each player has its own independent repeat function.

Prev/next file.

Activates the "Random Frame Function". When is set and FRM is on, the current video is set/launched to random frames.

Enables the "Random File Function". If is set and RND is enabled it will select random files from the loaded folder.

If Video Info is enabled through the Monitor module, it shows the resolution of the current video and its fps recording rate. Important! This information always refers only to the current video/file in the player.
• You can use Zwobot in midi and in audio tracks. We prefer to use Zwobot in a return track.

• Do not use the Zwobot main module twice in one Ableton Live set. Zwobot has different rules than a regular audio or effects plug-in.

• The ON/OFF button (Device Activator) has no effect on the Zwobot modules.

• Ableton Live and its audio playback is always on priority No.1! So if you load new effects or 3rd party plug-ins, Ableton Live always keeps playing, while Zwobot can get stuck for some milliseconds. This is a feature, not a bug!

• Zwobot will save all dialer/toggle/fx-connections/video and folder values within Ableton Live.

Video Routing

• Video-signal routing through FX-connector/router (). 1 is your first FX, then it goes through 2, then 3 etc. . 18 is the last in line. You can choose any drop-down list you want.

Your video & is routing through:
A/B Filter
X-Fader Color-FX FX-Connector Saturation/Contrast/Brightness Zoom Mirror/Kaleidoscope output window.

EX ALPHA is not affected to any internal effects, it sends direct to output.

Extensions (EX modules)



Outgoing frames per second from your Graphics. Less than 20fps = orange, less than 15fps = red. If you have less than 15fps, delete/pass some effects for better performance.

Enable Syphon out for Syphon screen sharing (Mac ). This button will not appear on Windows systems. Spout screen sharing (Windows) is always on!

Set your internal render resolution for your graphics.

Enable additional preview window.

Reset all dialer values on the Zwobot module. This has no effect on your actual video playback.

Enable corner mapping in your main window. If enabled just drag corners to any position you like.

Disable Zwobot playback engine. If you want to edit your audio stuff without taking performance from Zwobot.

Cache size of given RAM in Gigabyte. If you have a lot of small files, this will help you. It doesn't make sense with huge files and just blow-up your RAM. Care should be taken when adjusting the size, if the frame cache exceeds the available memory, the application may crash. It doesn't have any effects for FX & Modules.

Drag'n'drop files & folders.

Empty cell path-information.

Send path-information to channel A or B. Watch on YT

Remote file transport A B and/or generate dummy-clips. Watch on YT

Live-record your main Zwobot window.

Setup resolution and frame-rate (frames per second) for live recording.

Drag'n'drop PNG files or folders. Don't use animated GIF-files with this extension, it could cause trouble.

Change transparency-filter from alpha-channel(png only) to white-filter.

Sound reactivity is set as a standard for electronic music. If you need a more precise reactivity just change it here.

Make shapes and use it as masks for projection mapping. Watch on YT

Start button and manually trigger button.

Select the channel of the videos you want to trigger.

Make sure you LOCK the frames from the video with the most frames. This avoids a unnecessary high number range in the number boxes. Just click through all clips in your selected channel, and when the maximum frames are reached and it can't get any higher this will be displayed in total frames. Now just lock this value. Watch on YT

Enter here the frame number which should be triggered.

Turn the trigger indicator off and on, or just use it to manually trigger the video frame.

Change the X-Fade transition when the Beat-function on X-Fade is enabled. (jump, linear, ease-in, ease-out)


• Extensions (EX) no need to connect to Zwobot. They work as they are. You can put them in any track independent from Zwobot.

• Besides the RMOTE, VSEQ and RACK extension, do not use EX twice in one Ableton Live set!
 
My Graphic

Connect Effect Modules

How-to connect FX modules

• Click the FX icon to indicate the FX-module to Zwobot, and it will show up in the FX dropdown-menu in Zwobot. You can also press the Indicate-All-Button in Zwobot and Zwobot will show all open FX in the dropdown-menu. To reset all connections, just click reset .

Pass your effects if you temporary no need them. Effects may take CPU/GPU even if they are not connected. Connected FX are bypassed by default.

Disconnect the connection and disable the module.

If an FX/EX module is in another Ableton track than Zwobot, this (Z)-LED will appear. If you click on this LED, the view automatically jumps to the track in which Zwobot is located. (Jumper feature)

• You can drag and drop the drop down menus back and forth to change the FX positions and its routing.

By setting the current FX routing you can save and recall the respective states (bypass on/off, routing position). Attention! This is only recommended if you have already added all the effects you want to use in the Ableton Live set. Additional effects that have not been set before can cause problems in stored routing.

See video how it works
 
My Graphic

Beat Control Function

This is your master Beat-Control knob. It takes the beat from Ableton Live (bpm), and (depending on your dialer) spreads it to Zwobot and modules.

All enabled Beat-Buttons takes the Beat-Control clock to the module dialers, and all enabled dialers will perform to the pre-adjusted beat. Beat function is always on the left lower dialer side.

The Beat-Control bang can also be triggered by simply clicking on the Zwobot icon.

See video
how it works

 
My Graphic

Effect Modules


3IDE ABC AUX BLENDER BLUR COULEUR DEELAY DEFORM DIGGI DRIFT DUKE EARL ERRQUAKE FDBK FISHEYE FLOW LINR LOOPER MULTI NEGATIF OFFSET OSSI PETRA PLURAL REC RGB RUN SCAN STROBO STUTTER TWST VAUDIO VHS VSINE


 
My Graphic

Performance Guide

Short Story


The bigger your video files are (bitrate and resolution) & the more effects you'll use = less FPS!
Keep the sample rate in Ableton Live low (e.g. 44100).
Increase the buffer size (sample buffer) if the GUI in Ableton Live is slow and delayed (e.g. 512 samples).
(Win) You should have 50+ fps when playing a single 720p video file, even with a Cor2Duo CPU.
(Win) You should have 100+ fps when playing a single 720p video file on a i7 (5th gen) CPU.
(Mac) On newer Mac computers, the fps rate synchronizes to the screen refresh rate (Vsync). In most cases this is 60hz (60fps). This cannot be turned off.


Long Story


First things first: The CPU Monitor in Ableton Live is for AUDIO ONLY! It just shows the audio occupancy rate from Ableton Live.

Stacks Image 977

(CPU monitor in Ableton Live is audio only)

There are a lot of different CPU threads running in Ableton Live, and if you have 20% CPU usage shown in Ableton Live means that the audio thread in Ableton Live runs with 20% CPU usage. In Ableton Live the audio thread is the high priority thread! All other threads like UI and in this example Zwobot running on a lower priority (for keep playing audio alive).

This is in most cases good, but even we are running Ableton Live without any audio, Zwobot will always have just a low CPU priority.
That means we have to know what we are doing and look around what we can afford.
The good thing is this doesn't affect the GPU. Let's explain how Zwobot works (CPU vs. GPU):

Zwobot has 2 video players (A & B), those players running full on the CPU (Max Viddlle Engine). Also all dialers and button values affecting the video playback can decrease the CPU power. (see upcoming picture)
Stacks Image 900
Beyond the 2 player units almost everything else in Zwobot (including FX modules) is GPU driven (High performance).
The Zwobot FPS readout (Zwobot Monitor) works like this:
CPU encoding of the video (the player tries to play all videos on their set fps stable), and these fps then run into the GPU. Here, the video is converted to the internal Zwobot resolution for further effects, the lower the resolution is set, the better the performance.
The GPU receives the fps (e.g. 30fps), and then calculates the effects on top of it, i. e. 30 calculations per second, per effect.
Since the GPU sometimes doesn't get behind (especially at high resolutions) frames are skipped. Result: less FPS.
Keep your video resolution as low as possible. If your outgoing screen/projector is 720p it makes no sense to play 1080p videos. This will just drop the CPU.

Have an eye at the upcoming picture.
Stacks Image 902
Zwobot reads the incoming vid and its resolution, then it calculates this resolution to the internal Zwobot GPU resolution, and give it to the outgoing window/screen/projector.
Every single FX module takes CPU/GPU. Even if they're bypassed they'll take around 5fps (worst case). And if you have 10 modules and "pass" them they take 50fps.
Unfortunately we can't recommend any video codec for Zwobot, it clearly depends of what you're trying do with it. In some cases - play short vid sequences as fast as possible - even gif files are the best solution. But a good start is always to encode your files in h.264.

Keep your video bitrate as low as possible. The more bits need to decode the more CPU it needs.

If you are running an AMD RYZEN+ or Intel Kaby Lake+ we totally recommend to encode all your videos in H.265 (
HEVC ).
Pre producing is not cheating!

Further improvement suggestions



(Win) Disable VSYNC (vertical synchronization) in your GPU/driver settings. Enabled VSYNC can drop your frame rate extremely!

(Win) Enable "High Performance" in your power management settings.

(Win) If you have any trouble with Fullscreen (crashes etc) please disable HiDPI (Live 10) in Preferences > Look/Feel > Disable HiDPI.

Don't use any Bluetooth,- and/or 3rd party routing-drivers etc. For best performance, all our audio interfaces and computers run on 256 to 512 samples at a bit rate of 44100Hz.

Try different settings in Ableton Live for best fps. In some cases less buffer size (e.g. 256) is the best solution. But in general, the higher the buffer settings in Ableton Live, the less GUI lag you'll have. A good value to start is 512 samples.

Please don't use any special 3rd party video codecs "Made for Ableton Live" (Yes, there are some weird stuff in the world wild internet) Those may crash Zwobot!

Close all high-GPU-needing software! Photoshop, video apps, 3D-tools and even your Internet-browser may take a lot of GPU (YouTube). All of them "can" cause some critical issues. Especially in live situations!

Use 64bit Ableton for better overall performance.

Freeze as much as possible in Live. More Ableton Live effects and plug-ins: less performance.

You don't need more than 44khz audio output in a live set. Really.

Bypass your effects (pass/bypass-button) if you temporary no need them. FX modules may take CPU/GPU even if they are not connected.

If there are less than 30fps, sound-reactivity on the FX modules may decrease noticeably.

If you are in a club/on a stage and adjust the projector, check if there are visible differences between the next lower resolution settings. If not, go down to the next lower possible resolution!

When you have a live session, always remember to cool down your Macbook/Laptop/Notebook. It can get pretty hot on a stage. From about 25 °Celsius (77 °Fahrenheit) the temperature controllers start to throttle and shut down the CPU/GPU.

Our suggestion for encoding your video-files is Handbrake. https://handbrake.fr/

If you still have low fps, write us: info@zwobotmax.com or via reddit: https://www.reddit.com/user/zwobotmax

 
My Graphic

Questions And Answers

In which Ableton Live channel/track should i use Zwobot?

If you don't need sound for your fader effects, it doesn't matter on which track you are running Zwobot.

You can put Zwobot and modules in different tracks.
Run Zwobot in a midi channel/track (e.g.) and modules independently in an audio channel/track.

SR (sound reactive) modules need sound for working. So put them in a audio channel/track.

We prefer to use Zwobot in a separate Ableton Live return track.


How can i record my visuals?

Zwobot has an integrated recorder module, and you can send/share your outgoing video to other apps who support Syphon (Mac) or Spout (Windows). Some of them will take a lot GPU/FPS.

The Zwobot recorder module records in h.264 with any frame-rate you like. Unfortunately it is not so high-powerful as other solutions.

We personally use
Syphon Recorder (free/MAC) or Screenflow to record all Zwobot stuff.
We can also recommend
OBS (free/WIN).


These 3 recording solutions record direct from your graphics card without huge performance loss.


How can i install Zwobot and modules?

Put Zwobot and modules in any folder you want. Add Folder in Ableton Browser. That's it!


How does the licensing of Zwobot work?

The end-user license of Zwobot is linked to your email address with which you bought Zwobot. If you would like to have your license at a different address, simply contact us.


How does updates work?

If an update is pending, you will get an email with a download link. You don't need an Gumroad account ore something. Just replace your old files with the new ones. Replacing your files with the new ones should not destroy your Zwobot stuff in your Ableton Live projects.

Use hot-swapping in Ableton
See video for replacing the old Zwobot modules with the new ones.


Spout is not working (Windows)

If you do not receive a Spout signal from Zwobot, make sure that you have installed the Spout package via the Max Package Manager and install the Spout tools from the
Spout website
Then you can customize the Spout settings (DirectX) for your system.


I want this and that feature!

Just talk to us! A lot of improvements in Zwobot are user driven (Rack module, Jumper, ABC, Alpha, the new Blender module et cetera). Just explain what's your plan, and why we should put this feature in Zwobot.


• Keep your main output-videoscreen/projector resolution low (720p for example, you really don't need more). If you're running higher resolutions, you'll have less fps.

We certainly do not recommend a framerate under 15fps! This may disconnect your effects, and in some cases it can cause a crash of Zwobot and/or Ableton Live!

Our suggestion for encoding your video-files is Handbrake .

Any other questions? Feel free to ask via our new Reddit user group or just via email: info@zwobotmax.com