ADD-ONS by woland

Total Number of Scenes – User Actor

This small User Actor does exactly what the name suggests: it will count how many Scenes are present in the patch, and update itself automatically at every change, as well as manually. At its heart lie a few lines of JavaScript written by Andy Carluccio using the JavaScript Actor.

Even or Odd Comparator User Actor & Example File – Patch

This User Actor receives an integer for an input, figures out whether that number is even or odd, and lets you trigger events based on the result.

Stage Mouse Watcher to Live Drawing Scale Calculator User Actor & Example File – Patch

This example patch, and its associated user actor, will help you transform a simple flick of the wrist with your mouse into an interactive and content-generating artistic gesture by showing you how to perform the value scaling that is required to make the Live Drawing actor work with the Stage Mouse Watcher actor.

Video Switcher User Actor & Example File – Patch

The Video Switcher patch gives you a show-ready interface to control and live-mix up to 4 video sources with audio. Use it as is, or customize the interface to your needs. The download also comes with a Video Switcher User Actor which you can bring into your own patches.   The example file relies on video files that exceed the upload limit here, so follow this Dropbox link to download it instead:

Keyboard Watcher Up/Down 2.0 User Actor & Example File – Patch

The Keyboard Watcher Up/Down 2.0 User Actor improves upon the Keyboard Watcher actor to make it into a reliable and practical show-ready tool by solving the problem of “continuous triggering” caused by keeping the key pressed down.

Percentage to Timecode User Actor & Example File – Patch

Sometimes you need both percentage-based and timecode-based control of the same Movie Player actor but end up being forced to pick one or the other. Never compromise again with the Percentage to Timecode User Actor! Keep your Movie Player actor in timecode mode and connect this User Actor to its position input for percentage-based control. This allows you to, for example, use a Slider control to scrub through a Movie Player actor that's in timecode mode.   The example file for this relies on videos that exceed the upload limit for this page, but you can download it from Dropbox:

Thru User Actors & Example File – Patch

These 16 User Actors (all for different input/output property settings and data types) can act as mobile connection hubs for many outputs and inputs that are all going to or coming from the same place. They are great for daisy-chaining, building in a modular way, consolidating your Control IDS to make it easier to re-use large parts of an Isadora Patch in new files, serving as placeholders, and can allow you to experiment with upstream data without having to re-draw downstream connections every time you change an actor.

Text Comparator Example File – Patch

If you’re curious about the Text Comparator actor, this example file will show you how it can be integrated into your patch for more real-time interaction.

Runtime Recorder – User Actor

This User Actor can record your start time, current time, and runtime into a text file. If you put this in a background Scene at the beginning of your file, you can use it to automatically record the exact time your show starts, ends, and how long it lasted. This can also be useful for debugging if you're leaving a file running long-term and finding that it experiences issues after a certain amount of time. This User Actor allows you to: Define a suffix to add to the filename Set the interval at which you want it to write the current time and runtime to the text file. Turn it on and off (which will start the timer over in a new file) See the filename, start time, last recorded time, and runtime on its outputs. Please note that this User Actor should be put into a background Scene (video tutorial, written tutorial) that you leave active, as you need to enable the User Actor and then have it continue to be in an active Scene in order to keep updating the times in the text file. Every time you enable and disable this User Actor, or leave and re-enter the Scene it's in, the User Actor will create a new text file with a new start time.   Changelog v3 - 2022-12-07 Fixed some math inside the Time Converter User Actor that's used internally.   Changelog v2 - 2022-12-06 Inputs Added a non-functional "—write interval—" input purely for labeling purposes. (It relates to the inputs below it.) Renamed the pre-existing write interval inputs from "write interval (mins)" and "write interval (secs)" to "mins" and "secs" Added write interval inputs for weeks, days, and hours (so now the write interval can be any combination of weeks, days, hours, minutes, and seconds). Outputs Cleaned the text on the outputs so that a fresh version of the User Actor shows timecodes of "00:00:00" instead of the random values that were present when I ran my last test Added a "write" output in case anyone wants to trigger anything at the same time Connected the "Runtime" output to the series of actors that makes the runtime timecode. Previously it was connected to the associated output on the Data Array, so it would only update at whatever interval you set. With this change, the runtime output will update for you visually in real time instead of at the set intverval. Misc Added Javascript-powered User Actor inside to handle time conversion from weeks/days/hours/minutes/seconds to total seconds for the intervals.

