Home Assistant Home Assistant

Dark Sky

The darksky platform uses the Dark Sky web service as a source for meteorological data for your location.

Configuration

On March 31, 2020 Dark Sky was acquired by Apple and is no longer allowing new API registrations. The Dark Sky API will continue to function for existing users through the end of 2021, but it is no longer possible to obtain an API key for new users. Home Assistant supports many alternative weather integrations.

The free tier allows up to 1000 calls per day, this platform updates at most every 3 minutes, using up to 480 of those calls.

Dark Sky will charge you $0.0001 per API call if you enter your credit card details and create more than 1000 calls per day.

To add Dark Sky to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
weather:
  - platform: darksky
    api_key: YOUR_API_KEY

Configuration Variables

api_key string Required

Your API key for Dark Sky.

latitude float (Optional)

Manually specify latitude. By default the value will be taken from the Home Assistant configuration.

Default:

Provided by Home Assistant configuration

longitude float (Optional)

Manually specify longitude. By default the value will be taken from the Home Assistant configuration.

Default:

Provided by Home Assistant configuration

units string (Optional)

Manually specify unit system. Valid values are: auto, us, si, ca, uk and uk2.

Default:

si if Home Assistant unit system is metric, us if imperial.

name string (Optional, default: Dark Sky)

Name to use in the frontend.

mode string (Optional, default: hourly)

The forecast type. Can be hourly or daily.

This platform is an alternative to the darksky sensor.

Details about the API are available in the Dark Sky documentation.