> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/windows-terminal.md).

# Windows Terminal

Configure Windows Terminal entries in Remote Desktop Manager, including the program to run, arguments, working directory, profile, and parameters.

This article details the many settings and options available for ***Windows Terminal*** session entries in Remote Desktop Manager.

<table data-header-hidden><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Name</strong></td><td>The name of the entry.</td></tr><tr><td><strong>Folder</strong></td><td>The folder where the entry is located.</td></tr><tr><td><strong>Display</strong></td><td><p>How the entry opens:</p><ul><li><strong>External</strong></li><li><strong>Embedded (tabbed)</strong></li><li><strong>Undocked</strong></li></ul><p>When the entry opens externally or undocked, additional lists let you choose the monitor and the virtual desktop where the window opens.</p></td></tr></tbody></table>

### General

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Run</strong></td><td>The program to run in Windows Terminal. Type the command line or click the browse button to select a program file (<code>.bat</code>, <code>.cmd</code>, <code>.com</code>, <code>.exe</code>, or <code>.pif</code>).</td></tr><tr><td><strong>Window selector</strong></td><td>Fill in the <em><strong>Run</strong></em> field from a window that is open on the computer. Available on Windows only.</td></tr><tr><td><strong>Arguments</strong></td><td>The arguments passed to the program.</td></tr><tr><td><strong>Process name</strong></td><td>The name of the process started by the entry. Use the default process name to have the application listed in the opened sessions.</td></tr><tr><td><strong>Set default process name</strong></td><td>Fill in the <em><strong>Process name</strong></em> field with the file name of the program in the <em><strong>Run</strong></em> field, without its extension.</td></tr><tr><td><strong>Working directory</strong></td><td>The folder in which the program starts.</td></tr></tbody></table>

### Profile

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Profile</strong></td><td><p>The Windows Terminal profile used by the entry:</p><ul><li><strong>Custom</strong> — Defines the profile in the entry with the settings below. A profile name is required.</li><li>Each profile found in the Windows Terminal settings, with the default profile marked <strong>(Default)</strong>.</li></ul></td></tr><tr><td><strong>Import</strong></td><td>Load the settings of an existing Windows Terminal profile into the custom profile. Available when <em><strong>Custom</strong></em> is selected.</td></tr></tbody></table>

When ***Custom*** is selected, the profile settings below are available on Windows.

**General**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>The name of the profile.</td></tr><tr><td><strong>Command-line</strong></td><td>The executable the profile runs.</td></tr><tr><td><strong>Starting directory</strong></td><td>The folder in which the profile starts.</td></tr><tr><td><strong>Icon</strong></td><td>The image file used as the icon of the profile (<code>.bmp</code>, <code>.gif</code>, <code>.ico</code>, <code>.jpeg</code>, <code>.jpg</code>, <code>.png</code>, or <code>.tiff</code>).</td></tr><tr><td><strong>Tab title</strong></td><td>The title of the Windows Terminal tab.</td></tr><tr><td><strong>Run this profile as an administrator</strong></td><td>Run the profile with elevated privileges.</td></tr><tr><td><strong>Hide profile from the dropdown</strong></td><td>Hide the profile from the Windows Terminal profile list.</td></tr></tbody></table>