Auto-Launch Isadora and Enable Serial Ports Workflow for macOS – Application

This Auto-Launch Isadora and Enable Serial Ports Workflow for macOS will allow you to set up an Apple computer so that, whenever you turn it on, it automatically logs in, launches Isadora, and triggers the "Enables Serial Ports" menu command. Once you understand the process, with a little bit of Googling for the correct bits of AppleScript, you'll be able to automate all sorts of things on startup for macOS-based Isadora art installations. The download includes an Automator workflow, a detailed readme document, and an AppleScript file (in case you want to edit or adapt the script yourself). Note: If you are on Windows, you can trigger hotkeys for menu items in Isadora by using Andy Carluccio's AutoHotkey Launcher Actor:

Deadman’s Switch User Actor – User Actor

This Deadman's Switch User Actor gives you the option to set a key and then hook it up to a Gate actor so that you can keep the Gate open only when the key is held down, or only open the Gate when the key is released.

OSC Basic Test File – Patch

This helpful OSC Basic Test File comes with a read-me document that will help you troubleshoot if you're finding it tricky to send OSC to or from Isadora.

Snowperson User Actor – User Actor

I created this User Actor in a futile attempt to distract myself from the stifling Berlin summer heat. Since this User Actor failed to do anything about the temperature, hopefully someone will find it to be an interesting example of how to use Shapes actors to create simple characters and animations. The use of the 3D Particles actor to create snow also serves as a cursory example of how to use Isadora actors to create simple weather animations that, unlike videos of weather, can play infinitely without the need to worry about disguising a loop point.The download contains the User Actor and a simple example file.The first Scene of the example file contains one instance of the User Actor with default settings which creates a snowperson at the center of the screen with continuous snowfall.The second Scene of the example file contains four instances of the User Actor adjusted to make a little snow person family that all blink in a randomized order at random intervals.

Date Comparison User Actors – User Actor

These are various User Actors for comparing two dates, re-formatting dates, and checking if an expiration date has been reached. Thanks to Andy Carluccio of Liminal Entertainment Technologies for providing the JavaScript that made this all possible. Changelog: v2: Added an expanded version of the Date Convertor User Actor (Date Convertor v2)Added a new User Actor (Date Validator) created with more Javascript from the generous and brilliant Andy Carluccio.

JavaScript ASCII and Character Convertor – User Actor

This User Actor can convert ASCII values into characters, as well as convert single characters into ASCII values.Additionally, there is an output that tells you if the character is a number (0-9) and another output that gives you the character as an integer (instead of a string) if the character is a number (0-9). A complete table of ASCII characters can be found here: CHANGELOG: v2 2022-06-08Added an input that lets you set the notify mode for the Comparator used for the number-related outputs.

JavaScript String Length – User Actor

This User Actor can be fed a string of characters (or a value) and will tell you the number of characters (length) of the input. There is also an input that affects the count for the "value" input which allows you to either ignore or not ignore the "-" character if the incoming number is negative. Example Strings: Bob = 3 Terry = 5 Example Values: 76 = 2 0.3 = 3 -0.3 = 4 (with Ignore "-" set to "off") -0.3 = 3 (with Ignore "-" set to "on")

Simple MIDI Example – Patch

A short example file showing some simple ways to use MIDI notes to change values in your patch. It includes two screenshots showing basic Live Capture and MIDI Setup for sending MIDI notes from Isadora to Isadora. The patch covers:Starting Live CaptureSending MIDI from Isadora to IsadoraUsing a Text Draw actor to display the incoming MIDI Note and a Speak Text actor to say it.Colorizing live video dynamically based on the pitch of the MIDI note.Colorizing Shape with one of three pre-selected colors based on which of three ranges the incoming MIDI note falls into.Colorizing a pulsing/exploding shape with Explode and a Decay GeneratorUsing the MIDI note to change the color of the Live Drawing actor while using the mouse to draw.Using the MIDI note to change the color of the Live Drawing actor while using the pitch and velocity of the note as x/y coordinates, letting you draw automatically with the random MIDI notes.

