> For the complete documentation index, see [llms.txt](https://help.qonic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qonic.com/getting-started/setting-up-the-desktop-app.md).

# Setting up the Desktop App

Use the Qonic desktop app for Windows and macOS to work with the dashboard and multiple models, drawings and components side by side in tabs.

The Qonic desktop app for Windows and macOS combines the [dashboard](https://help.qonic.com/documentation/qonic-dashboard/dashboard-overview.md) and the 3D application in one window, with each model, drawing or component in its own tab. To install the desktop app, see [Installation](#installation).

## Installation

The desktop app runs on 64-bit Windows and on Macs with Apple silicon running macOS 11 or later.

To install the Qonic Desktop Application, head to [qonic.com/downloads](https://www.qonic.com/downloads) and download the relevant installer for your system. Once installed, the application will update automatically with each new release, so you don't need to download the installer again. Qonic checks for updates each time it starts. If there is one, it downloads and installs it, then restarts by itself.

{% hint style="info" %}
**Windows:** the desktop application requires the Microsoft Edge WebView2 Runtime (see [Troubleshooting on Windows](https://help.qonic.com/getting-started/setting-up-the-desktop-app.md#troubleshooting-on-windows)).

**macOS:** move Qonic to your Applications folder. The application can only update itself automatically when it runs from there.
{% endhint %}

These are the instructions to install the Qonic Windows app through the command line:

* Usage: QonicClient-win-Setup.exe \[OPTIONS]
* Options:
  * -s, --silent Hides all dialogs and answers 'yes' to all prompts
  * -v, --verbose Print debug messages to console
  * -l, --log \<FILE> Enable file logging and set location

## Signing In and the Dashboard

When you start the desktop app, it opens on the dashboard. You sign in through your default web browser: if you aren't signed in, click *Log in* and Qonic opens your browser. Once you have signed in, the browser confirms it and you can close the browser tab and return to Qonic. If signing in doesn't complete, click *Try again*.

The dashboard is always the first tab of its window. It's shown with a house icon and has no close button. If you hide it with <kbd>Ctrl</kbd> <kbd>W</kbd> (<kbd>Cmd</kbd> <kbd>W</kbd> on macOS), click the *Home* button or press <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>D</kbd> (<kbd>Cmd</kbd> <kbd>Shift</kbd> <kbd>D</kbd>) to bring it back. All dashboard pages open in this tab. Links to other websites, such as this help center, open in your default web browser.

## Opening Models from Your Browser

If you use the dashboard in your web browser instead, you can still open models in the desktop app. To choose what happens when you open a model from the browser, go to *Profile settings* > *Model opening preferences* > *Always open models in* and choose *Always ask*, *Browser* or *Desktop app* (see [Profile Settings](https://help.qonic.com/documentation/qonic-dashboard/profile-settings.md#model-opening-preferences)).

When a model opens in the desktop app, the browser shows a page saying the model was opened in the Qonic desktop app. If your browser asks for permission, click *Open Qonic*, *Open Link* or *Open* in the browser's dialog. To work in the browser after all, click *Open in Browser instead*. If the desktop app isn't installed, the page says so: click *Download the Qonic app* to install it, *Retry* to try opening the model in the app again, or *Continue in Browser*.

## Working with Tabs

Open a model from the dashboard to open it in a new tab. If the model is already open, Qonic switches to its tab instead. Drawings, components, conflict solving and version comparison also open in a tab of their own. To open a model in a new window instead, hold <kbd>Ctrl</kbd> (Windows) or <kbd>Cmd</kbd> (macOS) while double-clicking it. You can also right-click the model and choose *Open in new window*, or select it and press <kbd>Ctrl</kbd> <kbd>Enter</kbd> (<kbd>Cmd</kbd> <kbd>Enter</kbd> on macOS).

Hover over a tab to see a preview of it, with the project, the active model (or component variant) and when the model was last saved.

To close a tab, click the × on the tab, middle-click the tab or use the keyboard shortcut below. When you close the last model tab in the dashboard's window, the dashboard is shown. Other windows close when their last tab is closed. If you close a window with several tabs open, Qonic asks you to confirm first. To reopen a tab you closed during this session, click the *Recently closed tabs* button in the tab bar and pick the tab from the list.

Drag a tab to change its position. Drop it on the tab bar of another Qonic window to move it there, or drop it outside the tab bars to open it in a new window. In a window without the dashboard, click the *Home* button to bring the dashboard to that window. When there are more tabs than fit in the tab bar, use the arrows at the ends of the tab bar or scroll with your mouse wheel.

The following keyboard shortcuts are available:

| Action                                        | Windows                                                                                                     | macOS                                                                                                             |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Next tab                                      | <kbd>Ctrl</kbd> <kbd>Tab</kbd> or <kbd>Ctrl</kbd> <kbd>Page Down</kbd>                                      | <kbd>Cmd</kbd> <kbd>Shift</kbd> <kbd>]</kbd>                                                                      |
| Previous tab                                  | <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>Tab</kbd> or <kbd>Ctrl</kbd> <kbd>Page Up</kbd>                       | <kbd>Cmd</kbd> <kbd>Shift</kbd> <kbd>\[</kbd>                                                                     |
| Move the tab left / right                     | <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>Page Up</kbd> / <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>Page Down</kbd> | <kbd>Control</kbd> <kbd>Shift</kbd> <kbd>Page Up</kbd> / <kbd>Control</kbd> <kbd>Shift</kbd> <kbd>Page Down</kbd> |
| Go to tab 1 to 8 (not counting the dashboard) | <kbd>Ctrl</kbd> <kbd>1</kbd> to <kbd>Ctrl</kbd> <kbd>8</kbd>                                                | <kbd>Cmd</kbd> <kbd>1</kbd> to <kbd>Cmd</kbd> <kbd>8</kbd>                                                        |
| Go to the last tab                            | <kbd>Ctrl</kbd> <kbd>9</kbd>                                                                                | <kbd>Cmd</kbd> <kbd>9</kbd>                                                                                       |
| Go to the dashboard                           | <kbd>Ctrl</kbd> <kbd>0</kbd> or <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>D</kbd>                               | <kbd>Cmd</kbd> <kbd>0</kbd> or <kbd>Cmd</kbd> <kbd>Shift</kbd> <kbd>D</kbd>                                       |
| Reopen the last closed tab                    | <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>T</kbd>                                                               | <kbd>Cmd</kbd> <kbd>Shift</kbd> <kbd>T</kbd>                                                                      |
| Close the tab                                 | <kbd>Ctrl</kbd> <kbd>W</kbd> or <kbd>Ctrl</kbd> <kbd>F4</kbd>                                               | <kbd>Cmd</kbd> <kbd>W</kbd>                                                                                       |
| Close the window                              | <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>W</kbd> or <kbd>Alt</kbd> <kbd>F4</kbd>                               | <kbd>Cmd</kbd> <kbd>Shift</kbd> <kbd>W</kbd>                                                                      |

On macOS, these actions are also available in the *View* and *Tabs* menus of the menu bar.

## Downloads

Files you download from the dashboard or a drawing tab, such as IFC model exports, DWG drawings or CSV reports, are saved by the desktop app. When a download starts, the *Downloads* panel opens in the tab bar. Click a finished file to open it, or click the folder icon to open your downloads folder. The *Downloads* button stays in the tab bar for the rest of the session, so you can see the downloads of this session again.

## Troubleshooting on Windows

* **Low memory:** if your computer is running low on memory when you open another model, Qonic shows *Memory is running low*. Click *Cancel* and close model tabs you are not using to free up memory, or click *Open anyway*.
* **A tab stops responding:** if a model tab stops responding, Qonic asks whether you want to *Keep waiting* or *Close the tab*. Closing the tab may cause unsaved changes in that tab to be lost.
* **WebView2:** the desktop app needs the Microsoft Edge WebView2 Runtime, which is included in Windows 10 and 11. If the dashboard stays blank in the desktop app, ask your IT department to install the WebView2 Runtime, then start Qonic again.
