---
title: "Desktop Configuration"
section: "Project settings"
description: "SmartestQA Desktop Configuration: Windows or macOS platform, Appium Server URL, and the applications list with AUMID, app path, arguments, attach mode and the default app."
url: https://docs.smartestqa.ai/en/project-settings-desktop.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "desktop configuration windows macos mac desktop app winappdriver mac2driver appium server url applications aumid bundle id app path exe app arguments attach webview2 pwa window title default application"
---
# Project settings: Desktop Configuration

Desktop Configuration lists the desktop applications a DESKTOP project tests and tells the runner how to start or attach to each one. The Desktop Recorder and every run read it.

## In short

**On this page you can**

- Choose the platform: Windows (WinAppDriver) or macOS (Mac2Driver) .
- Set the Appium server the agent uses next to the app.
- Add every application you test, with its AUMID, bundle ID or path and arguments.
- Attach to an already running window for WebView2 and PWA apps.
- Mark one application as the default for test cases that name none.

**How to use it**

1. Open Configuration › Project Panel › Desktop Configuration .
2. Under General Settings choose the Platform and check the Appium Server URL , then click Save Configuration .
3. Under Applications click Add application , fill the dialog and click Save .
4. Click the star of the app most tests use to make it the default.
5. Open the Desktop Recorder: it starts with these values filled in.

The section appears for DESKTOP projects. “These settings are pre-filled in the Smartest Desktop Recorder and used by the runner.” Desktop projects test Windows and macOS apps. The agent must run on the machine with the app, a Windows PC or a Mac; see [Install an agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent) and, for the Appium setup, [Windows](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#windows-desktop) or [Mac](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#macos-desktop). Recording is covered in [Discover › Desktop](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#desktop).

## General Settings

| Field | What it changes | Default |
| --- | --- | --- |
| **Platform** | “Target desktop platform”: Windows (WinAppDriver) or macOS (Mac2Driver). It is also the platform new applications get. | Windows |
| **Appium Server URL** | The [Appium](https://docs.smartestqa.ai/en/agent-pool-local-setup.html) server on the app’s machine. Must look like `http://host:port`; empty means the default. | `http://localhost:4723` |

Click **Save Configuration**. Success: “Desktop configuration saved”. If the project has no application yet, you also see “No application yet: add one under Applications so tests can open the app”.

Retry count, wait timeout, continue on failure and [screenshot](https://docs.smartestqa.ai/en/report-steps.html#screenshots) on failure are not set here: desktop runs use [Test Management](https://docs.smartestqa.ai/en/project-settings-test-management.html#test-settings) and each [pipeline](https://docs.smartestqa.ai/en/schedule-create.html)’s own settings, like web and mobile.

## Applications

“Define every application you test. Each test case picks one (empty = default); a pipeline can override it.” Every change in this list saves immediately; it does not need **Save Configuration**.

1. **Add an application**

   Click [**Add application**](https://docs.smartestqa.ai/en/agent-pool-app-library.html#upload) and fill the dialog (fields below).
2. **Save it**

   Click **Save**. Errors appear on the fields, with “Fix the highlighted fields.”

   “Application added”. The first application of a project becomes the default.
3. **Choose the default**

   Click the star of another app (“Make default”). The default shows a star and a **Default** chip.

| Field | What to enter | Rules |
| --- | --- | --- |
| **Name** | “Shown in test cases and pipelines”, for example `ERP Client`. | Required, unique in the project (ignoring case). |
| Platform | Windows or macOS. | Defaults to the page’s Platform. |
| AUMID / App ID (Windows) or Bundle ID (macOS) | For Store / UWP apps on Windows, or the macOS bundle ID, for example `com.example.MyApp`. | Fill at least one: “Fill in AUMID / Bundle ID or App Path”. |
| App Path (.exe) or App Path (.app) | For classic Win32, WPF and WinForms apps, or the macOS app path, for example `/Applications/MyApp.app`. On macOS the runner reads the bundle ID from the app when you give only the path. |  |
| **App Arguments (optional)** | Command-line arguments, for example `--config prod`. | — |
| **Default Page Name** | The page name the Desktop Recorder starts with for this app. | Default `Desktop`. |
| **WebView2 / PWA app — attach to the running window** | Only for Windows apps; the dialog hides it for macOS. The runner attaches to a window instead of starting the app. | Off |
| **Window Title (attach)** | “Text contained in the window title. Empty = the newly opened window.” | Shown when attach is on. |

Each row shows the app’s platform, its target (AUMID or path, or `⧉ window title` when attached), and how many test cases use it.

### Delete an application

The dialog “Delete application?” tells you how many test cases use it: “{count} test case(s) use this application; they will switch to the default application.” If you delete the default, the oldest remaining application becomes the default.

### Which application a test opens

**Application of a desktop run** — Checked in this order

```text
1. the application chosen in the pipeline   (if the pipeline overrides it)
2. the application chosen in the test case
3. the project’s default application
```

**Example:** the project has `ERP Client` (default) and `Label Printer`. Test case “Print label” picks Label Printer; all other cases pick nothing. A [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) without an override opens Label Printer for “Print label” and ERP Client for the rest. A pipeline that overrides with ERP Client opens ERP Client for every case.

### Projects without applications

Older desktop projects kept one application in single fields. While the list is empty, runs still use those values, and the list offers **Save current as application** to turn them into a list entry. Do it once, then manage everything in the list.

## If something goes wrong

- [“Appium Server URL is not valid”](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-desktop-url)
- [“An application with this name already exists”](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-desktop-app-name)
- [“No application yet: add one under Applications…”](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-desktop-no-app)
- [Desktop configuration could not be saved or loaded](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-desktop-save)
