Skip to content

Installation

Processing Contribution Manager

After the 1.5.0 package is published:

  1. Open Processing.
  2. Select Sketch > Import Library > Add Library....
  3. Search for ziviDomeLive.
  4. Install the library and its declared dependencies.
  5. Restart Processing.

Open File > Examples > Contributed Libraries > ziviDomeLive > EmptyProject. The empty black scene should start without shader or dependency errors; press h to confirm that the control panel can be shown and hidden.

NDI is optional and cannot be installed through Processing's Contribution Manager. Install the system NDI Runtime separately before enabling the experimental NDI video output.

Release Artifact

For manual installation, use the packaged artifact from the matching release rather than the repository source ZIP:

  1. Download ziviDomeLive.zip or ziviDomeLive.pdex.
  2. Extract the top-level ziviDomeLive folder.
  3. Move it into the sketchbook libraries directory shown in Processing Preferences.
  4. Install ControlP5 and the required platform output dependency.
  5. Restart Processing.

The archive includes Devolay but not the proprietary NDI Runtime. NDI users must complete the separate NDI Runtime installation for their operating system.

The installed structure must contain:

libraries/ziviDomeLive/
  library.properties
  library/
  examples/
  reference/

Source Checkout

For development:

git clone https://github.com/vicvalentim/ziviDomeLive.git
cd ziviDomeLive
./gradlew buildReleaseArtifacts
./gradlew qualificationTests

The installable output is generated under release/.

For a local sketchbook deployment instead of a release package:

./gradlew deployToProcessingSketchbook

This task deploys the library and examples, but deliberately excludes src/test and does not execute qualification. Run qualificationTests separately before treating the checkout as release-ready.