# Timecode & ArtNet Sync

Exaplay 3 can synchronise to external timecode sources for frame-accurate integration with lighting consoles, audio systems, and show-control systems.

## Supported Sync Sources

| Source     | Protocol          | Typical Use                                         |
| ---------- | ----------------- | --------------------------------------------------- |
| **ArtNet** | UDP/IP (ArtNet 4) | Lighting consoles, timecode distribution            |
| **LTC**    | Audio signal      | Traditional linear timecode on tape or audio output |
| **OSC**    | UDP/IP            | Software timecode, custom show control              |

## Setting Up ArtNet Sync

1. Open **Config → Network → ArtNet**.
2. Enable **Receive ArtNet Timecode**.
3. Enter the ArtNet Universe if your console transmits on a non-default universe.
4. Ensure the Exaplay machine is on the same subnet as the ArtNet source.

When valid ArtNet timecode is received, the Transport bar shows a green **TC: Locked** indicator and the playhead locks to the incoming timecode.

## Setting Up LTC Sync

1. Connect the LTC source to an audio input on your audio interface.
2. Open **Config → Audio Settings → Timecode Input**.
3. Select the audio input channel carrying the LTC signal.
4. Set the **Frame Rate** (24, 25, 29.97 DF, 30).

## Setting Up OSC Sync

1. Open **Config → Network → OSC**.
2. Enable **Receive OSC Timecode**.
3. Configure the **Listen Port** (default: `8000`).
4. The expected OSC address is `/timecode/hh/mm/ss/ff`.

## Sending Timecode (OSC Output)

Exaplay 3 can also transmit its current playback position as OSC to drive other software:

1. Open **Config → Network → OSC Output**.
2. Enter the destination IP and port.
3. Choose the OSC address pattern.

## Timecode Modes

| Mode         | Behaviour                                         |
| ------------ | ------------------------------------------------- |
| **Master**   | Exaplay drives its own clock; ignores external TC |
| **Slave**    | Locks to incoming TC; pauses if TC stops          |
| **Jam Sync** | Locks on start; runs free if TC signal is lost    |

## Frame Rate

Set the project frame rate in **Config → Video Settings → Frame Rate**. This must match the timecode frame rate of your sync source.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.exaplay.one/v3/features/timecode-artnet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.