python_artnet

Easy-to-use and simple python receiver for Art-Net (that also implements device polling).

Installaton

All you need to do is clone the repository

$ git clone https://github.com/sciencegey/python_artnet.git
$ cd python_artnet
$ python3 samples/exampleReceiver.py

OR

Install using PIP

$ pip install python_artnet

Usage

All you need to do to start receiving data is import the module, start the listener, then check for received data whenever you want!

import python_artnet as Artnet

# By default it will listen on 0.0.0.0 (all interfaces)
artNet = Artnet.Artnet()

# Fetch the latest packet we received from universe 0.
artNetPacket = artNet.readBuffer()[0]
# And extract the DMX data from that packet.
dmxPacket = artNetPacket.data
# You'll also want to check that there *is* data in the packet;
# if there isn't then it returns None
# See the example for more information

# Close the listener nicely :)
artNet.close()

There are also plenty of arguments you can pass when you start the listener:

• BINDIP - Which IP address you want to listen on (usually a broadcast address). This is the only one you really ever need to change. (Defaults to "" AKA 0.0.0.0 AKA all interfaces)
• PORT - Which UDP port you want to listen on. Shouldn't need to ever change this. (Defaults to 6454)
• UNILENGTH - How many universes to listen on. (Defaults to 16, has a theoretical maximum of 32,768, see Art-Net documentation for more information)

The artnet packet consists of the following:

• ver - Which version of Art-Net the packet is using. Latest is V4 (14)
• sequence - Sequence number, used to check if the packets have arrived in the correct order (counts up to 255)
• physical - The physical DMX512 port this data came from
• universe - Which universe this packet is meant for
• data - The data in the packet
• length - How much DMX data we have (full packet is 18+length)

The following functions are available to use:

• readPacket - Returns the last Art-Net packet that we received. (Returns ArtnetPacket)
• readBuffer - Returns the last Art-Net packet that we received for each universe. (Returns an array of ArtnetPacket, one per universe)
• close - Make sure to run this at the end of your program. Tells the socket to stop running and joins the thread back. (Returns None)
• version - Returns the library version. (Returns String)

Further information on how it all works can be found in the Art-Net documentation.
Art-Net™ Designed by and Copyright Artistic Licence Engineering Ltd

License

This project is licensed under an MIT License (see the LICENSE file).