With this sensor platform, you will be able to integrate the test build results reported by Travis-CI working within Home Assistant.


Create a GitHub access token with the following scopes:

  • read:org
  • user:email
  • repo_deployment
  • repo:status
  • write:repo_hook


To enable this platform, please add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI.[Learn more] file:

# Example configuration.yaml entry
  - platform: travisci
    api_key: YOUR_ACCESS_TOKEN

Configuration Variables

api_key string Required

The access token for GitHub.

branch string (Optional, default: master)

Determine which default branch should be used by the state condition.

monitored_conditions list (Optional)

Conditions to display in the frontend. If not specified, all conditions below will be enabled by default. The following conditions can be monitored.


Turn the last build job ID.


Return the time elapsed in seconds to run the last test job.


Return the timestamp of when the last test job finished.


Return the timestamp of when the last test job started.


Return the state from the latest test job/PR. The conditions can be: ‘passed’, ‘failed’ or ‘started’.


Return the build test from the branch specified at by branch parameter.

repository list (Optional)

Name from the GitHub repositories to be monitored. If not specified, all GitHub repositories linked to Travis-CI will be enabled by default.