Software Icon Overrides¶

Software icon overrides are file-backed rules that fix missing or wrong installed-software icons.

Override File¶

Data/Engine/Containers/api-backend/data/services/API/devices/software_icons_overrides.json

Operator Path¶

Use Installed Software row context menu first:

Open device Installed Software.
Right-click software name.
Select Create Global Icon Override.
Choose verified .ico, .exe, .dll, or resource path, or intentionally clear icon.
Save.
Use Query Software Changes.
Commit JSON rule later when it should become official.

JSON Shape¶

{
  "windows_icon_overrides": [
    {
      "rule_id": "icon_override_contoso_agent",
      "name": "Contoso Agent",
      "display_icon": "C:\\Program Files\\Contoso Agent\\branding\\agent.ico"
    }
  ]
}

Clear icon:

{
  "windows_icon_overrides": [
    {
      "rule_id": "icon_override_contoso_agent_blank",
      "name": "Contoso Agent",
      "clear_icon": true
    }
  ]
}

Match Rule¶

Icon overrides match exact software name, case-insensitive. Version, publisher, source, and install location are intentionally ignored.

Detailed Codex Breakdown

Implementation references¶

Engine override loader: Data/Engine/Containers/api-backend/data/services/API/devices/software_icons.py
Override data file: Data/Engine/Containers/api-backend/data/services/API/devices/software_icons_overrides.json
Installed Software UI: Data/Engine/Containers/webui-frontend/data/web-interface/src/Devices/Tabs/Installed_Software.jsx
Agent software role: Data/Agent/internal/roles/software_management/

Behavior¶

First matching rule wins.
Agent applies matching metadata before icon extraction.
Engine reapplies matching icon metadata when serving device details.
Once a refreshed device publishes an override-derived icon asset, Engine can reuse that known icon hash for same-name rows fleet-wide.