Remote Connection

EyeAutomate can be connected to the EyeServer to simplify script development and execution on a remote machine.

To enable a remote connection:

  1. Select Remote Connection from the Remote menu.

  2. Enter the address and port of the EyeServer.

Use the following format for the address:

http://[server address]:[port]

For example, to connect to a local server:

http://localhost:1234

File Menu Options with Remote Connection Enabled

Once a remote connection is established, three additional options appear in the File menu:

  • Remote Dashboard

  • Remote Window

  • Synchronize

Remote Dashboard

The Remote Dashboard provides convenient access to reports and features of the EyeServer. Use it to:

  • Run scripts

  • Monitor progress

  • View test results

  • Adjust settings

To open the dashboard, use this URL:

http://[server address]:[port]

Example:

http://localhost:1234

Remote Window

The Remote Window allows you to view and control a remote machine running EyeServer.

To use the Remote Window:

  1. Enable Remote Connection from the Settings menu.

  2. Open the Remote Window from the Remote menu in EyeAutomate.

You can interact with the remote machine using your mouse and keyboard.

When you select any of the Run options in EyeAutomate, the script will be synchronized and executed on the remote machine.

  • Screenshots will be taken from the Remote Window instead of the local screen.

  • Screenshots are always captured correctly, regardless of the Remote Window’s size.

  • Scripts can be recorded using mouse and keyboard interactions within the Remote Window, and this feature works across all platforms.

Synchronization

Managing scripts and images across a team can be challenging. While a version control system is ideal, EyeAutomate also provides a file synchronization feature for teams without one.

To enable synchronization:

  1. Ensure Remote Connection is enabled from the Remote menu.

  2. Select Synchronize from the Remote menu.

  • All changes since the last sync will be uploaded and downloaded.

  • No files are deleted—only inserted or replaced.

  • Files overwritten on the EyeAutomate Web Service side are backed up with the .old extension.

Important:
Avoid running EyeAutomate from the same folder as the active EyeServer, as this may disrupt synchronization.

File Synchronization Filter

The filter.properties file (located on the client side) controls which local files are synchronized with the server. It contains regular expressions that define which files to include.

By default, all files in the EyeAutomate installation are targeted. To limit synchronization to a specific folder, update the RootFolder setting.

Each line in the filter.properties file specifies one path pattern to sync. Example default filter:

images/.*\.png
scripts/.*\.txt
data/.*\.csv