PyDMXControl 2.0.0

Description:

PyDMXControl 2.0.0

A Python 3 module to control DMX using OpenDMX or uDMX - Featuring fixture profiles, built-in effects and a web control panel.






































Installation
Install via pip (recommended)
pip install -U PyDMXControl

Install via pip with audio support
pip install -U PyDMXControl[audio]

Install via GitHub (development version, with audio)
pip install -U git+https://github.com/MattIPv4/PyDMXControl#egg=PyDMXControl[audio]

Features


FIXTURE profiles per manufacturer (see all included profiles)

Generic dimmer fixture included, single channel
RGB (3-channel) fixture with virtual dimmer built-in



EFFECT module/library support (see all packaged effects)

Intensity dim chase provided, configurable speed and offset provided
Included is a fixture color chase effect, unlimited number of colors supported
Effects can be applied to individual fixtures or multiple as a group



OpenDMX and uDMX works out of the box

Package developed on and tested extensively with a uDMX system
OpenDMX (FTDI) controller also provided, as well as direct serial
Extensible for custom transmitting controllers



CUSTOM callbacks supported with an internal ticker

Have actions take place on their own at certain times using the callback ticker



THREADED to allow continuous runtime

Run your own blocking scripts whilst PyDMXControl continues to output data



WEBSITE control panel built in

Global and individual fixture intensity control via sliders
Quick access to callback functions globally and for each fixture
Color picker for individual fixtures as well as specific channel control



JSON fixture configurations

Load fixture configurations from JSON files into the controller
Save your current set of fixtures out to JSON files for later use



Optional AUDIO playback supported

Play audio tracks whilst PyDMXControl continues to run lighting control
Uses pygame for best cross-platform and audio format support



Example Usage
An example of how to get a single dimmer working with PyDMXControl,
providing the web control panel and the console debug system once started.
# Import the OpenDMX or uDMX controller from PyDMXControl,
# this will be how the data is outputted.
from PyDMXControl.controllers import OpenDMXController
# from PyDMXControl.controllers import uDMXController

# Import the fixture profile we will use,
# the simple Dimmer in this example.
from PyDMXControl.profiles.Generic import Dimmer

# Create an instance of the uDMX controller,
# this holds all the fixture information and outputs it.
# This will start outputting data immediately.
dmx = OpenDMXController()
# dmx = uDMXController()

# Add a new Dimmer fixture to our controller
# and save it to a variable so we can access it.
# We give it a name so it's easier to identify in the debug control options.
fixture = dmx.add_fixture(Dimmer, name="My_First_Dimmer")

# Next, dim the intensity of the fixture from it's initial value of zero
# to full, which is represented as 255 in DMX.
# This is done over 5000 milliseconds, or 5 seconds.
fixture.dim(255, 5000)

# We can now start the web control panel built into PyDMXControl.
# This will output the web address in console, but should be http://0.0.0.0:8080
# This runs in the background and so we can continue to do other things still.
dmx.web_control()

# The console debug mode can also be started if required,
# this provides basic control options in the console of the program.
# This is blocking however and so the script will not continue past here until
# the debug control is exited. This won't stop DMX output.
dmx.debug_control()

# Once the console debug mode is exited the script will continue, to stop it
# exiting and stopping DMX output when can use a built-in sleep function.
# This sleep function will wait until enter is pressed in the console before continuing.
dmx.sleep_till_enter()

# With everything done, you can terminate the DMX output and the program by calling
# the close method of the controller.
# This will cleanly close any threads in use and stop DMX output.
dmx.close()


For a "real life" example, please take a look at my home automation office lighting script.

What is the point of this?
Just messing around with using Python to control/send DMX.
Supports fixture profiling; Has defaults for a standard fixture and fixtures that need virtual dimmers.
Prebuilt profiles for generic fixtures (Single dimmer, RGB LED, Custom (set your own number of channels)).
Has a debug shell that allows control of fixture channel values and access to general callbacks. Additionally, provides
an advanced web control panel with access to global callbacks, fixture helpers, fixture colors and control over
individual fixture channels.
Currently, output is supported via OpenDMX, uDMX or raw serial.
If someone wants to buy me an Enttec USB DMX Pro then I'll try make it work with that too.
Thank you to Dave Hocker, author of pyudmx, for his work on pyudmx and his
advice via email in solving some of the issues making this library behave with uDMX.

Contributing
Contributions are always welcome to this project!
Take a look at any existing issues on this repository for starting places to help contribute towards, or simply create your own new contribution to the project.
Please make sure to follow the existing standards within the project such as code styles, naming conventions and commenting/documentation.
When you are ready, simply create a pull request for your contribution and I will review it whenever I can!
Donating
You can also help me and the project out by sponsoring me through GitHub Sponsors (preferred), contributing through a donation on PayPal or by supporting me monthly on my Patreon page.












Discussion, Support and Issues
Need support with this project, have found an issue or want to chat with others about contributing to the project?

Please check the project's issues page first for support & bugs!

Not found what you need here?

If you have an issue, please create a GitHub issue here to report the situation, include as much detail as you can!
or, You can join our Slack workspace to discuss any issue, to get support for the project or to chat with contributors and myself: