Skip to content
Telematic Theater

Installation

Downloads

Section titled “Downloads”

In order to run the Visual Stage app, you’ll need multiple files and applications installed on your computer.

  1. Download and install Cycling’74 Max. The demo version is enough as its main limitation outside of the 30-days trial is the impossibility to save patchers, which isn’t necessary to run the Visual Stage app as it comes with its own saving features.
  2. For a stable version (as much as it can be), download the latest release and extract the folder contained in the .zip. If you want the very latest version, clone the repository instead, with the following command:
Terminal window
frame="none"
    git clone --depth 1 https://github.com/Zakros-InterArts/telematic-theater

The --depth 1 part in the git command is to avoid downloading the quite large history of modifications, resulting in a download size of around 200MB instead of +10GB.

  1. Place the downloaded folder in a convenient location (typically \~/Documents).
  2. Download (2.1GB) this assets folder, unzip it and replace Telematic-Theater/projects/Default_project/assets with that one.
  3. In Max, go to the Options menu, then “File Preferences”. Add a new path and select the telematic-theater/Telematic-Theater folder from the cloned repository.
  4. Still in Max, open the Package Manager (Files menu, then “Show Package Manager”), and make sure you have the following packages installed, or install them otherwise:
  • CNMAT Externals
  • jit.mo
  • ease
  • link
  • ISF
  1. In order to complete the installation of the ISF package, you need to download and install ISF shader files (macOS, Windows). During the installation, you can unselect the editor app and install only the ISF example files. Then, restart Max and re-open the ISF launcher to make sure the ISF files are correctly installed.
  2. You then need to install the jit.ndi package, which isn’t available through the Max Package Manager.
    • Download the jit.ndi Max package and install it by unzipping the downloaded file into the Max Packages folder (usually \~/Documents/Max 9/Packages).
    • Download (macOS, Windows) and install the NDI runtime.

Starting up

Section titled “Starting up”

Once all of the prerequisites are done, you can run the Visual Stage app. Here is a quick walkthrough to get the default project up and running, making sure everything is properly set up.

  1. Open Telematic-Theater/Telematic Theater.maxpat. This will take from 15 seconds to more than a minute depending on your computer.
  2. When you open it for the first time, you might get a warning message from macOS saying “External cannot be loaded due to macOS quarantine” related to the jit.ndi package. You can safely tick “Apply to all for this patcher” and click OK.
  3. Once the app is loaded, you should see this screen: The appearance of the app just after being open A second window, black and detached from the main app, should also appear. This is the rendering window. Now it’s time to make sure everything works, following the next steps: TT_startup_1.png
  4. Select a project from the Project Menu. The Default Project is good for testing.
  5. Turn on the main startup toggle. This will load the currently selected project,initialize the application and start the metronome.
    It will also set the rendering window to full-screen. If you’d like to exit full-screen mode, press the ESC key.
  6. Turn on the Render toggle.
  7. Click on the “Mixer” button to select the Mixer layout
  8. Select preset 2 from the Setup Preset Menu. This should populate the view with the used modules for this configuration. TT_startup_1.png
  9. In the presets grid, click on Scene 2 to recall the various presets assigned to that scene. If everything is fine, you should get something like this from the output screen: TT_Default_project.png

Spat Revolution (optional)

Section titled “Spat Revolution (optional)”

If you want to benefit from spatialized audio in the Stage, you will need a copy of Spat Revolution by FLUX::. The following section will guide you through its configuration to make it work in tandem with the Visual Stage app.

Typically, Spat Revolution will be used to spatialize the 4 performers in the stage relatively to the camera point of view, and another mixing software will be used to gather all audio sources together and sum them for the final output.

See Spat settings to know how to set the app to send data to Spat, and configure Spat accordingly.