# Projects

Projects are the unit that have a title, description and references to a panel collection, a device collection and a configuration. This design provides the flexibility to use the same set of SKAARHOJ panels but quickly change to another location of devices with other IP addresses for example. Or keep the same devices and panels, but run a different configuration serving a different user group of operators.<span class="Apple-converted-space"> </span>

![Screenshot 2025-07-07 at 2.32.34 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2025-07/scaled-1680-/screenshot-2025-07-07-at-2-32-34-pm.png)

When a Blue Pill ships it has a default configuration is as below. It is set in simple view with only the basic information available.<span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![complex.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/complex.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/complex.png)</span>

Unlike UniSketch where a change of configuration and device cores needed an online connection to SKAARHOJ server, on Blue Pill everything is stored locally in Reactor. Only software upgrades or installations of non-existing device cores and applications need communication with the server.

<details id="bkmrk-creating-projects-to"><summary>Creating Projects</summary>

To create a new project click Manage Project within Reactor Home.<span class="Apple-converted-space"> </span>

[![Screenshot 2024-05-02 at 10.58.39.png](https://wiki.skaarhoj.com/uploads/images/gallery/2024-05/scaled-1680-/screenshot-2024-05-02-at-10-58-39.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2024-05/screenshot-2024-05-02-at-10-58-39.png)

Select Create new project on the projects pop up.<span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![new.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/new.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/new.png)</span>

There are two main parts of the project: Name and Description.<span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![details.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/details.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/details.png)</span>

<table border="1" class="align-center" style="border-collapse: collapse; width: 59.8718%; border: 1px solid rgb(0, 0, 0); height: 59.5938px;"><colgroup><col style="width: 20.8063%;"></col><col style="width: 79.1937%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="border-width: 1px; border-color: rgb(0, 0, 0); height: 29.7969px;">Name</td><td class="align-left" style="border-width: 1px; border-color: rgb(0, 0, 0); height: 29.7969px;">Customizable project name</td></tr><tr style="height: 29.7969px;"><td style="border-width: 1px; border-color: rgb(0, 0, 0); height: 29.7969px;">Description</td><td class="align-left" style="border-width: 1px; border-color: rgb(0, 0, 0); height: 29.7969px;">Option description of the project for reference</td></tr></tbody></table>

Advanced brings with it additional project options.

[![advanced project.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/advanced-project.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/advanced-project.png)

<table border="1" class="align-center" style="border-collapse: collapse; width: 100%; height: 318.563px; border: 1px solid rgb(0, 0, 0);"><colgroup><col style="width: 17.5842%;"></col><col style="width: 82.4158%;"></col></colgroup><tbody><tr style="height: 80.1875px;"><td class="align-left" style="height: 80.1875px; border-width: 1px; border-color: rgb(0, 0, 0);">**Mode**</td><td class="align-left" style="height: 80.1875px; border-width: 1px; border-color: rgb(0, 0, 0);">1. Normal for normal operation  
2. Devices only for when a Blue Pill will only be used to run device cores and not panels  
3. Demo runs a color slash across the connected controllers  
4. Mono panel for working with multiple panels as one in raw panel mode</td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">**File Name**</td><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">Master name for the file when making new collection, configuration, and exports</td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">**Panel Collection**</td><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">Allows for the sharing of panel collections across projects on a Blue Pill </td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">**Device Collection**</td><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">Allows for the sharing of devices collections across projects on a Blue Pill </td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">**Configuration**</td><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">Allows for the selection of a specific layer files in the configuration across projects on a Blue Pill </td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">**Activate**</td><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">Makes the project the current active project. The project needs to be active to use or work with it</td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">**Delete**</td><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">Deletes the project</td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">**Duplicate**</td><td class="align-left" style="height: 29.7969px; border-width: 1px; border-color: rgb(0, 0, 0);">Duplicates the projects</td></tr><tr style="height: 29.7969px;"><td class="align-left" style="border-width: 1px; border-color: rgb(0, 0, 0); height: 29.7969px;">**Export**</td><td class="align-left" style="border-width: 1px; border-color: rgb(0, 0, 0); height: 29.7969px;">Allows for the exporting of the projects</td></tr></tbody></table>

</details><details id="bkmrk-import%2Fexport-projec"><summary>Import/Export Projects</summary>

It is also possible to import and export projects to more easily share between different Blue Pill devices. This option is available next to create new projects in the Manage Projects pop up.<span class="Apple-converted-space"> You can also right-click a project name to open a context menu, where you can select 'Export project'.</span>

<span class="Apple-converted-space">[![Export.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/export.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/export.png)</span>

Import allows for a simple file upload. With the option to have the file name become the project name.

[![Import.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/import.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/import.png)

Export allows for the selection of what to include or exclude from the file. This can be the panels, devices, or configuration. This is specific project based and not for the entire Blue Pill.<span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![options.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/options.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/options.png)</span>

</details><details id="bkmrk-editing-projects-to-"><summary>Editing Projects</summary>

To change the details of the project click the project name within Reactor Home<span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![select.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/select.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/select.png)</span>

Or within any of the project detail boxes on the projects pop up. <span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![Projects.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/projects.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/projects.png)</span>

It is then possible to customize the name and description of the project. Press Save.<span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![details.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/cAvdetails.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/cAvdetails.png)</span>

Enabling Advanced view brings about extra options for editing the project outside of the basic details, the same as would be seen when creating a new project.<span class="Apple-converted-space"> </span>

</details><details id="bkmrk-layer-configuration-"><summary>Layer Configuration Version Look Up</summary>

In the layer configuration section, it is possible to access autosaved versions of the configurations. This is useful when a lot of changes have been made and it is necessary to roll things back a little.<span class="Apple-converted-space"> </span>

When in the Configuration section, click on the little clock symbol next to the layer to see previous versions.

[![configs.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/configs.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/configs.png)

Available versions are: every change from the last 24 hours and as 1 file per day for 10 days.<span class="Apple-converted-space"> </span>

It is also possible to add tags or comments to individual versions. When a tag or comment is added to the version, it will no longer be deleted based on the default time scale and will persist.<span class="Apple-converted-space"> </span>

<span class="Apple-converted-space">[![versions.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/scaled-1680-/versions.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-10/versions.png)</span>

</details>