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:
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).




















