Skip to content

Agent App Settings

Learn what settings are available in the Agent app for each operating system to customize its behavior according to your remote access needs.

The location of the app settings depends on the operating system version the application is running on:

The settings window opens when you click the Settings icon in the bottom-right corner of the main window:

The Settings tab in the main application window:

The Settings tab in the main application window:

The Settings tab in the main menu of the application:

Device Name

This is the name used in the Getscreen.me platform to identify the device where the application is running.

If permanent access is configured, this name will appear in the list of devices in the administrator’s dashboard. The synchronization also works both ways — if the administrator changes the device name in the dashboard, it will automatically update in the application as well.

Permanent Access

Learn more about permanent access in the guide Permanent Access Explained.

Application Settings

This section contains application settings specific to the operating system environment.

Auto Run

When enabled, this option tells the operating system to launch the application automatically when the system starts.

It is recommended to keep this option enabled if Permanent Access is configured — this ensures you don’t lose remote control over the device after a system reboot.

Permanent Access

Learn more about permanent access in the guide Permanent Access Explained

Operating System Specifics

In Linux and macOS versions of the application, this option may be called Run as daemon on system boot

Non-administrator Setup

Enabling this option allows a non-administrator user of the operating system to change the agent application settings.

Availability

Available only in the Windows version of the application

Server Settings

Used to override the default Getscreen.me server address. This option is intended for use with the Self-Hosted server version.

Self-Hosted Server

Learn more about the self-hosted server version in the Self-Hosted Guide.

Availability

Not available in the Windows version of the application

Proxy Settings

These settings are used when the device running the application connects to the Internet through a proxy server. You can specify authentication parameters for the application to connect to the Getscreen.me server via the proxy.

Interface Language

You can select the interface language manually if the automatic language detection based on the operating system language was incorrect at first launch. Both left-to-right and right-to-left languages are supported.

Adding a New Language

If you need a language that is not listed, please let us know via the Improvement Ideas Hub

Connection Settings

This section contains settings related to the connection sessions established with the device.

Video Channel Settings

When connecting to a device in remote desktop control mode, the image from the remote screen is transmitted as a video stream. High-quality video requires stable network conditions, which may not always be available. Therefore, you can adjust the video encoding settings to reduce the amount of transmitted data.

Video Quality Control

Learn more about video settings in the guide Screen Image Quality.

Availability

Available only in the Windows version of the application

Permissions

This section defines which actions are allowed for a remote operator when connecting to the device.

Mouse and Keyboard Control

This option allows the remote operator to control the mouse and keyboard when connected to the device in screen control mode.

Screen Control

Learn more about all screen control features in the guide Screen Control Features.

Screen Sharing

This option allows connections to the device via one-time access links.

If this option is disabled, the Screen Control tab in the application will be hidden.

Operating System Specifics

In Linux and macOS versions of the application, this option may be called Fast Access.

File Transfer

This option allows access to the device’s file system for uploading and downloading files.

File Transfer

Learn more about file transfers in screen control mode in the guide Remote File Sharing.

File Manager

Learn more about file transfers in file manager mode in the guide File Manager Mode.

Terminal Mode

This option allows the remote operator to connect to the device in terminal mode.

Terminal

Learn more about terminal mode connections in the guide Screen Control Features.

Audio Calls

This option allows making and receiving voice calls with the remote operator during a screen control session.

Calls

Learn more about audio calls in the guide Screen Control Features.

Availability

Available only in the Windows version of the application

Lock Input and Black Screen

This option allows the remote operator to disable the device screen and block input from the keyboard and mouse.

Detailed Guide

Learn more about black screen and input lock features in the guides Black Screen Mode and Screen Control Features.

Availability

Available for Windows agent version
Available for Linux agent version 1.8.356+

Unconfirmed Connections

This option allows the remote operator to connect to the device without requiring confirmation.

If this option is disabled, a confirmation window will appear on the device asking the user to approve the connection:

Connection Participants

Learn more about connection participants in the guide Connection Participants.

Prevent from Sleeping

This option prevents the operating system from entering sleep mode to ensure uninterrupted remote access to the device.

Availability

Available for macOS agent version

Group Settings

You can apply the above-mentioned settings not only to a single device but also to multiple devices at once, provided they have permanent access configured. These settings can be applied to all devices in your account or to specific device groups.

If a device has group settings applied from the permanent access administrator account, changing them directly in the application interface will be restricted:

Application Installation

Group settings apply only to installed applications.

Device Grouping

Learn more about managing device groups in the guide Device Grouping.

Console Commands

You can modify the application settings not only through the graphical interface but also using the -config console command.

getscreen.exe -config "name='My Computer' language=en autostart=true nonadmin=true control=true fast_access=false file_transfer=true audio_calls=false lock_input=true disable_confirmation=true auto_wallpaper_hide=true proxy='socks5://username:[email protected]:8080'"
msiexec /i getscreen.msi /qn REGISTER="[email protected]" CONFIG="name='My Computer' language=en autostart=true nonadmin=true control=true fast_access=false file_transfer=true audio_calls=false lock_input=true disable_confirmation=true auto_wallpaper_hide=true proxy='socks5://username:[email protected]:8080'"
getscreen -config "name='My Computer' control=true fast_access=false file_transfer=true disable_confirmation=true proxy='socks5://username:[email protected]:8080'"
/Applications/Getscreen.me.app/Contents/MacOS/Getscreen.me -config "name='My Computer' control=true fast_access=false file_transfer=true disable_confirmation=true proxy='socks5://username:[email protected]:8080'"
adb shell am start -n "getscreen.agent/.MainActivity" -e server getscreen.me -e register [email protected] -e config "name=ABC control=true fast_access=true file_transfer=true disable_confirmation=false"

Alternatively, you can manually specify the required settings in the configuration file:

/sdcard/Getscreen/config.properties:

Server=getscreen.me
[email protected]
DeviceName=ABC Device
Control=true
FastAccess=true
FileTransfer=true
Confirmation=false

Mass Deployment

Learn more about automated deployment and application setup in the guide Installing Agents via GPO (Mass Deployment).