Unicon-eLux-Implementing Custom Themes on eLux 7 Without Corporate Design Packager

book

Article ID: CTX695759

calendar_today

Updated On:

Description

Details

  • Issue:

    • eLux 7 devices cannot use the Corporate Design Packager for theme creation.

    • A UI-based feature will be added later in the Scout Board.

    • In the meantime, themes must be applied manually using file transfers and commands.

  • Process Overview:

    • Use Scout Console to transfer theme files and apply them with custom commands.

    • Customize the following files:

      • desktopBackgroundImage.jpg → desktop background

      • productImage.png and brandImage.png → branding elements

      • config.json → theme properties (e.g., name, accent color)

  • Prepare Theme Files:

    • Retrieve default theme files from /setup/elux/themes/unicon_default.

    • Edit images and config.json as needed.

    • Ensure all images are ≤500 kB.

    • Example config.json:

       
       
      {
        "name": "custom",
        "accentColor": "#b042f5"
      }
      
  • Create Custom Theme Folder:

    • In Scout Console, run a custom command:

       
       
      mkdir /setup/elux/themes/custom
      
    • Replace custom with your preferred theme name.

    • Enable Run with System Rights and execute.

  • Transfer Theme Files:

    • In Scout Console, go to Advanced Device Configuration → Files → Transfer Files.

    • Upload customized files to /setup/elux/themes/custom.

  • Apply Custom Theme:

    • Run command in Scout Console:

       
       
      ucsettingsctl -o Desktop -v CurrentTheme=custom
      
    • Replace custom with the theme name defined in config.json.

  • Restart Device:

    • Restart the device to activate the custom theme.

    • Result:
    • image.png
    • image.png
  • Notes:

    • This method ensures consistent corporate design until the Scout Board feature is available.

    • Always test on a single device before deploying across multiple devices or OUs.

Issue/Introduction

The Corporate Design Packager does not support eLux 7. Until the Scout Board introduces a UI-based theme creation feature, administrators can implement custom themes using file transfer mechanisms and custom commands in Scout Console. This allows customization of background, branding images, and theme properties.