**Appearance**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td colspan="2"><strong>Text</strong></td></tr><tr><td><strong>Color scheme</strong></td><td>The color scheme of the profile, chosen from the color schemes found in the Windows Terminal settings.</td></tr><tr><td><strong>Font face</strong></td><td>The font of the terminal text.</td></tr><tr><td><strong>Font size</strong></td><td>The size of the terminal text, from 0 to 128.</td></tr><tr><td><strong>Font weight</strong></td><td><p>The weight of the terminal text:</p><ul><li><strong>Normal</strong></li><li><strong>Thin</strong></li><li><strong>Extra-Light</strong></li><li><strong>Light</strong></li><li><strong>Semi-Light</strong></li><li><strong>Medium</strong></li><li><strong>Semi-Bold</strong></li><li><strong>Bold</strong></li><li><strong>Extra-Bold</strong></li><li><strong>Black</strong></li><li><strong>Extra-Black</strong></li><li><strong>Custom</strong> — Enter a weight from 0 to 1000 in the field that appears below the list.</li></ul></td></tr><tr><td colspan="2"><strong>Cursor</strong></td></tr><tr><td><strong>Cursor shape</strong></td><td><p>The shape of the cursor:</p><ul><li><strong>Bar</strong></li><li><strong>Vintage</strong></li><li><strong>underscore</strong></li><li><strong>Double underscore</strong></li><li><strong>Filled box</strong></li><li><strong>Empty box</strong></li></ul></td></tr><tr><td colspan="2"><strong>Text formatting</strong></td></tr><tr><td><strong>Intense text style</strong></td><td><p>How intense text is displayed:</p><ul><li><strong>None</strong></li><li><strong>Bold font</strong></li><li><strong>Bright colors</strong></li><li><strong>Bold font with bright colors</strong></li></ul></td></tr><tr><td colspan="2"><strong>Background image</strong></td></tr><tr><td><strong>Use desktop wallpaper</strong></td><td>Use the desktop wallpaper as the background image. When enabled, the <em><strong>Path</strong></em> field is unavailable.</td></tr><tr><td><strong>Path</strong></td><td>The image file used as the background (<code>.bmp</code>, <code>.gif</code>, <code>.ico</code>, <code>.jpeg</code>, <code>.jpg</code>, <code>.png</code>, or <code>.tiff</code>).</td></tr><tr><td><strong>Stretch mode</strong></td><td><p>How the background image is resized:</p><ul><li><strong>Uniform to be filled</strong></li><li><strong>uniform</strong></li><li><strong>Fill</strong></li><li><strong>None</strong></li></ul></td></tr><tr><td><strong>Alignment</strong></td><td><p>Where the background image is placed:</p><ul><li><strong>Center</strong></li><li><strong>Left</strong></li><li><strong>Top</strong></li><li><strong>Right</strong></li><li><strong>Bottom</strong></li><li><strong>Top left</strong></li><li><strong>Top right</strong></li><li><strong>Bottom left</strong></li><li><strong>Bottom right</strong></li></ul></td></tr><tr><td><strong>Opacity</strong></td><td>The opacity of the background image, from 0 to 100.</td></tr><tr><td colspan="2"><strong>Transparency</strong></td></tr><tr><td><strong>Background opacity</strong></td><td>The opacity of the terminal background, from 0 to 100.</td></tr><tr><td><strong>Enable acrylic material</strong></td><td>Apply the acrylic material effect to the terminal background.</td></tr><tr><td colspan="2"><strong>Window</strong></td></tr><tr><td><strong>Scrollbar visibility</strong></td><td><p>Whether the scrollbar is displayed:</p><ul><li><strong>Visible</strong></li><li><strong>Hidden</strong></li></ul></td></tr><tr><td><strong>Padding</strong></td><td>The space around the terminal text, set separately for the <em><strong>Left</strong></em>, <em><strong>Top</strong></em>, <em><strong>Right</strong></em>, and <em><strong>Bottom</strong></em> sides, from 0 to 100 each.</td></tr></tbody></table>

**Advanced**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Text anti-aliasing</strong></td><td><p>How the terminal text is smoothed:</p><ul><li><strong>Grayscale</strong></li><li><strong>ClearType</strong></li><li><strong>Aliased</strong></li></ul></td></tr><tr><td><strong>Profile termination behavior</strong></td><td><p>When the terminal closes after its process ends:</p><ul><li><strong>Automatic</strong></li><li><strong>Close only when the process exits successfully</strong></li><li><strong>Close when the process exits, fails, or crashes</strong></li><li><strong>Never close automatically</strong></li></ul></td></tr><tr><td><strong>History size</strong></td><td>The number of lines kept in the scrollback history, from 0 to 999999999.</td></tr><tr><td><strong>Bell notification style</strong></td><td>How the terminal bell is signaled. Select any combination of <em><strong>Audible</strong></em>, <em><strong>Flash window</strong></em>, and <em><strong>Flash taskbar</strong></em>.</td></tr><tr><td><strong>Suppress title changes</strong></td><td>Keep the tab title from being changed by the running application.</td></tr><tr><td><strong>AltGr aliasing</strong></td><td>Turn on the Windows Terminal AltGr aliasing setting for the profile.</td></tr><tr><td><strong>Scroll to input while typing</strong></td><td>Scroll back to the input line when typing.</td></tr></tbody></table>

### Parameters

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td>The name of the parameter. The tab always lists at least five parameters. Click the name to open the <em><strong>Rename</strong></em> window and change it.</td></tr><tr><td><strong>#</strong></td><td>The token that identifies the parameter on the command line, such as <code>{1}</code> for the first parameter.</td></tr><tr><td><strong>Type</strong></td><td><p>The type of the parameter:</p><ul><li><strong>Unused</strong></li><li><strong>Text</strong></li><li><strong>Secured</strong></li><li><strong>Env. variable</strong></li></ul></td></tr><tr><td><strong>Default value</strong></td><td>The value of the parameter. A <em><strong>Secured</strong></em> parameter hides its value.</td></tr><tr><td><strong>Delete</strong> (row button)</td><td>Reset the parameter of its row: its <em><strong>Type</strong></em> returns to <em><strong>Unused</strong></em>, its value is cleared, and its name returns to the default name. Shown when <em><strong>Type</strong></em> is not <em><strong>Unused</strong></em>.</td></tr><tr><td><strong>Add</strong></td><td>Add a parameter row at the end of the list.</td></tr><tr><td><strong>Delete</strong></td><td>Remove the last parameter row added with <em><strong>Add</strong></em>. Available when the list has more than five parameters.</td></tr><tr><td><strong>Prompt for parameters on open</strong></td><td>Ask for the parameter values each time the entry opens.</td></tr><tr><td><strong>Example in Run field</strong></td><td>Click <em><strong>View command</strong></em> to display the command of the <em><strong>Run</strong></em> field with the parameter values inserted.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/windows-terminal.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
