Revision of Art-Net Tools from Sat, 2008-12-13 15:39

The revisions let you track differences between multiple versions of a post.

Kineme ArtDmx Sender and Receiver PatchesKineme Art-Net Tools provides two patches for interacting with Art-Net devices:

  • ArtDmx Sender --- Broadcasts a structure of DMX values to the specified IP Network, Sub-Net, and Universe.
  • ArtDmx Receiver --- Receives broadcast DMX values from the specified Sub-Net and Universe.

Both patches work with either raw DMX values (ranging from 0 to 511) or normalized values (fractional, ranging from 0.0 to 1.0), depending on whether the "Normalized Values" checkbox is set.

Version 1.1, released 2008.12.13, addresses some severe functionality bugs with the receiver, and fixes some bugs in the sender. Some minor performance improvements were also made.

Notes on the ArtDmx Sender

IP Network

In order to send ArtDmx packets, one of your computer's network interfaces must be set to a valid Art-Net IP Subnet. These are as follows:

  • (network, netmask, broadcast
  • (network, netmask, broadcast

If none of your computer's network interfaces are set accordingly, Art-Net packets will not be sent.

See the included ArtNet-SendReceive.qtz to test whether your network settings are correct --- if they are, both the top number and bottom number displayed should match approximately (there will be a delay of a frame or so).

Channel Structure

The Channel Structure input is a keyed structure --- the structure's key represents the output ArtDmx channel (0 to 511), and the structure's value represents the value to send to that channel (0 to 255).

You can also specify comma-delimited keys, representing a 16bit composite channel consisting of two arbitrary 8bit channels. For example, you could specify a key of "42,79" --- "42" is the channel to which the HSB is sent, and "79" is the channel to which the LSB is sent.

Short Frames

The ArtDmx Sender patch has the option to send Short Frames. When enabled, complete DMX512 frames will be sent at start and every 4 seconds, and short frames will be sent in the interim. This is more efficient, but may be incompatible with some hardware.

When disabled, complete DMX512 frames will always be sent.

Notes on the ArtDmx Receiver

When receiving ArtDmx packets, the Sequence and Physical fields are ignored.

The ArtDmx Receiver only recognizes ArtDmx packets. Other Art-Net packet types are ignored.

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

keezpipslab's picture
one of your computer's network interfaces

couldn't find a 'IP for dummies' so i have a question:

What is 'one of your computer's network interfaces' ?

Do I have to fill in the network , mask & broadcast numbers in the 'Network' preference panel on mac OSX, (where 'router' is broadcast ? gives a error..)

or change the ip adress of my enttec open dmx interface to it ?

Thanks, Keez

smokris's picture
IP and Subnet

keezpipslab wrote:
Do I have to fill in the network , mask & broadcast numbers in the 'Network' preference panel on mac OSX, (where 'router' is broadcast ? gives a error..)

Partially right. Try this:

  1. Run ENTTEC's Node Management Utility and press "Discovery", and hopefully it should find your ENTTEC device. Make note of the IP Address, for example "".
    • I wasn't able to get Node Management Utility to work on my Mac, so I attached the ENTTEC to a Windows XP machine to get this info.
  2. Go to System Preferences and select "Network". Then select the network interface you've got hooked up to the Art-Net device --- it'll probably be the one labeled "Ethernet".
  3. Set the "IP Address" for your Mac. The Mac's IP should be different from the ENTTEC device's IP, but on the same subnet. For example, if the ENTTEC device's IP is "", set the Mac's IP to "". The first number, "10", should be the same in both. See the attached screenshot.
  4. Set the "Subnet Mask" to "".
  5. Try running ArtNet-SendReceive.qtz, and set the Network input on the ArtDmx Sender patch to match the first number in the IP addresses.
ArtNetNetworkSettings.png103.2 KB

disuye's picture
Re: IP and Subnet

Hi - I've done all the above & got communication between the Enttec NMU program and the ODE ... but when running ArtNet-SendReceive.qtz the top number is sweeping between 0~1 however the bottom number is always fixed at 0.000 ... any ideas? I'm pretty sure all the settings are as documented / described above.

Any help, many thanks!

cwright's picture
Re: IP and Subnet

If you're using ArtNet 1.2, loopback (the SendReceive composition) will no longer work -- this is due to some shockingly stupid design decisions on Art-Net's part (where the sender must Bind to an output port -- this isn't normal, and causes packet routing to not send to the same host)

Everything else should be functional though.

disuye's picture
Re: IP and Subnet

Ah! Glad to hear that, many thanks. I assume a blinking light on the Enttec ODE is sufficient confirmation enough that signals are making it down the ethernet cable from QC (until I get a chance to plug something into the DMX port!).

Thanks again, D

conso's picture
Re: Art-Net Tools


I try to connect my grandma with the Art-Net Tools, can anyone find my mistake ?

Mac with the quartz :ip subnet router controller :ip subnet 2port - node: subnet

i change the network in the ArtDMX Sender to and the universe to 1 like in my controller.

? thanks for help

franz's picture
Re: Art-Net Tools

can the grandMA receive artNet ? I thought it would only receive the MAnet protocol ...

also, are you sending or receiving with Quartz ?

mcorke1's picture
Re: Art-Net Tools

I've been working on QC composition that receives Art-Net and colors rectangular areas of the screen based on the incoming levels. Three channels (R,G,B) per rectangle. I'm using the Art-Net Tools plugin and I've run into an issue.

If I'm only receiving one universe of Art-Net, it works great. If I'm receiving more than one universe of Art-Net, it tends to get 'confused' and sometimes responds to the wrong universe. This usually manifests as a flicker but is sometimes more prolonged. The more traffic (more universes and/or packets) the more likely this appears to happen.

I've tested with a couple of computers and with a grandMA lighting console and an Artistic Licence Etherlynx box. Same issue with both.

Any thoughts?

smokris's picture
Re: Art-Net Tools

mcorke1's picture
Re: Art-Net Tools

Great thanks! I'll test it in the next couple of days and report back.

zalexander's picture
Multiple Art-Net receivers

I was wondering if it was at all possible to have multiple Artnet receiver patches in a single composition reviving data from different universes.

I'm using snow leopard 10.6.3 and it seems that when I add more than one receiver patch the other deactivates. Is this an intentional function or am I missing something?

639me's picture
Re: Art-Net Tools

don't know if you like it, but i made an icon for the art-net tools:

nico.danger's picture
Art-Net Tools for MadMapper?


Novice QC guy here so thanks for your patience. I am wanting very badly to talk to MadMapper with a MIDI controller (i.e. BCF2000 or similar). MadMapper does not support MIDI but you can supposedly talk to it over ArtNet. How would I go about configuring my system to do this? Is it so simple as telling MadMapper to listen on the same port as I am broadcasting out of QC?

MadMapper responds to DMX on the channels listed here:

Basically all I want to do is be able to switch presets via an external controller.

Thank you, Nick

franz's picture
Re: Art-Net Tools for MadMapper?

MadMapper supports Midi, but the feature is not activated as it is not yet finished/polished to our liking.

To enable it and test it :

Close MadMapper

Launch Terminal

type in:

defaults write com.garagecube.madmapper midirouterEnabled 1

then restart MadMapper

menu edit/midi mapping