1. Docs
  2. Administration
  3. Project settings
  4. Desktop Configuration

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.

3 min read Updated CustomersAdmins

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 and, for the Appium setup, Windows or Mac. Recording is covered in Discover › Desktop.

General Settings#

FieldWhat it changesDefault
Platform“Target desktop platform”: Windows (WinAppDriver) or macOS (Mac2Driver). It is also the platform new applications get.Windows
Appium Server URLThe Appium 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 on failure are not set here: desktop runs use Test Management and each pipeline’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 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.

FieldWhat to enterRules
Name“Shown in test cases and pipelines”, for example ERP Client.Required, unique in the project (ignoring case).
PlatformWindows 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 NameThe page name the Desktop Recorder starts with for this app.Default Desktop.
WebView2 / PWA app — attach to the running windowOnly 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 runChecked in this order
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 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#

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai
© 2026 Selenity Technology · SmartestQAsmartestqa.aiThis page as MarkdownChecked against smarttest-fe predev 2a8c79cc (DesktopConfigurationPanel, DesktopAppDialog), smarttest-be 633c2a03, smarttest-testsuite (helpers/desktop_helper.py)