🇬🇧 English   🇩🇪 Deutsch

ArtNet Director

A client-server based application for the selective redirection of Art-Net packets.
Explore the docs »

Report Bug · Request Feature · Ask a Question

About The Project

ArtNet Director is a client-server based application, for the selective redirection of Art-Net packets. Its main purpose is to facilitate switching between multiple users when restricted to a limited amount of Art-Net nodes. It is operated using a web interface meaning it runs as a server on another computer, which can then be accessed by other computers in a local network using a web browser.

Installation

You'll need Java installed on your machine to run this application.

• Download the latest jar file from the releases
• Put the jar file in a new directory
• Run the jar file, e.g. by double clicking it or from your command line:

java -jar ArtNetDirector.jar

In the console you'll find what to open in the web browser

Building from Source

This project was built using the following things:

• Java
• Gradle
• npm

First, clone the repository and move into it:

git clone https://github.com/gelaechter/ArtNetDirector
cd ArtNetDirector

Then install all npm packages, this also installs Webpack and TypeScript:

npm install

Run Webpack to transpile TypeScript files:

webpack --no-watch

Create a uber jar using Gradle:

./gradlew shadowJar

Usage

1. You start the application on a computer.
2. You configure nodes, their IP addresses etc. in the web admin interface.
   (address is found in the applications console)
3. All users set their Art-Net output to the IP address of the host server.
   (address also found in the applications console)
4. The users can then toggle to which nodes they want to transmit their Art-Net packets in the web user interface.

For more in-depth explanations refer to the Documentation

Contributing

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgements

• This project uses Art-Net™ Designed by and Copyright Artistic Licence Holdings Ltd
• It also uses my fork of artnet4j by cansik
• Special thanks to my CS teacher who not only came up with the idea but let me work on it during lessons