> For the complete documentation index, see [llms.txt](https://docs.holoplot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.holoplot.com/holoplot-control/configuring-the-system/managing-a-project.md).

# Managing a project

This page contains essential information for effectively managing your project in HOLOPLOT Control and recommended best practices to ensure your project settings are always up to date.

This page contains essential information for effectively managing your project in HOLOPLOT Control and recommended best practices to ensure your project settings are always up to date.

The Project Library section lets you easily manage the projects available on the controller. To access this section, click **Settings** (located in the top right of the navigation bar). Once inside, you will see a 2-panel layout:

* The left panel shows all projects available in the controller.
* The right panel displays the details of the selected project.

<figure><img src="https://1870956965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEWZvA6Ecdn48SRkbJ1C8%2Fuploads%2FHLSw31WUUGkScCL5wpwt%2F2-6Control_ConfiguringSystem_ManageProject.png?alt=media&amp;token=c006b483-05cc-4c79-a93c-f207e7821c35" alt=""><figcaption><p>Settings › Project Library</p></figcaption></figure>

***

### Adding a project

Click the **Add Project** button in the left panel, then browse for the desired project file and confirm the upload. Please note that only one file can be uploaded at a time.

After adding a project to the project library, you can proceed with activation or leave it stored in the controller for later use.

{% hint style="info" %}
Only **.holoplot** files are supported, and HOLOPLOT Plan can read them.
{% endhint %}

### Replacing a project

When a project with the same ID as an existing one is added to HOLOPLOT Control, the newly added project will replace the existing one. If this new file contains settings, they will overwrite the settings stored in the old file (module pairing, network settings, audio routing, etc).

<figure><img src="https://1870956965-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEWZvA6Ecdn48SRkbJ1C8%2Fuploads%2F3Z2kYOIeNWqaYRscapTj%2FControl_ConfiguringSystem_ManageProject_Replace.gif?alt=media&amp;token=0195365c-9b69-4bcd-8c1f-59502aeac439" alt=""><figcaption><p>Project replacement</p></figcaption></figure>

{% hint style="info" %}
**How do we detect already loaded projects?**\
When generating a project, HOLOPOT Plan assigns a unique identifier. If the user reuploads a project with the same unique identifier, HOLOPLOT Control will detect and prompt the user to override it.
{% endhint %}

#### Downloading a local copy of the project

You can download copies of any project stored in the controller. To do so, click on the three-dot menu at the top-right of each project container and click **Download Copy.**

{% hint style="success" %}
The **Download Copy of the Project** option is automatically selected to save a local file version on your computer, including module pairing, network settings, audio routings, and/or beam tuning values.
{% endhint %}

#### What information is generated and altered in which software?

| In HOLOPLOT Plan                        | In HOLOPLOT Control              |
| --------------------------------------- | -------------------------------- |
| Position and number of modules & arrays | Network settings                 |
| Number of presets and preset layers     | Module pairing                   |
| Beams and beam properties               | Audio Input's routing to streams |
| Environmental conditions                | Beam tuning values               |
| Audio inputs                            |                                  |

### Activating a project

To activate a project, you can do it in two ways:

1. On the left panel, click the three-dot menu at the top right of the project container, and then click **Activate**.
2. Select the project container, and then click the Activate button at the top right on the right panel.

The project's activation time depends on the file size.

{% hint style="warning" %}
It is recommended to mute the system before activating a project.
{% endhint %}

{% hint style="info" %}
Only one project can be active at a time.
{% endhint %}

### Deleting a project

Deleting a project is always possible as long as it is inactive. To do so, click on the three-dot menu at the top-right of each project container and click **Delete Project.**


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.holoplot.com/holoplot-control/configuring-the-system/managing-a-project.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.