Skip to content

Branding UI in Resilio Active Everywhere

Resilio Active Everywhere allows you to add some branding customization to the Management Console and Agent UI.

Branding the Management Console

It's possible to update the logo in the Management Console top menu.

To change the Management Console's top menu logo:

  1. Stop the Management Console service.

  2. Edit the MC configuration file and add the following to the top level of json, pointing to the location of the image file.

     "branding": {     
          "icon": "path to icon image"   
            },

    Note

    Only absolute paths are supported.

  3. Start the Management Console.

Branding the Agent UI

To change logo, colors and footer, you need to prepare a webui.zip file in advance. The zip file should contain:

  • A subfolder named images to update the logo and animated statues.
  • A json file named theme.json to update colors and footer.

Depending on what you want to change, the images subfolder should contain:

  • The new logo.

    Info

    The image file must be:

    • An svg file named logo-connect_316x36.svg for Resilio Agents 4.0 and newer.
    • An svg file named logo-connect_250x41.svg for Resilio Agents before 4.0.

  • Animated gif files that will be used in the UI replacing the default ones:

    • connecting_blue.gif - size 18x18 px
    • connecting_light.gif - size 18x18 px
    • spinner.gif - size 16x16 px
    • loader.gif - size 22x22 px
    • loader_light.gif - size 22x22 px
    • loader_highlight.gif - size 22x22 px

    They represent the following animated statuses in UI

Thetheme.json can be updated as needed (be sure to stick to json format) replacing the color schema and footer text, as well as hiding some of the top menu tabs.
For colors naming convention consult this or similar color scheme if necessary https://htmlcolorcodes.com/color-names/

Limit to footer area text is 25 symbols. Longer line will not fit and will look distorted. Several links can be placed here.

Here's the schema:

Put the webui.zip file beside Resilio Connect Agent.exe in C:\Program Files\Resilio Connect Agent (default location).

Restart Resilio Connect Agent UI. Note, it’s necessary to restart not the service, but UI, exit from tray and start it again.

Agent UI shortcut

To change the Agent's UI shortcut icon:

  1. Prepare a file named icon.ico and put in the same folder where the Resilio Connect Agent.exe file is located (default: C:\Program Files\Resilio Connect Agent). This will be the new shortcut’s icon.
  2. Upload the UpdateShortcut.ps1 script to the Agent.
  3. Run script in Powershell:
    .\UpdateShortcut.ps1 -Path "C:\Users\Public\Desktop\Resilio Connect Agent.lnk" -NewName "EA Agent" -Icon "C:\Program Files\Resilio Connect Agent\icon.ico"

Automate this task using Resilio

You can use a Distribution Job with a post download trigger to automate Agent UI icon update. Make sure that write access to C:\Program Files\Resilio Connect Agent has been granted.

  1. Create a Distribution Job. Select the source of the files: UpdateShortcut.ps1, icon.ico.
  2. Select destination Agents and path C:\UpdateShortcut as destination, for example.

  3. Add the following post download trigger, select Powershell as shell:

    Copy-Item icon.ico -Destination "C:\Program Files\Resilio Connect Agent"

    .\UpdateShortcut.ps1 -Path "C:\Users\Public\Desktop\Resilio Connect Agent.lnk" -NewName "EA Agent" -Icon "C:\Program Files\Resilio Connect Agent\icon.ico"

  4. Run the Job.