Skip to content
Digitalenationdiscover

Device management

Connect stage devices to an Arthoff project, test connections, use devices in cues, create groups and presets, and diagnose common communication issues.

Devices can be connected directly to an Arthoff project and then controlled from cues. This includes lighting consoles, audio systems, cameras, effect machines, and devices controlled through OSC, MIDI, or HTTP.

Connecting a device to a project

Open Devices

Open the project and go to Devices.

Add a device

Click + Add device and choose the appropriate type:

  • Lighting: DMX, Art-Net, sACN, or a console controlled through OSC/MIDI.
  • Sound: mixer, player, or effect processor.
  • Video / Camera: SDI, NDI, PTZ camera, or capture card.
  • Effect machines: lifts, rotating platforms, pyrotechnics controlled through relays or OSC.
  • Other: generic OSC, MIDI, or HTTP device.

Configure the connection

Depending on the protocol, provide the device's IP address or hostname, port, protocol, and an optional unit identifier such as a DMX universe or MIDI channel. You can also add internal notes for the technical team.

Connect

Save the device and connect it. Arthoff shows the current connection status using a status indicator: green for connected, yellow while connecting, and red when the connection fails.

Art-Net tip

For an Art-Net console, make sure remote control is enabled on the console and that the configured port matches the device. Art-Net commonly uses UDP port 6454.

Testing a connection

Use test mode before relying on a device during a rehearsal or live event.

Open the device details and enable Test mode using the wrench icon.

Use the test controls appropriate for the selected device:

  • DMX / lighting: channel sliders and presets.
  • Audio: test tone and volume controls.
  • Camera: preview and PTZ controls.
  • Effects: movement or activation controls.

Verify that the physical device reacts correctly. Values from the test panel are sent immediately, so use it carefully around moving equipment and stage effects.

Exit test mode after verification.

Using a device in a cue

Lighting cue

Create a Lighting cue, select the lighting device, and define values such as:

1:255, 2:128, 3:0

You can also choose a group or preset and set a fade time before saving the cue.

Audio cue

For an Audio cue, choose the mixer or playback device and configure the source, for example a URL or line input, together with volume, pan, fades, and playback mode.

Camera cue

For a Camera cue, choose a PTZ camera and configure values such as Pan, Tilt, Zoom, or a saved preset. The transition may use Cut, Fade, or Wipe, with an optional duration.

Custom OSC, MIDI, or HTTP cue

For a custom device command, select the protocol and provide its address or command. Examples include:

/light/1/intensity
CC 10, channel 3
http://device.local/api/relay/1

Set the command value and its data type when required by the protocol.

Device groups and presets

Groups make it possible to control several devices as one logical unit.

Go to Devices and open the group manager.

Create a group, give it a name, and select the devices that belong to it.

Save the group and use it when configuring compatible cues.

Lighting presets can also be saved from a console. When creating a cue, select the preset, optionally configure a fade time, and save it.

Dry run without sending commands

Use dry-run mode when you want to verify the show flow without controlling real hardware.

Open the presenter at /present.

Enable Test mode using the flask icon.

Run cues normally. Arthoff does not send real device commands and instead exposes debug information in the browser developer console.

Use the DMX preview to inspect simulated output values.

Disable test mode before the real run.

Troubleshooting

The device does not connect

Check that the device is powered on and reachable on the network, then verify the selected protocol, port, and remote-control/API settings. A simple ping can help confirm network reachability. Also check host and network firewalls.

The cue runs, but the device does not react

First verify the same values in the device test panel. Make sure the device is not configured as preview only, and verify that command values are within the expected range, for example DMX 0–255 or MIDI CC 0–127. For lighting consoles, also check direct output and patch configuration.

Commands arrive with noticeable latency

A healthy local stage network should normally have low latency. Check whether ping times stay below roughly 30 ms, prefer wired Ethernet over Wi-Fi, and inspect buffering on USB MIDI interfaces. Arthoff may poll some device states periodically; the default interval is 500 ms and should only be reduced when the device and network can handle the extra traffic.

Example configurations

Theatre: conventional lighting through Art-Net

Connect an ETC EOS-class console through Art-Net, create a group for four front lights, configure DMX values and fades in lighting cues, and verify everything in test mode before rehearsal.

Conference: Yamaha CL5 over MIDI

Connect the console through USB MIDI, use the appropriate MIDI channel, create an Audio cue that switches the required line input and gain, and use a Custom MIDI cue for additional commands such as reverb changes.

Concert: moving heads and smoke

Use Art-Net for moving heads and OSC-controlled relays for stage effects. Group fixtures where useful and trigger a custom command such as /relay/2 1, followed by /relay/2 0 when the effect should stop. Test the sequence in dry-run mode first.

Corporate event: PTZ camera and recording API

Connect a PTZ camera through VISCA over IP or NDI and control a recording system through HTTP. Camera cues can recall PTZ presets, while custom HTTP cues can call endpoints such as POST /api/recording/start and the corresponding stop endpoint.

FAQ

Can one device be active in several projects at the same time? A device can be active in only one project at a time.

Can Arthoff update device firmware? No. Firmware updates should be performed using the manufacturer's tools.

Is there a hard limit on the number of devices? Arthoff does not impose an artificial device-count limit. Practical limits depend on the network, protocols, and the connected hardware.

Can I inspect commands that were sent to a device? Yes. Device details include command history with timestamps, protocol information, and values. The history is retained for 30 days.

On this page