{"id":26767742,"url":"https://github.com/danq8/hacs_neo_watcher","last_synced_at":"2025-03-28T21:17:23.208Z","repository":{"id":283467513,"uuid":"951862232","full_name":"danq8/hacs_neo_watcher","owner":"danq8","description":"A custom component for Home Assistant that retrieves NEO data from NASA.","archived":false,"fork":false,"pushed_at":"2025-03-28T18:57:23.000Z","size":261,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T19:32:20.096Z","etag":null,"topics":["asteroids","comets","ela","home-assistant","homeassistant","nasa","near-earth-objects","space"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danq8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-20T11:07:45.000Z","updated_at":"2025-03-28T18:35:27.000Z","dependencies_parsed_at":"2025-03-21T14:02:40.753Z","dependency_job_id":null,"html_url":"https://github.com/danq8/hacs_neo_watcher","commit_stats":null,"previous_names":["danq8/hacs_neo_watcher"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fhacs_neo_watcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fhacs_neo_watcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fhacs_neo_watcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fhacs_neo_watcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danq8","download_url":"https://codeload.github.com/danq8/hacs_neo_watcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246100581,"owners_count":20723479,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asteroids","comets","ela","home-assistant","homeassistant","nasa","near-earth-objects","space"],"created_at":"2025-03-28T21:17:22.713Z","updated_at":"2025-03-28T21:17:23.185Z","avatar_url":"https://github.com/danq8.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/danq8/hacs_neo_watcher/main/icon.png\" alt=\"Near Earth Object Watcher logo\" title=\"Near Earth Object Watcher\" align=\"right\" height=\"60\" /\u003e\n\n# Near Earth Object Watcher\n\n![GitHub Release](https://img.shields.io/github/v/release/danq8/hacs_neo_watcher)\n\n**A custom component for Home Assistant that retrieves NEO data from NASA.**\n\nNASA's Near-Earth Object (NEO) program focuses on detecting, tracking, and characterizing potentially hazardous asteroids and comets that could approach Earth, with the goal of understanding and mitigating potential risks.\n\nThey watch so you don't have to worry.\n\n# What this component does\n\n\u003cimg src=\"https://raw.githubusercontent.com/danq8/hacs_neo_watcher/main/doc/Example_Page.JPG\" alt=\"Near Earth Object Watcher example page\" title=\"Near Earth Object Watcher example page\" align=\"right\" height=\"500\" /\u003e\n\n[Download Home Assistant page yaml here](https://raw.githubusercontent.com/danq8/hacs_neo_watcher/main/doc/Example_view.yaml)\n\nThis component takes the data for the next 28 days provided by the NASA Near Earth Object Web Service\u003cbr /\u003e  We exclude any objects that have not been categorised as \"potentially dangerous\"\u003cbr /\u003e    We then pick out 6 that come the closest, and create a sensor for each one,\u003cbr /\u003e  and fill the attributes including speed, size, how close to earth it will get, and the date that it will be at it's closest.\n\n# Why create this component?\n\nI created this Home Assistant integration for two reasons\n\n- Because NASA has made this information public\n  \n  I had been searching for public API's with interesting information that I could display on HA.\u003cbr /\u003e  I wanted to learn more about what it takes to create an integration and expose entities with attributes.\n\n\n- Because the NEO project is a testament to human curiosity and ingenuity.\n\n  It's a reminder that science is not just a subject in school; it's a powerful tool for understanding and safeguarding our world.\u003cbr /\u003e  The more we know, the less we have to fear, and the more we can appreciate the incredible universe we live in.\u003cbr /\u003e  This component is meant for people who are curious to know how often large, potentially dangerous objects pass us by on a monthly basis.\n  \n  If you're looking for an early warning system,\u003cbr /\u003e   the NASA website and the mainstream news organisations will have the information before it's shown here, sorry.\n  \n  You can find out more about the NASA project here: https://science.nasa.gov/planetary-defense-neoo/\u003cbr /\u003e  and here: https://cneos.jpl.nasa.gov/ca/neo_ca_intro.html\u003cbr /\u003e  and here: https://neo.gsfc.nasa.gov/\n\n  You can find out more about the NASA API here: https://api.nasa.gov/\n\n# Installation\n\nYou will need a NASA API key, don't worry, it's free (They just need your email address).\n\nThe key can be obtained here, under \"Generate API Key\": https://api.nasa.gov/\n\n*Please mention this github repository under \"How will you use the APIs?\"\n\nI plan to submit this repository to the folks at HACS (https://hacs.xyz/).\n\nIn the meantime you can install this component by\n\n- going to the HACS menu,\u003cbr /\u003e  clicking the three dots in the top right of the screen,\u003cbr /\u003e  selecting \"Custom repositories\" and adding https://github.com/danq8/hacs_neo_watcher as a repository, \u003cbr /\u003e  then selecting Type = Integration.\n\n- search the HACS store for NEO Watcher, click on the three dots to the right of the row and click on Download\n\n- You'll be asked to reboot HA\n\n- After the reboot go to Settings --\u003e Devices \u0026 services, and click on \"+ ADD INTEGRATION\"\n\n- Search for NEO Watcher, click on the result, enter your API key and click SUBMIT.\n\nOnce initialised you should see 9 new sensors, your allowed API rate limit, how many API calls you have left, how many potentially hazardous objects in the next 14 days found, and the 6 sensors showing the 6 closest potentially dangerous objects.\n\n# Contributing To The Project\n\n![python badge](https://img.shields.io/badge/Made%20with-Python-orange)\n![github contributors](https://img.shields.io/github/contributors/danq8/hacs_neo_watcher?color=orange)\n![last commit](https://img.shields.io/github/last-commit/danq8/hacs_neo_watcher?color=orange)\n\nThere are several ways of contributing to this project, they include:\n\n- Suggesting new sensors as a feature request\n\n  using this link: [Request a feature](https://github.com/danq8/hacs_neo_watcher/issues/new?template=FEATURE-REQUEST.yml)\n\n\n- Adding new sensors\n- Updating or improving the documentation\n- Helping answer/fix any issues raised\n\n  For further details see [contributing](/doc/contributing.md) guidelines.\n\n# Licence\n\n![github licence](https://img.shields.io/badge/Licence-MIT-orange)\n\nThis project uses the MIT Licence, for more details see the \u003ca href=\"/doc/LICENSE\"\u003elicence\u003c/a\u003e document.\n\n# Showing Your Appreciation\n\nIf you like this project, please give it a star on [GitHub](https://github.com/danq8/hacs_neo_watcher)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanq8%2Fhacs_neo_watcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanq8%2Fhacs_neo_watcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanq8%2Fhacs_neo_watcher/lists"}