Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/exxamalte/home-assistant-custom-components-nsw-rural-fire-service-fire-danger
Home Assistant Custom Component: NSW Rural Fire Service Fire Danger
https://github.com/exxamalte/home-assistant-custom-components-nsw-rural-fire-service-fire-danger
custom-component fire-danger homeassistant nsw rural-fire-service sensor
Last synced: about 2 months ago
JSON representation
Home Assistant Custom Component: NSW Rural Fire Service Fire Danger
- Host: GitHub
- URL: https://github.com/exxamalte/home-assistant-custom-components-nsw-rural-fire-service-fire-danger
- Owner: exxamalte
- License: apache-2.0
- Created: 2020-10-24T06:40:42.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-11T16:02:59.000Z (3 months ago)
- Last Synced: 2024-09-12T14:47:30.984Z (3 months ago)
- Topics: custom-component, fire-danger, homeassistant, nsw, rural-fire-service, sensor
- Language: Python
- Homepage:
- Size: 123 KB
- Stars: 10
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# NSW Rural Fire Service - Fire Danger
[](https://github.com/custom-components/hacs)
[](https://github.com/exxamalte/home-assistant-custom-components-nsw-rural-fire-service-fire-danger/actions/workflows/ci.yaml)
[](https://codecov.io/gh/exxamalte/home-assistant-custom-components-nsw-rural-fire-service-fire-danger)
[](https://gitHub.com/exxamalte/home-assistant-custom-components-nsw-rural-fire-service-fire-danger/releases/)
[](https://github.com/exxamalte/home-assistant-custom-components-nsw-rural-fire-service-fire-danger/blob/master/LICENSE)
[](https://www.buymeacoffee.com/neonninja)
[](https://neon.ninja/2019/02/fire-danger-rating/)
The New South Wales Rural Fire Service provides an [XML feed](http://www.rfs.nsw.gov.au/feeds/fdrToban.xml) that contains the fire danger details for today and tomorrow for districts in the state.
This custom component automatically generates the following entities:
* Danger level today
* Danger level tomorrow
* Danger level day 3 (extended feed only)
* Danger level day 4 (extended feed only)
* Fire ban today
* Fire ban tomorrow
* Fire ban day 3 (extended feed only)
* Fire ban day 4 (extended feed only)
## Installation
Install this component via HACS, then go to "Configuration" -> "Integrations" and search for "NSW Rural Fire Service - Fire Danger".
You have to select your district from the list, choose a feed, and then hit "Submit".
There are currently two different feeds supported:
* Standard: This provides a forecast for today and tomorrow only, and appears as a dedicated feed on the RFS's website.
* Extended: This provides a forecast for 4 days, and is [used on the RFS's website](https://www.rfs.nsw.gov.au/fire-information/fdr-and-tobans).
There is currently no option to switch between the two feeds, so please delete and recreate the configuration if you want to switch feeds.
The actual feed contains the value "NONE" in case no rating has been issued. This is converted into `None` which has a special meaning in Python and hence in Home Assistant,
and which subsequently may cause confusion when used in automations. There is an option available when setting up this integration to automatically convert this into "No Rating"
which is the term used on the RFS website.
**Please note:** If you have previously used the [custom component published on my GitHub repository](https://github.com/exxamalte/home-assistant-customisations/tree/master/nsw-rural-fire-service-fire-danger), please remove this manually including any template sensors you created.
All entities will be generated automatically and the state will be updated every 15 minutes from the external feed.
The following attributes will be available with each entity.
| Attribute | Description |
|-----------------------|-----------------------------------------------------|
| district | District name |
| region_number | Internal number of this district |
| councils | List of all councils in this district |
| danger_level_today | Today's danger level |
| danger_level_tomorrow | Tomorrow's danger level |
| danger_level_day3 | Danger level in two days |
| danger_level_day4 | Danger level in three days |
| fire_ban_today | Indicates whether there is a fire ban today |
| fire_ban_tomorrow | Indicates whether there is a fire ban tomorrow |
| fire_ban_day3 | Indicates whether there is a fire ban in two days |
| fire_ban_day4 | Indicates whether there is a fire ban in three days |
**Please note:** Over the winter period, the Rural Fire Service typically does not publish any fire danger rating, and this component just shows "None" as fire danger level.
## More Information
Please [have a look at my blog](https://neon.ninja/2019/02/fire-danger-rating/) which is showcasing an earlier version of this component.
## Configuration Details
The following [districts are currently supported by this integration](http://www.rfs.nsw.gov.au/feeds/fdrToban.xml):
* Far North Coast
* North Coast
* Greater Hunter
* Greater Sydney Region
* Illawarra/Shoalhaven
* Far South Coast
* Monaro Alpine
* ACT
* Southern Ranges
* Central Ranges
* New England
* Northern Slopes
* North Western
* Upper Central West Plains
* Lower Central West Plains
* Southern Slopes
* Eastern Riverina
* Southern Riverina
* Northern Riverina
* South Western
* Far Western
**Please note:** The RFS has recently changed the district name "ACT" to "The Australian Capital Territory".
For backwards compatibility reasons I decided to keep the name "ACT" for now. Please let me know if you are a
resident of the ACT and would prefer having the full name in this integration.