> For the complete documentation index, see [llms.txt](https://docs.theiamarkerless.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theiamarkerless.com/theia3d-documentation/object-tracking/using-object-tracking.md).

# Using Object Tracking

## Prerequisites 

The following are requirements for Theia Bat Tracking:

* Valid Theia3D license
* Theia3D v2026.1.0 or later
* Theia Baseball Module license add-on

## Enable Object Tracking Feature

To use the Object Tracking feature, it must be enabled during startup of Theia3D or Theia3D Batch:

1. Open Theia3D or Theia3D Batch.\
   When the startup window appears, click ***Object Tracking***.
2. In the ***Object Tracking*** tab, select ***Enable Linked Object Tracking*** (beta) to track baseball bats and/or select ***Enable Free Object Tracking*** (beta) to track baseballs.
3. Click ***OK*** to launch Theia3D with Bat and/or Ball Tracking enabled. The object tracking engines will be built the first time that these features are enabled during launch.

{% hint style="warning" %}
**Note:** Bat and Ball Tracking is only available with the respective Object Tracking add-on and requires Theia3D v2026.1.0 or later. For software downloads, please visit our [self-service portal](https://portal.theiamarkerless.com/login).
{% endhint %}

<figure><img src="/files/Fp3rPzIIcNu4iiYhjZ7Y" alt=""><figcaption><p>Theia3D startup window showing the Object tracking option.</p></figcaption></figure>

## Processing Data

Once Theia3D or Theia3D Batch have been launched with the desired ***Track Linked Object*** or ***Track Free Object*** option enabled, processing markerless data to obtain athlete and object kinematics is no different than processing other movement data in Theia3D.

Once the videos have been [organized](/theia3d-documentation/theia3d-dropdown-menus/tools-menu/organize-videos.md) and the [calibration file assigned](/theia3d-documentation/theia3d-dropdown-menus/tools-menu/assign-calibration-files.md), the following typical steps can be followed:

### In Theia3D:

1. Load the formatted video data.
2. Load the calibration file corresponding to the video data.
3. Adjust the preferences as desired. (Preferences specific to Object Tracking can be found in the following section, [Object Tracking Preferences](/theia3d-documentation/object-tracking/object-tracking-preferences.md).)
4. Use the ***Run Analysis*** button to process the movement trial.

### In Theia3D Batch:

1. Select the batch directory.
2. Select the desired output format(s).
3. Adjust the preferences as desired, for all trials. (Preferences specific to Object Tracking can be found in the following section, [Object Tracking Preferences](/theia3d-documentation/object-tracking/object-tracking-preferences.md).)
4. Use the ***Run Batch*** button to begin the batch analysis.

## Display

The Object and Object Traces can also be shown or hidden in both the 2D and 3D views from the [Display menu](/theia3d-documentation/theia3d-dropdown-menus/display-menu.md).

<figure><img src="/files/Nu1JRwtT4eQOw5lYMKnp" alt=""><figcaption></figcaption></figure>

## Quick Tools Tab

The Object and Object Traces can also be shown or hidden in both the 2D and 3D views from the  [/pages/VX3B94cdC7jF3GrYtA4v#id-3.-quick-tools](https://docs.theiamarkerless.com/theia3d-documentation/object-tracking/pages/VX3B94cdC7jF3GrYtA4v#id-3.-quick-tools "mention")Tab

<figure><img src="/files/dPnv8XS0MYMx8uDKh8xO" alt=""><figcaption></figcaption></figure>

| <div><figure><img src="/files/7BXwW65Jt9kGfjb53Tl5" alt="" width="100"><figcaption></figcaption></figure></div><p></p> | Linked Objects Tracking Icon       |
| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| <div><figure><img src="/files/OdUbBRn73H3ZiwvtdtHs" alt="" width="100"><figcaption></figcaption></figure></div><p></p> | Linked Objects Trace Tracking Icon |
| <img src="/files/1hgb2eM1LOh0Of5TiicD" alt="" data-size="original">                                                    | Free Objects Tracking Icon         |
| <p></p><p><img src="/files/FTZn6BQhqSq5YCWPAogL" alt="" data-size="original"></p>                                      | Free Objects Trace Tracking Icon   |

{% embed url="<https://www.youtube.com/watch?v=ugtacwYWyQk>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.theiamarkerless.com/theia3d-documentation/object-tracking/using-object-tracking.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.