> 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/theia3d-dropdown-menus/tools-menu/convert-workspaces.md).

# Convert Workspaces

The Convert Workspaces tool can be used to extract the raw data ([video files](/theia3d-documentation/data-formats/video-data.md) and camera system [calibration file](/theia3d-documentation/data-formats/calibration-files.md)) from existing [Theia workspaces](/theia3d-documentation/data-formats/theia3d-workspaces.md). This can be used whenever the raw data used to produce the workspaces is no longer available, or if the workspaces were produced using Theia3D v2023 or earlier which are no longer compatible with current versions of Theia3D.

When using this tool, two file selection dialog windows will appear, in the following order:

1. **Workspace Directory:** Use this dialog window to select a folder containing one or more Theia workspaces to be converted to raw data.
2. **Output Raw Directory:** Use this dialog window to select an empty folder where the extracted raw data should be output.

Once the above two dialog windows have been used, Theia3D will automatically convert each workspace and output the raw data in the selected folder.

<figure><img src="/files/LRmOjXt7vUy16vz71EEB" alt=""><figcaption><p>The result dialog window listing Theia workspaces which were successfully converted to raw data format.</p></figcaption></figure>


---

# 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/theia3d-dropdown-menus/tools-menu/convert-workspaces.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.
