Readme

Prismatik Art-Net plugin

This plugin adds ArtNet support to your Prismatik software. ArtNet is a protocol that allows DMX lighting data to be transmitted over an ethernet network. The plugin talks to an ArtNet node, connected to your DMX lighting fixtures with DMX-cables.

Table of contents

• Dependencies

• Installation

• Configuration

• Start the plugin

• Troubleshooting

• Useful URLs

• ---

Dependencies

• StupidArtnet

• Python 3.6

• Beautiful Soup 4

• Prismatik (unofficail fork) (Tested on 5.11.2.25)

• lightpack.py (extended by Lasse Götte)

• ---

Installation

Install Python (I tested it on Python 3.6.9, but it should work on the current version)

Install Beautiful Soup 4 by entering pip install bs4 in the terminal.

In Prismatik:

• Setup your Device (you can use this plugin with every Prismatik compatible device. If your only Device is the Art-Net Node, choose Virtual LED device)
• Check Expert mode under the Profiles menu
• Check Enable server under the Experimental menu

Download and extract the repository

Place ArtNet folder from the extracted repo in the Prismatik plugin directory:

• Windows: C:\Users\username\Prismatik\Plugins\
• Linux: /home/username/.Prismatik/Plugins/

Adjust settings in the ArtNet.ini file (instructions in the next chapter)

Configuration

Edit ArtNet.ini in the ArtNet plugin folder with your preferred text editor

• [Lightpack]

  • Generate a Api-key in the Experimental menu in Prismatik and copy it
  • Paste the Api-key in the key line in the ini file

• [Artnet]

  • Enter the IP of your Art-Net node in the host line
  • Enter the DMX-universe you want to use in the universe line

• [Fixtures]

  • Start with a title like [Fixture_xxx] (xxx is the name, you can customize. I recommend 001,002,...)
  • Enter the DMX channel range in the range line (the range consists two numbers, separated by a ",". The first number is the start channel and the second number is the channel count)
  • Enter the DMX channel types in the mapping line (the types are R=red, G=green, B=blue, D=dimmer, -=not in use)
  • The channel types are entered in channel order. Each fixture has to have just one of the types (R,G,B,D). Other channel types are not needed and marked by -
  • Below is an example for an 4 channel RGBAW+Dimmer fixture on channel 1
  • The order of the fixtures in the ini file is mapped to the order of the LEDs in Prismatik

• ---

Start the plugin

• Click the refresh button in the Plugins menu in Prismatik

• Check the Art-Net plugin in the Plugins menu in Prismatik

• ---

Troubleshooting

• Click on the Art-Net plugin in the Plugins menu

• Click on Log in the Info field

• If the log is empty, make sure you set the right path to the Python executable in the ini file

• ERROR-01

  • One or both values in the fixtures range in the ini file are 0
  • The first valid channel and the minimum channel count is 1

• ERROR-02

  • The channel range is out of range (1-512)
  • Make sure, the start channel is not defined below 1 or above 512
  • Make sure, the range is not reaching out of 512 (starting at the start channel)

• ERROR-03

  • Only the characters R,G,B,D,- are allowed in the fixture mapping

• ERROR-04

  • Each character of R,G,B,D,- is unique in the fixture mapping
  • If your DMX device has multiple RGB channels (for example a LED-bar), define multiple fixtures for it

• ERROR-05

  • Each character of R,G,B,D,- has to be exactly once in each fixture's mapping
  • If your DMX device has no dimmer, define it as a 4 channel device with the 4th channel as D (dimmer)

• ERROR-06

  • The amount of R,G,B,D,- characters in the fixture mapping has to match the channel count, defined in the fixture range

• ERROR-07

  • You have to define as many fixtures as LEDs, defined in Prismatik

• ---

Useful URLs

• Build a simple diy Art-Net node