1.5 KiB
title | description | ha_category | ha_release | ha_iot_class | ha_domain | |
---|---|---|---|---|---|---|
GitHub | How to integrate the GitHub sensor into Home Assistant. |
|
0.88 | Cloud Polling | github |
The GitHub sensor integrates data from GitHub to monitor your favorite repositories.
Setup
To set up this sensor you will need a personal access token. You will need to check the repo
scope for the sensor to function.
Configuration
To enable this platform, add the following to your configuration.yaml
file:
# Example configuration.yaml entry
sensor:
- platform: github
access_token: !secret github_access_token
repositories:
- path: 'home-assistant/core'
{% configuration %}
access_token:
description: Your GitHub Access Token
required: true
type: string
url:
description: If you are using a GitHub Enterprise server, add it's URL here. For example, https://mygithubserver.com
required: false
type: string
repositories:
description: A list of repository paths and optionally a name
required: true
type: list
keys:
path:
description: Path to the repository. For Home Assistant this will be home-assistant/core
required: true
type: string
name:
description: Name of the sensor. Gives the sensor a custom name in Home Assistant. Defaults to the repository name from GitHub if not specified.
required: false
type: string
{% endconfiguration %}