Configure Device and Software

Comprehensive Installation and Configuration Guide

TouchDesigner Installation and Setup

1. Download TouchDesigner:

   • Visit the official TouchDesigner website and navigate to the download section.

   • Choose the version suitable for your operating system (Windows or macOS) and download the installer.

2. Install TouchDesigner:

   • Locate the downloaded installer file on your computer.

   • Double-click the installer and follow the on-screen instructions to complete the installation process.

3. Open TouchDesigner:

   • After installation, open TouchDesigner by clicking on its icon in your Applications folder (macOS) or Start Menu (Windows).

   • Upon first launch, you may need to log in or create an account if prompted.

     The Non-Commercial version will get you started, but I highly recommend checking out the full version for your production ready anything-to-anything programming environment.

   • Proceed to Install and Open Resolume FIRST then navigate to and open the ‘NEWP Res2SD TD.toe’ file.

     Note Resolume can be opened after Res2SD TD, however you will need to reacquire the Max Column Count with the Get Resolume Columns Button at the bottom of the Res2SD Interface. This is required anytime the Max Column Count changes after Res2SD is opened.

Resolume Arena Installation and Setup

1. Download Resolume Arena:

   • Go to the Resolume website and download the Resolume Arena installer for your OS.

2. Install Resolume Arena:

   • Run the downloaded installer and follow the installation instructions.

3. Open Resolume Arena:

   • Launch Resolume Arena from your applications or programs list.

4. Configure Resolume Arena:

   • Open Preferences: Use Ctrl + , (Windows) or Cmd + , (macOS).

   • OSC Settings: Navigate to the OSC Menu, enable OSC Input (7000) and Output (7001) with default ports. Close Preferences.

   • Open Mappings and enable OSC Shortcut Mapping. In the OSC Shortcuts Panel, select All OSC Outputs from the dropdown.

     If using an existing OSC Setup with custom OSC outs from Resolume, the Horizontal Scroll bar under the Clips Panel must be Outputting it’s Default Address.

   • Webserver & REST API: In the Webserver Menu, enable the webserver and REST API, set the default listen port to 8080, and use 127.0.0.1 for the listen address.

Bitfocus Companion Installation and Setup

1. Download Bitfocus Companion:

   • Visit the Bitfocus Companion website and download the latest version suitable for your system.

2. Install Bitfocus Companion:

   • Execute the installer file and complete the setup by following the on-screen instructions.

3. Open Bitfocus Companion:

   • Start the Bitfocus Companion application from your applications or programs list.

4. Configure Bitfocus Companion:

   • Defaults: The first pop up window will default to 127.0.0.1:8000 for Companion. This is good.

   • Launch GUI: Open the Bitfocus Companion GUI.

   • Configuration Wizard: Use the wizard for initial setup.

   • Remote Control Services: Enable UDP Raw Socket (16759) and Open Sound Control (OSC) (12321).

   • Import Companion Configuration: Navigate to the Import/Export page. Select Import Configuration, find the ‘NEWP Res2SD Companion Config’ file in the provided folder and select it for import

     !! If you have existing Configs, Export them now to not lose your Companion Programming !!

     The Default Import Settings include the Buttons and Custom Variables

     Reset and Import the Configuration File

   • Rotate the Companion: Navigate to the Surfaces page. Ensure your Streamdeck is plugged in and recognized, locate the Settings Icon on the right side of the page. Use the Dropdown under Button Rotation to match the physical orientation of your Streamdeck Device.

Configure Res2SD Gui

1. Match IPs and Ports: Go through each Companion and Resolume Communication IP Address and Port and ensure they Match in their appropriate fields in the Res2SD Gui.

2. Hover over any Field or Button in the Gui for a second to see a popup help window.

3. Match the Streamdeck ID: In the Companion Gui, Navigate to the Surfaces page. Locate the Stream Deck ID under connected devices and Copy the <Value> after ‘Streamdeck ID:’<Value> and paste it into the Res2SD Field.

4. Match the Size and Orientation: In Res2SD, the Size can be selected in the Top Right by a Toggle Button. The Orientation button can be activated. Note you need to reselect the orientation after you select the deck size.

5. Get Resolume Columns: Currently the Max Columns in your Resolume Composition must be manually attained after Changing the Column Count by Inserting, Deleting, or Adding Columns in Resolume. Simply double click the button on bottom and watch your Max Column count go from Wrong to -1 to Correct.

That’s it! Thank you for your support and endeavors as a VJ! I hope you have all the fun and melt all the eyeholes as you push pixels across whatever stages you find yourselves on!