> 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/ribbon-menu-bar/file/settings/general-macos.md).

# General (macOS)

Configure general Remote Desktop Manager macOS settings for clipboard behavior, startup, notifications, paths, and AI assistant configuration.

Use ***File – Settings – General*** in Remote Desktop Manager macOS to configure options related to the functionality of the application.

### Settings

#### General

<table><thead><tr><th width="254">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Allow multiple connections (default)</strong></td><td>Allows to open multiple concurrent connections (tabs) within the same session. If not enabled, selecting <em><strong>Open Session</strong></em> will set the focus on the existing connection.</td></tr><tr><td><strong>Hide application on copy</strong></td><td>Automatically hides Remote Desktop Manager on copying a password or a username to allow for immediate access to the app that requires the copied credentials.</td></tr></tbody></table>

#### Clipboard

<table><thead><tr><th width="254">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Clipboard copy method</strong></td><td>Sets a method for copying to/pasting from the clipboard. The <em><strong>Legacy</strong></em> option allows users to paste usernames or passwords multiple times without time limit; the <em><strong>Paste once (secure)</strong></em> option allows for a single paste before emptying the clipboard, and empties it automatically once the clear clipboard delay elapses. <em><strong>Paste once (secure)</strong></em> is the <em><strong>Default</strong></em>.</td></tr><tr><td><strong>Clear clipboard delay</strong></td><td>When enabled, determines the delay (in seconds, from 10 to 300) after which the clipboard is automatically cleared.</td></tr></tbody></table>

#### Application start

<table><thead><tr><th width="254">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Startup window state</strong></td><td>Determines the application's window size at startup.</td></tr><tr><td><strong>Release channel</strong></td><td>Selects which release channel to receive updates from: <strong>Current</strong>, <strong>Beta</strong>, or <strong>Extended maintenance</strong>.</td></tr><tr><td><strong>Frequency</strong></td><td>Sets how often the application checks for updates: <strong>Once a month</strong>, <strong>Once a week</strong>, <strong>Once a day</strong>, or <strong>Manual checks only</strong>.</td></tr></tbody></table>

#### Application close

<table><thead><tr><th width="339">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Ask confirmation on application close</strong></td><td>Sends a prompt for confirmation when attempting to close.</td></tr><tr><td><strong>Verify opened session on close</strong></td><td>Displays a warning about running sessions when attempting to close.</td></tr><tr><td><strong>Verify checked out sessions on close</strong></td><td>Displays a warning about checked out sessions on close.</td></tr></tbody></table>

#### Hotkeys

<table><thead><tr><th width="322">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Show/hide all windows with a system-wide hotkey</strong></td><td>Enables a system-wide hotkey to display or hide all windows.</td></tr><tr><td><strong>Show/hide find quickly window with a system-wide hotkey</strong></td><td>Opens or closes the Find Quickly window using a global hotkey.</td></tr></tbody></table>

#### Notification

<table><thead><tr><th width="237">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Disable license warnings</strong></td><td>When checked, this option suppresses notifications related to license warning.</td></tr><tr><td><strong>Restore license warnings</strong></td><td>Restore license warnings if they were previously disabled.</td></tr><tr><td><strong>Restore other warnings</strong></td><td>Restore other dashboard warnings.</td></tr></tbody></table>

#### Paths

<table><thead><tr><th width="199">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Application log path</strong></td><td>Specifies the location where application log files will be stored.</td></tr><tr><td><strong>Default templates</strong></td><td>Indicates the folder where default templates are stored.</td></tr><tr><td><strong>Recording</strong></td><td>Determines the path where session recordings will be saved.</td></tr></tbody></table>

#### Proxy (web)

<table><thead><tr><th width="125">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Proxy settings</strong></td><td>Opens the operating system's proxy configuration so Remote Desktop Manager can handle internet traffic through a proxy server.</td></tr></tbody></table>

#### Session recording

<table><thead><tr><th width="198">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Frame rate</strong></td><td>Specifies the number of frames per second (fps) for the recording.</td></tr><tr><td><strong>Video quality</strong></td><td>A numerical scale (1–10) where higher numbers represent better visual fidelity.</td></tr><tr><td><strong>Resolution</strong></td><td>Sets the resolution for the recorded video.</td></tr><tr><td><strong>SSH recording mode</strong></td><td>Determines the format used for recording SSH sessions.</td></tr></tbody></table>

#### Custom variables

<table><thead><tr><th width="173">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Custom variables</strong></td><td>Customizes your own variables in the application. Click on the plus sign to create a new variable to use.</td></tr></tbody></table>

#### AI

The AI settings are split across four tabs: **General**, **MCP servers**, **Skills**, and **Voice dictation**.

**General**

<table><thead><tr><th width="200">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Provider</strong></td><td><p>Sets the provider that will power AI features in the app. <strong>Copilot</strong> is the recommended default. Available providers include:</p><ul><li>Copilot</li><li>OpenAI</li><li>Azure OpenAI</li><li>Azure AI Inference</li><li>Ollama</li><li>Gemini</li><li>Claude (Anthropic)</li><li>Mistral AI</li><li>HuggingFace</li><li>ONNX</li><li>Devolutions</li><li>Custom</li></ul></td></tr><tr><td><strong>Endpoint</strong></td><td>The API endpoint to use, for providers that require one (for example, a custom or self-hosted provider).</td></tr><tr><td><strong>API key</strong></td><td>The API key used to authenticate with the selected provider.</td></tr><tr><td><strong>Model / Deployment</strong></td><td>Selects the model (or, for Azure OpenAI, the deployment) to use. Click the refresh icon to reload the list of available models.</td></tr><tr><td><strong>Reasoning effort</strong></td><td>For providers/models that support it, sets how much reasoning effort the model should use.</td></tr><tr><td><strong>Enable tools</strong></td><td>When available, allows the AI assistant to use configured MCP servers as tools.</td></tr><tr><td><strong>Chats panel position</strong></td><td>Sets where the AI chat panel is displayed in the application.</td></tr><tr><td><strong>Languages</strong></td><td>Selects the language(s) the AI should use for translated text.</td></tr></tbody></table>

**MCP servers**

Lists the configured MCP (Model Context Protocol) servers available to the AI assistant, showing each server's name, type, and connection details (URL or command). Use **Add**, **Edit**, and **Remove** to manage the list, and the checkbox to enable or disable individual servers.

**Skills**

Lists the folders scanned for AI skills. Use **Add folder** and **Remove** to manage the list, and **Preview discovered skills** to see which skills are found in the configured folders.

**Voice dictation**

<table><thead><tr><th width="200">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Enable voice dictation</strong></td><td>Enables voice dictation in the application.</td></tr><tr><td><strong>Input device</strong></td><td>Selects the microphone used for voice dictation.</td></tr><tr><td><strong>Model</strong></td><td>Selects the speech recognition model to use. Voice dictation models run locally and can be downloaded or deleted from this screen.</td></tr><tr><td><strong>Language</strong></td><td>For multilingual models, selects the language to recognize.</td></tr></tbody></table>

#### Hidden settings

{% hint style="info" %}
This tab is only available on Devolutions development builds and is not visible in regular releases.
{% endhint %}

<table><thead><tr><th width="192">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><em><strong>Hidden settings</strong></em></td><td>Lists the <em><strong>Hidden settings</strong></em> available in the app.</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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/rdm/ribbon-menu-bar/file/settings/general-macos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.