Override File

Many non-ESPN APIs do not return values for attributes used by the TeamTracker Card and custom automations (i.e. logos, names, team colors). In other cases, a user may want to override a value returned by the API.

The teamtracker_overrides.json file provides a way to supply or override these values. This file should be placed in your config directory with your configuration.yaml file.

The file allows you to override the values of many league and team attributes.

The overrides key off of sport_path,league_path and team_id. The example below shows all of the attributes that may be overwritten. Only attributes in the file will be overwritten. Any attributes not in the file will use the default values provided by the API or provided by the default override file in teamtracker/overrides/defaults.json.

To force a reload once the teamtracker_overrides.json file has been updated, run the Teamtracker Reload File Overrides Action for any TeamTracker sensor. Restarting Home Assistant will also reload the file. The overrides are universal and will be applied to all TeamTracker sensors the next time they call the API. If there are errors in the override file, they will be noted in the system log and the file will be ignored.

Sample File: teamtracker_overrides.json

{
  "{sport_path}": {
    "{league_path}": {
      "league_name": "Sample League",
      "league_logo": "/local/icons/localLogo.png",
      "public_key": "url key",
      "client_code": "url code",
      "teams": {
        "{team_id}": {
          "abbr": "ABBR",
          "long_name": "Sample City Nickname",
          "name": "Sample Nickname",
          "logo": "https://www.logo.com/remoteLogo.png",
          "url": "https://www.sampleTeamSite.com",
          "colors": [
            "#FFFFFF",
            "#000000"
          ]
        }
      }
    }
  }
}
'''