# System Requirements

## Browser

| Requirement             | Details                                            |
| ----------------------- | -------------------------------------------------- |
| **Supported Browsers**  | Google Chrome (recommended), Edge, Mozilla Firefox |
| **Not Supported**       | Internet Explorer, Safari                          |
| **Minimum RAM**         | 12 GB                                              |
| **Required Technology** | WebGL enabled                                      |

{% hint style="success" %}
**Recommended:** Google Chrome offers the best performance due to its faster Chromium V8 engine. Our default test environment is Chrome.
{% endhint %}

**Useful Links:**

* [Download Google Chrome](https://www.google.com/chrome/)
* [Test WebGL Support](https://get.webgl.org/)

***

## OpenBrIM Launcher

Chrome throttles background tabs to save resources, which can significantly slow down analysis and result extraction when minimized.

The OpenBrIM Launcher configures Chrome for optimal performance:

| Feature             | Benefit                                                |
| ------------------- | ------------------------------------------------------ |
| Background analysis | Runs at full speed when minimized                      |
| Result extraction   | \~50% speed when minimized (vs. near-zero without)     |
| Isolated profile    | Keeps OpenBrIM sessions separate from regular browsing |

**Download:** Copy the script below and save it as `OpenBrIM-Launcher.bat`:

```batch
@echo off
setlocal enabledelayedexpansion
title OpenBrIM Launcher

set "CONFIG=%USERPROFILE%\.openbrim_config"

if exist "%CONFIG%" (
    set /p COMPANY=<"%CONFIG%"
    echo.
    echo Using saved company: !COMPANY!
    echo Opening https://!COMPANY!.openbrim.org
    echo.
    set /p "CHOICE=Press Enter to continue or type 'change' to update: "
    if /i "!CHOICE!"=="change" goto :ask
    goto :launch
)

:ask
echo.
echo Your OpenBrIM URL looks like: https://yourcompany.openbrim.org
set /p "INPUT=Enter your company name only (e.g., wsp, kiewit, atkins, jacobs): "

if "!INPUT!"=="" (
    echo No company name entered. Exiting.
    pause
    exit /b
)

:: Remove https:// if present
set "COMPANY=!INPUT:https://=!"
:: Remove http:// if present
set "COMPANY=!COMPANY:http://=!"
:: Remove .openbrim.org if present
set "COMPANY=!COMPANY:.openbrim.org=!"
:: Remove trailing slash if present
set "COMPANY=!COMPANY:/=!"

echo !COMPANY!>"%CONFIG%"
echo Company name saved: !COMPANY!

:launch
start "" "C:\Program Files\Google\Chrome\Application\chrome.exe" ^
    --disable-background-timer-throttling ^
    --disable-renderer-backgrounding ^
    --disable-background-tab-freezing ^
    --disable-backgrounding-occluded-windows ^
    --disable-hang-monitor ^
    --disable-ipc-flooding-protection ^
    --disable-gpu-vsync ^
    --disable-features=CalculateNativeWinOcclusion,TabFreeze,TabGroupsCollapseFreezing,BackForwardCache,BackgroundMediaSuspend,IntensiveWakeUpThrottling ^
    --user-data-dir="C:\ChromeProfiles\OpenBrIMSession" ^
    --profile-directory=Default ^
    --new-window "https://!COMPANY!.openbrim.org/"
```

{% hint style="info" %}
**Note:** The script assumes Chrome is installed at `C:\Program Files\Google\Chrome\Application\chrome.exe`. If Chrome is installed elsewhere, update the path in the script. To find your Chrome path, type `chrome://version` in Chrome's address bar and look for "Executable Path".
{% endhint %}

No installation or admin privileges required. On first run, enter your company name (e.g., `companyname` for `companyname.openbrim.org`). The launcher saves your preference for future use.

***

## Enhancing Platform Performance

Laptops and browsers often conserve battery by limiting hardware utilization. Adjust these settings for optimal performance.

### Use Discrete GPU

**Step 1:** Check which GPU Chrome is using. Open `chrome://gpu/` and find "GL Renderer".

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20241104-113810.png?api=v2" alt="Chrome GPU info showing Intel graphics"><figcaption><p>Default: Chrome using integrated Intel graphics</p></figcaption></figure>

**Step 2:** Open NVIDIA Control Panel (search "Nvidia" in Windows). Select Chrome or Edge and assign "High Performance Nvidia Processor".

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200149.png?api=v2" alt="NVIDIA Control Panel settings"><figcaption><p>NVIDIA Control Panel GPU assignment</p></figcaption></figure>

**Step 3 (Alternative):** Search "Graphics Settings" in Windows, select "Desktop App", browse to your browser's .exe file, click "Options", and set your preferred GPU.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200156.png?api=v2" alt="Windows Graphics Settings"><figcaption><p>Windows Graphics Settings</p></figcaption></figure>

**Step 4:** Verify by reopening `chrome://gpu/`. Intel should no longer appear under "GL Renderer".

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20241104-113014.png?api=v2" alt="Chrome GPU info showing NVIDIA"><figcaption><p>Success: Chrome now using discrete NVIDIA GPU</p></figcaption></figure>

***

### Disable Browser Efficiency Mode

{% tabs %}
{% tab title="Chrome" %}
Go to **Settings > Performance** and disable memory and energy saver features.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-195731.png?api=v2" alt="Chrome performance settings"><figcaption><p>Chrome Settings > Performance</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200412.png?api=v2" alt="Chrome energy saver disabled"><figcaption><p>Disable energy saver</p></figcaption></figure>
{% endtab %}

{% tab title="Edge" %}
Disable these features in Edge settings:

* Efficiency Mode
* Improve Your PC Gaming
* Sleeping Tabs

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-193608.png?api=v2" alt="Edge efficiency settings"><figcaption><p>Edge efficiency settings</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-195013.png?api=v2" alt="Edge sleeping tabs"><figcaption><p>Disable sleeping tabs</p></figcaption></figure>
{% endtab %}
{% endtabs %}

***

### Windows Power Settings

Click the battery icon on the taskbar and set the slider to maximum performance.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-200652.png?api=v2" alt="Windows power slider"><figcaption><p>Set power mode to Best Performance</p></figcaption></figure>

***

### OpenBrIM Performance Settings

**Control Compilation Scope**

Reduce compilation time by toggling FEM or Detailing on/off. See [Pause / FEM / Detailing Bar](https://github.com/openbrim/platform/blob/master/docs/library/getting-started/navigation-within-openbrimapp/projects/project-ui/pause-fem-detailing-bar.md).

**Simplify Rendered Elements**

Deactivate rendering of bolts or shear studs if they significantly impact compilation time.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201310.png?api=v2" alt="Bolt rendering settings"><figcaption><p>Toggle bolt/stud rendering in the spreadsheet</p></figcaption></figure>

**Performance Profiling**

Identify which objects impact compilation time by appending `&perf=1` to your project URL.

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201545.png?api=v2" alt="URL with perf parameter"><figcaption><p>Add &#x26;perf=1 to the URL</p></figcaption></figure>

After compilation, access the performance report from the settings menu:

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201654.png?api=v2" alt="Settings menu"><figcaption><p>Open settings menu</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201821.png?api=v2" alt="Performance report option"><figcaption><p>Select performance report</p></figcaption></figure>

<figure><img src="https://openbrim.atlassian.net/wiki/download/attachments/2326757379/image-20231219-201831.png?api=v2" alt="Performance report results"><figcaption><p>Review compilation times by operation</p></figcaption></figure>