2024-05-14 15:51:09 +02:00
---
title: Advanced Settings
weight: 49
---
### Privilege Levels for Settings
There are three types of settings:
1. Override settings, in "Web Console -> Custom Clients".
1. Default settings, in "Web Console -> Custom Clients".
1. User settings, in the RustDesk client.
The hierarchy of privilege for these settings is as follows: `Override > User > Default` .
### Settings
2024-05-19 05:15:34 +02:00
#### Security
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### access-mode
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Set the access mode (permissions) for incoming connections.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | custom,full,view | custom | `access-mode=custom` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-keyboard
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable keyboard/mouse input for incoming connections.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable keyboard
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-keyboard=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-clipboard
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable copy and paste for the incomign connections.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable clipboard
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-clipboard=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-file-transfer
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable file copy and paster or filte transfer(session) for incoming connections.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable file transfer
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-file-transfer=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-audio
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable audio record and transfer to peer.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable audio
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-audio=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-tunnel
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable TCP tunneling.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable TCP tunneling
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-tunnel=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-remote-restart
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable restarting by the control side.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable remote restart
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-remote-restart=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-record-session
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable sessions to be recorded.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable recording session
1. **Mobile** Settings -> Share screen -> Enable recording session
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-record-session=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-block-input
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable the control side to block other users' input.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable blocking user input (Windows only)
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-block-input=Y` |
2024-05-18 15:27:18 +02:00
2024-05-19 05:15:34 +02:00
##### allow-remote-config-modification
2024-05-18 15:27:18 +02:00
2024-05-19 05:15:34 +02:00
Allow the control side to change the settings in conrolled RustDesk UI.
2024-05-18 15:27:18 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Permissions -> Enable remote configuration modification
2024-05-18 15:27:18 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `allow-remote-config-modification=Y` |
2024-05-18 15:27:18 +02:00
2024-05-19 05:15:34 +02:00
##### enable-lan-discovery
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Allows LAN peers to discover me.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
After LAN discovery, [WOL ](https://en.wikipedia.org/wiki/Wake-on-LAN ) can work if supported locally.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Security -> Deny LAN discovery
1. **Mobile** Settings -> Share screen -> Deny LAN discovery
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| Y | Y,N | Y | `enable-lan-discovery=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### direct-server
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable direct IP access.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Security -> Enable direct IP access
1. **Mobile** Settings -> Share screen -> Direct IP access
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `direct-server=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### direct-access-port
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Direct IP access port.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Security -> Direct IP access port (Show if "Enable direct IP access" is checked)
1. **Mobile** Settings -> Share screen -> Direct IP access
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | | 21118 | `direct-access-port=21118` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### whitelist
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Use IP Whitelisting.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Security -> Use IP Whitelisting
1. **Mobile** Settings -> Share screen -> Use IP Whitelisting
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | , or ip1,ip2,ip3 | , means no filter | `whitelist=,` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### allow-auto-disconnect & auto-disconnect-timeout
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Automatically close incoming sessions after a period of user inactivity.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
**Location**:
1. **Desktop** Settings -> Security -> Security -> Automatically close incoming sessions on user inactivity
1. **Mobile** Settings -> Share screen -> Automatically close incoming sessions on user inactivity
| Option | Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: | :------: |
| allow-auto-disconnect | N | Y,N | N | `allow-auto-disconnect=Y` |
| auto-disconnect-timeout | N | Timeout in minutes | 10 | `auto-disconnect-timeout=10` |
##### allow-only-conn-window-open
Only allow connection if RustDesk window is open.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Security -> Only allow connection if RustDesk window is open
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| Y | Y,N | N | `allow-only-conn-window-open=N` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### approve-mode
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Accept incoming connections via password or manually click.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Security -> Password -> Dropdown box
1. **Mobile** Share screen -> Dropdown menu on right-up corner
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | password,click,password-click | password-click | `approve-mode=password-click` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
#### General
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### theme
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Controls the UI theme of RustDesk client.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Theme
1. **Mobile** Settings -> Settings -> Theme
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | dark,light,system | system | `theme=system` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### lang
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Controls the language of RustDesk client.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Luanguage
1. **Mobile** Settings -> Settings -> Luanguage
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | default,ar,bg,... | default | `lang=default` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Currently available languages are:
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko, kz, lt, lv, nb, nl, pl, pt, ro, ru, sk, sl, sq, sr, sv, th, tr, ua, vn, zh-cn, zh-tw
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
You can check [LANGS ](https://github.com/rustdesk/rustdesk/blob/master/src/lang.rs#L45 ) in the code for the latest language list.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### allow-auto-record-incoming
Automatically record incoming sessions.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Recording -> Automatically record incoming sessions
1. **Mobile** Settings -> Recording -> Automatically record incoming sessions
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `allow-auto-record-incoming=N` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### video-save-directory
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
The directory to save recorded videos.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Recording -> Video save directory
1. **Mobile** Settings -> Recording
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Default values:
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
1. **MacOS** ~/Movies/**app_name**
1. **Linux** ~/Videos/**app_name**
1. **Windows** %USERPROFILE%\Videos\\**app_name**
1. **Android** /Storage/emulated/0/**app_name**/ScreenRecord
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
**Note**: Relace **app_name** means current app name.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-confirm-closing-tabs
Controls whether to show a confirm dialog before closing all remote tabs.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Other -> Confirm before closing multiple tabs
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-confirm-closing-tabs=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-abr
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable adaptive bitrate.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Other -> Adaptive bitrate
1. **Mobile** Settings -> Share screen -> Adaptive bitrate (beta)
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-abr=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### allow-remove-wallpaper
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Remove wallpaper during incoming sessions.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Other -> Remove wallpaper during incoming sessions
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `allow-remove-wallpaper=N` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-open-new-connections-in-tabs
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Controls whether to use a new tab or a new window to open a new connection.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Other -> Open connection in new tab
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-open-new-connections-in-tabs=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### allow-always-software-render
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Always use software rendering.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Other -> Always use software rendering
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `allow-always-software-render=N` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-check-update
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Check for software update on startup.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Other -> Check for software update on startup
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | Y | `enable-check-update=N` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### allow-linux-headless
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Allow incoming connection if there's no displays.
This option requires desktop environment, xorg server and gdm, see [PR 3902 ](https://github.com/rustdesk/rustdesk/pull/3902 ).
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> General -> Other -> Allow linux headless
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| Y | Y,N | N | `allow-linux-headless=N` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-hwcodec
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Enable hardware encoding to make the picture smoother.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
**Location**:
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
1. **Desktop**
1. **Mobile** Settings -> Hardware codec
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| N | Y,N | Y | `enable-hwcodec=Y` |
##### peer-card-ui-type
Controls the view of peer cards, includes "Big tiles", "Small tiles" and "List".
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Home -> Peer panel -> Right top grid icon
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | 0,1,2 | 0 | `peer-card-ui-type=0` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
**0** Big tiles
**1** Small tiles
**2** List
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### peer-sorting
Controls the ordering of peer cards.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Home -> Peer panel -> Right top sort icon
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Remote ID,Remote Host,Username | Remote ID | `peer-sorting=Remote ID` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### sync-ab-with-recent-sessions
2024-05-14 15:51:09 +02:00
Controls whether to sync the address book with recent sessions.
**Location**:
1. **Desktop** Home -> Peer panel -> Address book -> Tags -> Dropdown menu -> Sync with recent sessions
1. **Mobile** Home -> Peer panel -> Address book -> Tags -> Dropdown menu -> Sync with recent sessions
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| N | Y,N | N | `sync-ab-with-recent-sessions=N` |
2024-05-19 05:15:34 +02:00
##### sync-ab-tags
2024-05-14 15:51:09 +02:00
Controls whether to sort the address book tags.
**Location**:
1. **Desktop** Home -> Peer panel -> Address book -> Tags -> Dropdown menu -> Sort tags
1. **Mobile** Home -> Peer panel -> Address book -> Tags -> Dropdown menu -> Sort tags
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| N | Y,N | N | `sync-ab-tags=N` |
2024-05-19 05:15:34 +02:00
##### filter-ab-by-intersection
2024-05-14 15:51:09 +02:00
Filter address book by tag intersection.
**Preview**: [PR #5985 ](https://github.com/rustdesk/rustdesk/pull/5985 )
**Location**:
1. **Desktop** Home -> Peer panel -> Address book -> Tags -> Dropdown menu -> Filter by intersection
1. **Mobile** Home -> Peer panel -> Address book -> Tags -> Dropdown menu -> Filter by intersection
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| N | Y,N | N | `filter-ab-by-intersection=N` |
2024-05-19 05:15:34 +02:00
#### Display
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### view-only
This option will set the "view-only" option for every peer after the first connection.
Then the "view-only" option in each peer's settings will controls whether the connection is view-only.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> View mode
1. **Mobile** Settings -> Display settings -> Other default options -> View mode
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `view-only=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### show-monitors-toolbar
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Controls whether to show monitors in toolbar.
![show-monitors-toolbar ](/docs/en/self-host/client-configuration/advanced-settings/images/show-monitors-toolbar.png )
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Show monitors toolbar
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `show-monitors-toolbar=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### collapse-toolbar
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
Controls whether the remote toolbar is collapsed after connecting.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Collapse toolbar
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `collapse-toolbar=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### show-remote-cursor
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "show-remote-cursor" option for every peer after the first connection.
Then the "show-remote-cursor" option in each peer's settings will controls whether the remote cursor is displayed in the remote control page.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Show remote cursor
1. **Mobile** Settings -> Display settings -> Other default options -> Show remote cursor
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `show-remote-cursor=N` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### follow-remote-cursor
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "follow-remote-cursor" option for every peer after the first connection.
Then the "follow-remote-cursor" option in each peer's settings will controls whether to follow the remote cursor.
**Preview** [PR 7717 ](https://github.com/rustdesk/rustdesk/pull/7717 )
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Follow remote cursor
1. **Mobile** Settings -> Display settings -> Other default options -> Follow remote cursor
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `follow-remote-cursor=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### follow-remote-window
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "follow-remote-window" option for every peer after the first connection.
Then the "follow-remote-window" option in each peer's settings will controls whether to follow the remote window.
**Preview** [PR 7717 ](https://github.com/rustdesk/rustdesk/pull/7717 )
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Follow remote window focus
1. **Mobile** Settings -> Display settings -> Other default options -> Follow remote window focus
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `follow-remote-window=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### zoom-cursor
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "zoom-cursor" option for every peer after the first connection.
The "zoom-cursor" option in each peer's settings will then control whether the cursor is scaled based on the current image scale.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Zoom cursor
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `zoom-cursor=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### show-quality-monitor
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "show-quality-monitor" option for every peer after the first connection.
The "show-quality-monitor" option in each peer's settings will then control whether to show the quality monitor.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Show quality monitor
1. **Mobile** Settings -> Display settings -> Other default options -> Show quality monitor
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `show-quality-monitor=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### disable-audio
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "disable-audio" option for every peer after the first connection.
The "disable-audio" option in each peer's settings will then control whether to play sound.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Mute
1. **Mobile** Settings -> Display settings -> Other default options -> Mute
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `disable-audio=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### enable-file-copy-paste
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "enable-file-copy-paste" option for every peer after the first connection.
The "enable-file-copy-paste" option in each peer's settings will then control enable file copy and paste in connection.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Enable file copy and paste (Windows only)
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `enable-file-copy-paste=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### disable-clipboard
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "disable-clipboard" option for every peer after the first connection.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
The "disable-clipboard" option in each peer's settings will then control whether to enable text copy and paste.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Disable clipboard
1. **Mobile** Settings -> Display settings -> Other default options -> Disable clipboard
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `disable-clipboard=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### lock-after-session-end
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "lock-after-session-end" option for every peer after the first connection.
The "lock-after-session-end" option in each peer's settings will then control whether to lock the peer machine after the session ends.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Lock after session end
1. **Mobile** Settings -> Display settings -> Other default options -> Lock after session end
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `lock-after-session-end=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### privacy-mode
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "privacy-mode" option for every peer after the first connection.
The "privacy-mode" option in each peer's settings will then control whether to use privacy mode after connecting.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Privacy mode
1. **Mobile** Settings -> Display settings -> Other default options -> Privacy mode
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `privacy-mode=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### touch-mode
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "touch-mode" option for every peer after the first connection.
The "touch-mode" option in each peer's settings will then control whether to use touch mode or mouse mode.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop**
1. **Mobile** Settings -> Display settings -> Other default options -> Touch mode
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `touch-mode=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### i444
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "i444" option for every peer after the first connection.
The "i444" option in each peer's settings will then control whether to use true color.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> True color (4:4:4)
1. **Mobile** Settings -> Display settings -> Other default options -> True color (4:4:4)
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| N | Y,N | N | `i444=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### reverse-mouse-wheel
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "reverse-mouse-wheel" option for every peer after the first connection.
The "reverse-mouse-wheel" option in each peer's settings will then control whether to reverse mouse wheel.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Reverse mouse wheel
1. **Mobile** Settings -> Display settings -> Other default options -> Reverse mouse wheel
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `reverse-mouse-wheel=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### swap-left-right-mouse
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "swap-left-right-mouse" option for every peer after the first connection.
The "swap-left-right-mouse" option in each peer's settings will then control whether to swap left-right mouse button.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Swap left-right mouse button
1. **Mobile** Settings -> Display settings -> Other default options -> Swap left-right mouse button
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `swap-left-right-mouse=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### displays-as-individual-windows
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "displays-as-individual-windows" option for every peer after the first connection.
The "displays-as-individual-windows" option in each peer's settings will then control whether to show displays as individual windows.
**Preview** [PR 5945 ](https://github.com/rustdesk/rustdesk/pull/5945 )
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Show displays as individual windows
1. **Mobile**
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| N | Y,N | N | `displays-as-individual-windows=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### use-all-my-displays-for-the-remote_session
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "use-all-my-displays-for-the-remote_session" option for every peer after the first connection.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
The "use-all-my-displays-for-the-remote_session" option in each peer's settings will then control whether to use all my displays for the remote session.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
**Preview** [PR 6064 ](https://github.com/rustdesk/rustdesk/pull/6064 )
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Other default options -> Use all my displays for the remote session
1. **Mobile**
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | Y,N | N | `use-all-my-displays-for-the-remote_session=Y` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### view-style
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "view-style" option for every peer after the first connection.
The "view-style" option in each peer's settings will then control the view style.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Default view style
1. **Mobile** Settings -> Display settings -> Default view style
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | original,adaptive | original | `view-style=original` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### scroll-style
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "scroll-style" option for every peer after the first connection.
The "scroll-style" option in each peer's settings will then control the scroll style.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Default scroll style
2024-05-14 15:51:09 +02:00
1. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | scrollauto,scrollbar | scrollauto | `scroll-style=scrollauto` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### image-quality
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "image-quality" option for every peer after the first connection.
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
The "image-quality" option in each peer's settings will then control the image quality.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Default image quality
1. **Mobile** Settings -> Display settings -> Default image quality
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | best,balanced,low,custom | balanced | `image-quality=balanced` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### custom-image-quality
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "custom-image-quality" option for every peer after the first connection.
The "custom-image-quality" option in each peer's settings will then control the image quality if "image-quality" is set to custom.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Default image quality -> Custom
1. **Mobile** Settings -> Display settings -> Default image quality -> Custom
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | [10.0, 2000.0] | 50.0 | `custom-image-quality=50` |
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
##### custom-fps
2024-05-14 15:51:09 +02:00
2024-05-19 05:15:34 +02:00
This option will set the "custom-fps" option for every peer after the first connection.
The "custom-fps" option in each peer's settings will then control the fps if "image-quality" is set to custom.
2024-05-14 15:51:09 +02:00
**Location**:
2024-05-19 05:15:34 +02:00
1. **Desktop** Settings -> Display -> Default image quality -> Custom
1. **Mobile** Settings -> Display settings -> Default image quality -> Custom
2024-05-14 15:51:09 +02:00
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
2024-05-19 05:15:34 +02:00
| N | [5,120] | 30 | `custom-fps=30` |
##### codec-preference
This option will set the "codec-preference" option for every peer after the first connection.
The "codec-preference" option in each peer's settings will then control codec for images.
**Location**:
1. **Desktop** Settings -> Display -> Default codec
1. **Mobile** Settings -> Display settings -> Default codec
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| N | auto,vp8,vp9,av1,h264,h265 | auto | `codec-preference=auto` |
**CAUTION**: Options other than "vp8" and "vp9" may not work. This depends on what your machine supports.