Awesome
<h1 align="center"> <a name="top">π</a><br/>Doomsday Clock sensor<br/> <sup><sub>π‘ a <a href="https://www.home-assistant.io/">Home Assistant</a> custom component β¦for your fallout shelter? π±</sub></sup> </h1>Add support for the Doomsday Clock world threat assessment index from the Bulletin of the Atomic Scientists inside the Home Assistant open-source home automation platform.
<div align="center"> <p><strong>Be sure to <a href="#" title="star">βοΈ</a> this repo if you find it useful! π</strong></p> <figure> <div> <img src="./.github/screenshot-card.png" alt="Sensor state card" title="Sensor state card" width="325"> <img src="./.github/screenshot-details.png" alt="Sensor details" title="Sensor details" width="325"> </div> <figcaption> <p><strong>Sensor state card and details popup.</strong></p> </figcaption> </figure> </div> <p align="right"><a href="#top" title="Back to top">π</a></p>Description π
The Doomsday Clock helps monitor how close humanity is to a man-made global catastrophe, its own destruction if you will, either through nuclear war or climate change. Useful in case egocentric psychopaths keep on playing Russian roulette with humanity's future. Makes a great addition to your fallout shelter's Home Assistant build! π±
<div align="center"> <figure> <div> <a href="https://www.youtube.com/watch?v=jCnWPbn-ZKo"><img src="http://img.youtube.com/vi/jCnWPbn-ZKo/maxresdefault.jpg" alt="Doomsday Clock description video by Vox" title="Doomsday Clock description video by Vox" width="400"></a> </div> <figcaption> <p><strong><a href="https://www.youtube.com/watch?v=jCnWPbn-ZKo">Doomsday Clock description video by <em>Vox</em>.</a></strong></strong></p> </figcaption> </figure> </div>The clock doesn't change often, at most once a year, and offers no API. Since we rely on web scraping of TheBulletin.org the component has a goodwill throttle of 6 hours (21,600 seconds), but it would be best to set the scan interval for the sensor to 1 day (86,400 seconds) or more.
<p align="right"><a href="#top" title="Back to top">π</a></p>Usage π»
To enable the Doomsday Clock sensor in your installation:
- Install the component using one of these methods:
- Using HACS (Home Assistant Community Store):
Add the following URL as a custom integration repository through the Community Store interface.https://github.com/renemarc/home-assistant-doomsday-clock
- Using Custom Updater (now deprecated):
Add the following to yourconfiguration.yaml
file.custom_updater: component_urls: - https://raw.githubusercontent.com/renemarc/home-assistant-doomsday-clock/master/tracker.json
- Manually:
Copy the folder/custom_components/doomsday_clock/
to your configuration's/custom_components/
directory (create it if needed).
- Using HACS (Home Assistant Community Store):
- Add the sensor to your
configuration.yaml
file (see below β¬οΈ). - Restart Home Assistant.
Despair.π- Tell your government representatives that you want to live in a healthy, peaceful world free from nuclear threats and fossil fuel pollution.
ππ±
It's easy and fast, just find and tweet them using these free online lists:
Configuration β
# Example configuration.yaml entry
sensor:
- platform: doomsday_clock
scan_interval: 86400
- icon (string) (optional)
Material Design Icon that illustrates the sensor. (default =mdi:nuke
) - name (string) (optional)
Custom name of sensor. (default =Doomsday Clock
) - scan_interval (number) (optional)
Number of seconds between polls. (minimum =21600
seconds [6 hours]) - unit_of_measurement (string) (optional)
Custom unit of measurement for the value. (default =min
) - value_template (template) (optional)
Custom template to manipulate the state of the sensor.
Contributors β¨
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore --> <table><tr><td align="center"><a href="https://renemarc.com/"><img src="https://avatars3.githubusercontent.com/u/13276793?v=4" width="100px;" alt="RenΓ©-Marc Simard"/><br /><sub><b>RenΓ©-Marc Simard</b></sub></a><br /><a href="https://github.com/renemarc/home-assistant-doomsday-clock/commits?author=renemarc" title="Code">π»</a> <a href="https://github.com/renemarc/home-assistant-doomsday-clock/commits?author=renemarc" title="Documentation">π</a></td><td align="center"><a href="https://github.com/jamiepryer"><img src="https://avatars3.githubusercontent.com/u/48566948?v=4" width="100px;" alt="jamiepryer"/><br /><sub><b>jamiepryer</b></sub></a><br /><a href="https://github.com/renemarc/home-assistant-doomsday-clock/issues?q=author%3Ajamiepryer" title="Bug reports">π</a></td><td align="center"><a href="http://johntdyer.com"><img src="https://avatars3.githubusercontent.com/u/58234?v=4" width="100px;" alt="John Dyer"/><br /><sub><b>John Dyer</b></sub></a><br /><a href="#ideas-johntdyer" title="Ideas, Planning, & Feedback">π€</a></td></tr></table> <!-- ALL-CONTRIBUTORS-LIST:END -->This project follows the all-contributors specification (emoji key available here). Found a bug, want to suggest an idea or share some improvements? Contributions of any kind are welcome! π
<p align="right"><a href="#top" title="Back to top">π</a></p>Thanks π
- @custom_components for their component blueprint and Home Assistant integration tools.
- @mattbierner for the inspiration from his MinutesToMidnight Node.js library.
- The Bulletin of the Atomic Scientists for keeping the world in check since 1947.