XModules Download

XModules for Windows Windows OS Windows Installer, Version 2019-8
How to install on Windows
XModules for macOS macOS ZIP file with Shell script inside, V2019-8
How to install on a Mac
XModules for Linux Linux OS ZIP file with Shell script inside, V2019-8
How to install on Linux

There is a separate XModules installer for Windows, Mac and Linux. The installer includes the latest FileAccess, RealUser Simulation and DesktopAutomation XModules. Their version numbers are:

  • FileAccess XModule: V1.0.12
  • RealUser XModule: V1.0.12
  • DesktopAutomation XModule: V1.0.19

The XModules work with UI.Vision for Firefox, UI.Vision for Chrome and the Copyfish Free OCR addon. So if you use one or more of our extensions, you need to install the XModules only once.

We tested on the following OS systems, but others should work as well. Please report any issues in the forum.

  • Windows: Win 10, Win 7, Server 2016, Server 2019
  • macOS: High Sierra, Mojave
  • Linux: Ubuntu 18.04, Ubuntu 19.04

The XModules installers do not include the UI.Vision browser extension itself. You can download the UI Vision core module here:
- UI.Vision for Chrome
- UI.Vision for Firefox

How to install on Windows

Just run the setup file, it takes care of everything. All installations are done in your user account, so no admin rights are required. To test that everything works correctly, switch UI.Vision RPA to file storage mode. The screencast below shows the installation process:

As an optional last step, you can customize the UI.Vision home folder location. By default, UI.Vision RPA uses " /Kantu" as the UI.Vision RPA home directory. If you want to change this, open the UI.Vision RPA browser extension, open "Settings", go to the "XModule" tab and enter a new UI.Vision RPA Home folder - macros, testsuites and CSV files will be stored in this folder.

In some companies the download of EXE installers/files is blocked. If this happens to you, please download the Windows XModule installer as ZIP file here. To install from the ZIP archive, unzip the archive and then run "1install.bat". This is almost the same procedure that is used in the macOS and Linux versions below.

How to install on macOS

First extract the content of the downloaded ZIP archive to a folder of your choice. Then open a command prompt and navigate to this folder.

macOS installation

(1.) Run the included shell script "1install.sh". You do this by opening the terminal, navigate to the folder to which you copied the files and type

sh 1install.sh


You should then see a few messages that say "Native messaging host... installed"

The installation is done now!

Do not move the XModules folder after the installation. The reason is that the installation script tells Chrome and/or Firefox where to find the the XModules. The files itself are not copied to a new location. So if you would move the folder, UI.Vision RPA would report the XModules as uninstalled, as it can not find them any longer. If you want to move the location of the folder later, it is best if you first run the uninstall scripts in the old location and then run the 1install.sh installation script again in the new location.

(2.) (Optional) As the last step you can customize the UI.Vision RPA home folder location. By default, UI.Vision RPA uses " /Kantu" as the UI.Vision RPA home directory. If you want to change this, open the UI.Vision RPA browser extension, open "Settings", go to the "XModule" tab and enter a new UI.Vision RPA Home folder - macros, testsuites and CSV files will be stored in this folder. To test that everything works correctly, switch UI.Vision RPA to file storage mode.

macOS Mojave: Since the Mojave update macOS has a new security feature. All apps that can control the mouse and keyboard - like the UI.Vision RPA RealUser XModule - need explicit permissions to do so. To add these permissions, go to Settings > Security & Privacy > Privacy > Accessibility option and add allow Chrome and/or Firefox to control your computer. Since UI.Vision RPA "lives" inside the browsers, the browsers are the apps that need to be added to the accessibility dialog. The FileAccess XModule does not need these permissions.

Allow <em>UI.Vision RPA</em> to control your Mac (RealUser module only)

The first time you use a realuser command (XClick, XMove,...) your Mac will ask you to add Chrome and/or Firefox to the accessibility menu. But it does this only once. If you missed the dialog the first time, future realuser commands will fail silently and you need to give Chrome/Firefox the required permissions manually (as shown in the screenshot above).

macOS Catalina: With the Catalina update (10.15) macOS got a new security feature called notarization. This forum post shows how to enable the XModules on Catalina . This is a one time task. Once all three XModules are allowed to run, everything works fine.

How to install on Linux

First extract the content of the downloaded ZIP archive to a folder of your choice. Then open a command prompt and navigate to this folder.

Important: Please make sure that the extracted files are executable. If they are not, you need to make them executable with chmod +x before running the 1install.sh script.

Linux installation

(1.) Run the included shell script "1install.sh". You do this by opening the terminal, navigate to the folder to which you copied the files and type

bash 1install.sh

You should then see messages that say "Native messaging host... installed"

The installation is done now.

Do not move the XModules folder after the installation. The reason is that the installation script tells Chrome and/or Firefox where to find the the XModules. The files itself are not copied to a new location. So if you would move the folder, UI.Vision RPA would report the XModules as uninstalled, as it can not find them any longer. If you want to move the location of the folder later, it is best if you first run the uninstall scripts in the old location and then run the 1install.sh installation script again in the new location.

(2.) (Optional) As the last step you can customize the UI.Vision RPA home folder location. By default, UI.Vision RPA uses " /Kantu" as the UI.Vision RPA home directory. If you want to change this, open the UI.Vision RPA browser extension, open "Settings", go to the "XModule" tab and enter a new UI.Vision RPA Home folder - macros, testsuites and CSV files will be stored in this folder. To test that everything works correctly, switch UI.Vision RPA to file storage mode.

Subscribe to the UI Vision RPA software newsletter . We'll send you updates on new releases that we're working on.