Agent Installation Guide¶
Installing the agent is required to ensure continuous access to the remote desktop. This allows the program to start automatically with the system, run in the background, and switch between users. The guide below provides detailed installation instructions for Windows, macOS, Linux, and Android.
Download Installer¶
Download the latest version of the agent installer either from the public download page or from the Add Device window in your account . Select the version that matches your operating system and processor architecture. Don’t forget to check that your device meets the system requirements .
Manual Installation¶
Interactive Guide
If you plan to use this guide to show your device operators how to install the program, check out the feature for sending a special interactive instruction. Learn more in the Interactive Guide to Installing the Agent.
Version for Windows¶
Select the account to which the device will be linked, review the service terms, and click Install. If you don’t have an account, please sign up .
Possible Issues
If the installation button is locked, restart the agent with administrator rights.
It will be installed here: C:\Program Files\Getscreen.me
Version for macOS¶
Giving Access Permissions¶
The first time you run the agent program, you may run into the issue of insufficient rights.
Therefore, in order to work correctly in macOS, the program must be granted screen recording and computer control rights.
To do this, go to System Preferences and select Security and Privacy.
Go to the Privacy tab, select Screen Recording and check the box next to Getscreen.me
Then go to Accessibility and do the same thing.
Permanent Access¶
For permanent access, enable the Autorun option in the settings of the running agent program, or select Install daemon... in the pop-up menu and confirm your decision with the password.
In both cases, you should get an installation message.
The agent program will now start automatically with the OS.
Removing¶
If you had autorun enabled when uninstalling the program, you may encounter a message that the program cannot be uninstalled.
To avoid this issue, before uninstalling, either disable the Autorun option in the agent program settings, or select Uninstall daemon... from the pop-up menu.
After that, you may quit the program and delete it from your computer.
Version for Linux¶
There are three installation options for Linux platforms.
Ubuntu/Debian¶
Installation / Uninstallation:
Red Hat/Fedora/SUSE¶
Installation / Uninstallation:
Binary Package¶
Binary package must be enabled for use as a program:
Version for Android¶
The first time you start it, you will be notified that the app will access your smartphone screen, including any information reflected on it. Press Start Now to continue.
Grant additional rights to the app to gain full access to your phone.
Go to Installed Services:
Select Getscreen.me Agent:
Set the upper slider to On:
After access has been granted, return to the application.
Trusted Partner
Be sure to share access only with trusted persons, as the app gains full access to your smartphone and all the information stored on it, including messengers, media files and banking applications.
Possible Issues
If for some reason the application says that there are no rights, but the slider is in On mode, then re-enable it.
Mass Deployment¶
You can deploy the agent program to your network of devices in bulk using console commands.
You can use MSI package or binary files to deploy the agent program in Active Directory via RMM (Remote Network Monitoring and Management) systems. To authenticate to your account, use console commands.
Branded Distributions
For console commands, you can also use branded distributions downloaded from your personal account. Learn more about agent branding in the Branding for Remote Desktop guide.
For Windows Binary (.exe)¶
Installation and authorization:
getscreen.exe -install -register [email protected]
Preset settings:
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'"
Installation:
Authorization with an account:
getscreen.exe -register [email protected]
Uninstallation:
Launch service:
Stop service:
For Windows Installer (.msi)¶
Installing and authorizing your account:
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'"
For Linux¶
Installation:
Authorization with an account:
getscreen -register [email protected]
Preset settings:
getscreen -config "name='My Computer' control=true fast_access=false file_transfer=true disable_confirmation=true proxy='socks5://username:[email protected]:8080'"
Change of server:
Uninstallation:
Version:
For Android¶
You can control the agent program with Android Debug Bridge .
Authorization and configuration:
adb shell am start -n "getscreen.agent/.MainActivity" -e server Getscreen.me Agent -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 necessary settings in the configuration file:
/sdcard/Getscreen/config.properties:
Server=Getscreen.me Agent
[email protected]
DeviceName=ABC Device
Control=true
FastAccess=true
FileTransfer=true
Confirmation=false