README.md

🕚
Doomsday Clock sensor
^{_{🏡 a Home Assistant custom component …for your fallout shelter? 😱}}

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.

Be sure to ⭐️ this repo if you find it useful! 😃

Sensor state card and details popup.

🔝

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! 😱

Doomsday Clock description video by Vox.

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.

🔝

Usage 💻

To enable the Doomsday Clock sensor in your installation:

1. 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 your configuration.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).
2. Add the sensor to your configuration.yaml file (see below ⬇️).
3. Restart Home Assistant.
4. Despair. 😭
5. 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:
   • 🇺🇸 USA
   • 🇨🇦 Canada
   • 🇪🇺 EU
   • 🇬🇧 UK
   • 🇦🇺 Australia
   • 🇳🇿 New Zealand

🔝

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 ✨

René-Marc Simard 💻 📖

jamiepryer 🐛

John Dyer 🤔

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! 😃

🔝

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.

🕊️ Make the world a better place! 🌱

🔝

Don't forget to ⭐️ this repo! 😃