XModules Download

XModules for Windows Windows OS Windows Installer, Version 2019-5
How to install on Windows
XModules for macOS macOS ZIP file with Shell script inside, V2019-5
How to install on a Mac
XModules for Linux Linux OS ZIP file with Shell script inside, V2019-5
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.6
  • RealUser XModule: V1.0.12
  • DesktopAutomation XModule: V1.0.19

The XModules work with Kantu for Firefox and Kantu for Chrome. So if you use both 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

The XModules installers do not include Kantu itself. You can download Kantu here: Kantu for Chrome - Kantu 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 Kantu to file storage mode. The screencast below shows the installation process:

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

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, Kantu 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 Kantu home folder location. By default, Kantu uses " /Kantu" as the Kantu home directory. If you want to change this, open the Kantu browser extension, open "Settings", go to the "XModule" tab and enter a new Kantu Home folder - macros, testsuites and CSV files will be stored in this folder. To test that everything works correctly, switch Kantu 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 Kantu 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 Kantu "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 Kantu 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).

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, Kantu 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 Kantu home folder location. By default, Kantu uses " /Kantu" as the Kantu home directory. If you want to change this, open the Kantu browser extension, open "Settings", go to the "XModule" tab and enter a new Kantu Home folder - macros, testsuites and CSV files will be stored in this folder. To test that everything works correctly, switch Kantu to file storage mode.

Subscribe to the a9t9 automation software newsletter . We'll send you updates on new releases that we're working on.