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.

If the override contains the substring {attribute_name}, the value of the specified attribute will be inserted.

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.

If you create an override file for a league or team, please consider contributing it to the community. Open an Issue and attach the file. All contributions benefiting the community will be merged into the default override file and included in a future release.

Sample File: teamtracker_overrides.json

{
  "{sport_path}": {
    "{league_path}": {
      "league_name": "Sample League",
      "league_logo": "/local/icons/localLogo.png",
      "event_url": "https://sampleEvent.com/{event_id}",
      "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"
          ]
        }
      }
    }
  }
}
'''