ArtnetTimecodeIn receives external Art-Net timecode and forwards it to PIXERA.
The module listens for Art-Net timecode packets on UDP port 6454, filters them by StreamID, decodes the incoming timecode, and automatically updates PIXERA through Pixera.Compound.setTimecodeInput.
Usage
Use this module when PIXERA should follow timecode received from an external Art-Net source, such as a lighting console, show controller, media server, or other networked timecode generator.
Typical use cases include driving PIXERA timeline timecode from an external control system, receiving broadcast Art-Net timecode on a selected network adapter, and using one Art-Net timecode stream as PIXERA's compound timecode input.
Procedure
- Select
Local Adapterfor the network adapter that should receive Art-Net timecode. UseAnywhen no specific adapter is required. - Set
StreamIDto the Art-Net physical stream ID expected from the sender. The value must be between0and255. - Set
Timecode Jump Sensitivity (Frames)to define how many frames may differ before the module treats the incoming timecode as a jump. - Run
initto create the UDP driver, bind to port6454, install the Art-Net receive callback, and start the watchdog timers. - The module receives Art-Net timecode packets, decodes the timecode and FPS mode, and forwards the state to
Pixera.Compound.setTimecodeInput. - Use
IsConnected,Timecode, andTimecodeModeinternally to read the current connection and received timecode state. - Run
uninitto stop the timers, remove the parser, close the UDP driver, clear the current timecode, and report a paused state to PIXERA.
The receiver detects play when incoming frame numbers progress, detects pause after repeated identical frames, and detects lost packets through a short watchdog interval. Large timecode jumps are reported as warnings and temporarily pause the forwarded timecode state before the next valid input is processed.
Data
Actions
| Action | Info | Input | Output |
|---|---|---|---|
| init | Initializes the module, creates the UDP driver, selects the local adapter, reads sensitivity and stream properties, installs the Art-Net receive callback, and starts watchdog timers. | - | - |
| uninit | Stops active timers, sets the connection state to false, removes the parser, closes the UDP driver, clears timecode state, and sends a paused state to PIXERA. | - | - |
| IsConnected | Internal status attribute for the UDP connection state. | val, doSet (bool) | connected (bool) |
| Internal.setRecFunction | Installs the receive callback that parses Art-Net timecode packets, filters by StreamID, updates timecode mode, and detects play or pause state. |
- | - |
| Internal.checkInput | Watchdog action that detects missing Art-Net packets and reports pause after several missed checks. | - | - |
| Timecode | Internal timecode attribute and state tracker. Stores received timecode, detects progress, holds, repeated frames, and jumps. | val, doSet (bool) | state string |
| TimecodeMode | Internal attribute for the current received timecode FPS mode. | val, doSet (bool) | timecode mode (string) |
| timecodeToTimeline | Sends the current timecode, play/pause state, fresh-mode token, and FPS mode to Pixera.Compound.setTimecodeInput. |
- | - |
Properties
| Name | Content | Type Hint | Options Source | Options Action |
|---|---|---|---|---|
| Local Adapter | Any | string | Utils.Network.getLocalAdapterEntries | self.init |
| Timecode Jump Sensitivity (Frames) | 10 | number | self.init | |
| StreamID | 0 | number | self.init | |
| Auto Init | true | bool | ||
| Description | Receives Art-Net Timecode on UDP port 6454 and automatically forwards it to PIXERA through Pixera.Compound.setTimecodeInput. The module filters incoming packets by StreamID, detects play, pause, lost packets, and timecode jumps, and updates the PIXERA compound timecode input accordingly. Note: It is not possible to assign multiple timecodes to different timelines at the same time. For additional PIXERA-specific setup steps, please refer to the online help documentation. | string | ||
| Author | AVStumpfl GmbH | string | ||
| Logo | Embedded image in module JSON | image | ||
| Url | https://help.pixera.one/en_US/artnet-timecode | url | ||
| Version | 1.9 | string |
Changelog
Added StreamID filtering so the module can listen to a specific Art-Net timecode stream. The module can now be configured from its properties and no longer needs to be connected in the node system for normal operation. Stability was significantly improved, including better play/pause detection, lost-packet handling, and safer behavior when incoming timecode jumps.
Module Version 1.9 | 8 July 2026 | AVStumpfl GmbH
