Augmenta Scanner plugin for Ableton Live

⚠️

Warning : This integration is outdated and might not work with the latest versions of Processing and Augmenta. We are no longer maintaining this integration, it’s community based.

⬇️

Download link : https://github.com/Augmenta-tech/Augmenta-scanner/archive/refs/heads/main.zip Github source : Augmenta-tech/Augmenta-scanner: Plugin for interactive music in Ableton Live (M4L) (github.com)

Augmenta Scanner is an Ableton live plugin (Max4Live to create music in interaction with performers or objects in space tracked with Augmenta. A bar is scanning the space and triggers midi notes when passing over a performer. The plugin receives Augmenta OSC data as inputs and produces midi notes and mappings for Ableton live.

How to use

Download the files from this repository or from https://maxforlive.com/

Drag’n drop the scanner plugin to Ableton live session in a MIDI track

Add your port to receive Augmenta osc data

Create music with the scan bar and objects available

To produces Augmenta data, you can use the simulator available here : Augmenta Simulator

⚠️

Note : The plugin has been developed to be used once per Ableton session. If you put several plugins in the session, latency and synchronization problems can occur.

Features

Augmenta osc input

6 persons simultaneous tracking or all persons with the same behavior (red target)

Get the simulator to simulate Augmenta data

Follow tempo option for the scanner

Osc output to send scanner bar to other softwares (see TouchDesigner example)

Interface

6 areas for MIDI notes triggers :

plain text
    - Mute Button to disable MIDI out of the selected person or object
    - MIDI note selector
    - Velocity and Duration control of the MIDI note
    - Button to enable Random mode
    - Speed control of random rate
    - Random notes choice menu

Scales menu :

plain text
    - Min
    - Maj
    - Scales selector
    - Octave selector (When the oct1-4 mode is selected, the octave of notes triggered by persons/objects depends on their position on the bar. If they are down  the octave will be low and the higher they go the higher the octave increases).

All feature of the scales menu working only when random mode is activated.

Scanner areas :

plain text
   - Start/Stop scanner shift
   - Speed control of the scan bar
   - Choose horizontal or vertical scan
   - Mapping option of the scan shift (between 0-1)
   - Controle the slider with the mouse to move the scan bar as you want (when the scan shift toggle is on stop mode).
   - Sync the movement of the scanner with your Ableton Master tempo (option between 1, 2 and 4 bar)

Preview window automatically adjusts according to scene size

Viewer toggle allows you to see the scene larger.

Output

OSC output to touchdesigner for more advance visuals project to the floor

TouchDesigner example

The scanner bar can be sent to other software with the OSC Output.

How to use

Start Touch Designer example

In Augmenta scanner : Add the ip and port output to Touch Designer

In Augmenta simulator or Fusion : Send Augmenta data to Touch Designer

Enjoy the visuals :)

Credits

Designed & developped by Guillaume BREVET, David-Alexandre CHANEL and Romain CONSTANT + the Augmenta team