# Grid Recorder

## Introduction

### What is Grid Recorder?

**Grid Recorder** is a standalone capture and replay tool developed by Stage Precision as part of the SP Grid ecosystem.

It is designed to record and reproduce camera tracking and metadata pipelines with high precision. By capturing raw UDP data streams together with synchronised video signals, Grid Recorder allows users to replay recorded sessions exactly as they originally occurred—down to timing, behaviour, and even data dropouts.

In short:\
**Record once. Replay anytime.**

***

### Why Grid Recorder?

Modern production environments—such as virtual production, broadcast, and immersive experiences—often rely on complex, real-time data pipelines. These setups can be difficult to test, calibrate, and debug under live conditions.

Grid Recorder addresses this by turning live sessions into reusable assets:

* **Capture once** during a live session
* **Replay anytime** without requiring the original hardware setup
* **Iterate faster** without blocking studio time

This enables more efficient workflows across development, testing, and operation.

***

### Key Capabilities

#### Accurate Data Capture

Grid Recorder records raw UDP packets byte-for-byte, without decoding or altering the data. This ensures full fidelity and compatibility with existing pipelines.

#### Synchronized Video & Metadata

By combining SDI video input/output with tracking data, recordings maintain accurate alignment between image and metadata—critical for real-world production workflows.

#### True-to-Life Replay

Playback behaves exactly like a live feed, preserving timing, latency, and even signal dropouts. This makes it possible to reliably reproduce issues and validate system behaviour.

#### Protocol-Agnostic Workflow

Because Grid Recorder operates at the transport level (UDP), it works across different tracking systems and vendor ecosystems without additional integration layers.

***

### Typical Use Cases

#### Offline Calibration

Run camera and lens calibration multiple times using recorded data—without requiring physical cameras or studio access.

#### Rehearsal & Previsualization

Test content, timing, and spatial placement in AR/VP environments using realistic playback instead of live operation.

#### Debugging & Troubleshooting

Recreate issues exactly as they occurred and analyse them in a controlled environment.

#### Pipeline Development

Develop and validate workflows using consistent, repeatable input data.

***

### How It Fits into SP Grid

Grid Recorder is part of the broader **SP Grid platform**, a real-time system for designing, controlling, and operating complex environments across studios, spaces, and live events.

Within this ecosystem, Grid Recorder acts as a **capture-and-replay layer**, enabling teams to:

* decouple development from live operation
* reduce dependency on physical setups
* accelerate iteration cycles

***

### Summary

Grid Recorder transforms ephemeral live data into reusable building blocks.\
By enabling precise capture and deterministic replay, it reduces complexity, saves time, and improves reliability across modern production workflows.


---

# 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://stage-precision.gitbook.io/grid/grid-recorder/grid-recorder.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.