Audio Trigger – User Actor

A simple User Actor that allows a sound file to be selected and then triggered with Keyboard Watcher, MIDI Note, MIDI Control Change, or OSC.For MIDI Notes it triggers when sent the specified note at any velocity, so make sure not to send a note off or you'll double-trigger it.For MIDI Control Changes it triggers when sent the specified controller at the specified value.For OSC it triggers when a value is sent on the specified channel that is greater than or equal to the specified value (default is 1 so it can be used with buttons that send 1/0).If you want it to trigger on value 0 for OSC, you'll need to open up the User Actor and make sure to change the 'value1' input of the Comparator actor to initialize at a value other than zero.If you want it to change the mode of the Comparator actor for OSC, you'll need to open up the User Actor and change it inside the User Actor.The download also includes a template Isadora Patch with a Scene that contains 18 of the User Actors, with ten of them already set to use keys 1 - 9 and 0.

1 Wii Remote – User Actor

An Isadora User Actor, Isadora Patch, and OSCulator file that allows control of Isadora via OSC using a Wii Remote. OSCulator is a Mac-only software that costs $20 USD and, among other things, allows you to use a Wii Remote as a wireless controller by taking the data collected from the Wii Remote and transmitting it via OSC or MIDI to other software on your computer. When paired with Isadora, it allows you to use the Wii Remote as an interactive controller/data source for anything inside your Isadora Patch. CHANGELOG v3 - 2022-05-31Updated the Wii Remote User Actor to allow the first OSC Channel to be set (so it's easier to move to different files)Gave the Wii Remote User Actor a new input and four new outputs that give information about the chosen item (OSC channel, OSC address, function, location of button).Added a Comment to the first Scene that explains how the Wii Remote User Actor works.Added a Comment to the first Scene that explains how to use the Wii Remote User Actor with a file that isn't the example file (and therefore doesn't already have the OSC addresses setup).Created a User Actor for each of the three Logic examples in the second Scene (and added them to the download).Organized and labeled the OSC Multi Listeners better in the third Scene.Added screenshots of the OSCulator settings to the download.Added a text file with the OSCulator OSC addresses.v2 - 2020-11-04Changed the OSCulator file so that it uses port 8001 instead of port 8000 so that it does not conflict with ZoomOSC.Added three examples of how I use the Wiimote.One set of examples that trigger if the chosen button is pressed and released 3x within the span of 1 second.One set of examples that prevents you from triggering things with the "GO" button unless the "primer" button held down.One set of examples where accelerometer data is only allowed to pass through when a specific button is held down.

Live Drawing Example – Patch

A simple example of how to use the Live Drawing actor.

Synched Control Panel and Keyboard Watcher – Patch

This Isadora example file demonstrates how to control a Gate actor in your patch with either a Keyboard Watcher actor or one of a number of different Controls while still keeping the Control Panel in sync and showing the correct state of the Gate.

ZoomOSC User Actors & Template File – Patch

User Actors and a template file for working with Liminal Entertainment Technologies' software ZoomOSC. These User Actors and this Isadora template file aim to make it as easy as possible to get up and running with ZoomOSC. If you've already set up OSC communication between Isadora and ZoomOSC by changing the required settings in ZoomOSC, then this file is plug-and-play (meaning it should work immediately without any adjustments or setup on the Isadora side). Changelog v10 (2021-12-14):Added a Scene called "Example Functions" that outlines some basic functions that can be performed with the User Actors.Added a Scene called "Chat Commands" that outlines how to create chat commands.There are two new User Actors in the User Actors folder: "Chat Command" and "Chat Command Settings".Moved the "Liminal 48 Zoom Selector" to its own Isadora file.Changelog v8 (2021-12-1):Note: If you already have the User Actors in your Global User Actors Folder, trash your current version of the "Chat Parser" and "Chatbot Response" User Actors and get the new ones from this download.Simplified the setup by combining the four necessary setup User Actors into a new User Actor "ZoomOSC Setup". (If you want to use this User Actor in other files, you'll need to put it into your Global User Actor Folder.)Updated the instructions slightly in the "Show Template" Scene.Added a new example Scene "Marco Polo Chatbot".Fixed a parsing bug in the Chat Parser User Actor.Fixed a parsing bug in the Chatbot Response User Actor.Added a description of the 3-Value Comparator inside the User Actor and the "Javascript (User Actors)" Scene.Added explanations on how to do custom settings for OSC Channels, UDP Addresses, and Ports in the "Setup (User Actors)" Scene (scroll down).Changelog v7 (2021-11-15):Added a "ZoomOSC Setup" Scene + Screenshot of ZoomOSC SettingsAdded an example chat-parsing SceneAdded all User Actors in a folder

Random Media + Random Duration – Patch

This example patch has twelve example scenes that show how to:Randomly select a video, picture, or sound file to be played (without repeating any files until each has been played once, after which a new random order is generated)Play the randomly selected file for a set duration then start the next random file immediatelyPlay the randomly selected file for a random duration then start the next random file immediatelyPlay the randomly selected file for a set duration then start then crossfade to the next random filePlay the randomly selected file for a random duration then crossfade to the next random file

Wipe Transition User Actors – User Actor

These two Wipe Transition User Actors allow you to feed in two video sources and then transition from one source to the other (and back) with a wipe transition from the left, right, top, bottom, or any combination of those four directions.

JavaScript Sequential Calculator – Patch

Ever have a sequence of shapes or images that you need to space evenly across the screen, or have a number of visual elements that need their position to be based on the position of the previous visual element in the sequence? If so, this JavaScript Sequential Calculator Macro will make your life much easier, since it'll allow you to adjust the position of everything in the sequence or the spacing between them. I've included a simple example patch that shows how this can be used to space three shapes easily and adjust them all as a group. Note: Since you need to set the number of outputs on the Javascript actor for this to work, it can't actually be part of a User Actor or Macro. Therefore I just put it into a Macro so that it can be saved as a Macro, searched for easily, then copy-pasted out of the Macro when it is needed. JavaScript code credit goes to Gertjan Biasino:

JavaScript Line Count – User Actor

This helpful JavaScript-based User Actor takes in a multi-line string and gives you a count of how many lines it contains (both as an integer and as a string). Credit goes to Andy Carluccio for the JavaScript code in this User Actor.

Mouse Control of 3D Particles – Patch

The first Scene of this patch is a cool, simple demonstration of how to use your computer mouse to control 3D particles in Isadora. The next few Scenes take this concept and run with it, playing with color, size, replication, and video effects. There are two scenes at the end of the patch that are more complex. The second-to-last scene lets you click on a location on the Stage to create fireworks, and/or generate fireworks randomly, and/or change a number of different variables about the fireworks. The last scene uses a 3D Particles actor with some flip actors and a Get Stage Image actor to create a feedback loop that lets you do aesthetically pleasing, semi-random digital drawings.

Basics of NDI Input and Output – Patch

This is a very simple file that explains the very basics of using NDI with Isadora; how to output NDI from Isadora’s Stage Setup and how to pull in NDI using Isadora’s NDI Watcher actor.   Note: Before working with this patch you'll want to download and install the official TroikaTronix NDI Watcher actor:

Rainbow Difference Trails – Patch

In this mini-tutorial, you'll learn how to use the Difference actor to add psychedelic rainbow motion blur trails to a live video feed.

Media Info – User Actor

This User Actor provides numerous pieces of information about the chosen media, as well as using Javascript to remove the file extension so that the name of the file can be used elsewhere in your Isadora patch for text parsing or sent into Zoom chat using ZoomOSC as part of a chatbot function.

Text Comparator Expanded – User Actor

This User Actor has all the functions of the normal Text Comparator actor, but adds an additional mode that detects if the incoming string ('text 1' input) contains the string specified in the 'text 2' input.   This additional mode is extremely useful for parsing text where you're not looking for an exact match, but rather to see if a certain character, word, or series of words is present somewhere in the incoming string. I use this User Actor in tandem with ZoomOSC to parse Zoom chat for chat commands in order to make Zoom-native, interactive games, Zoom Chat commands, chatbots, voting/polling/scoring mechanics, and virtual theatre functions with Isadora.