{"id":35194724,"url":"https://github.com/danq8/neo_watcher","last_synced_at":"2026-05-17T20:35:11.556Z","repository":{"id":283467513,"uuid":"951862232","full_name":"danq8/neo_watcher","owner":"danq8","description":"A custom component for Home Assistant that retrieves NEO data from NASA.","archived":false,"fork":false,"pushed_at":"2025-05-29T11:49:20.000Z","size":757,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-29T13:14:33.289Z","etag":null,"topics":["2024-yr4","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,"zenodo":null}},"created_at":"2025-03-20T11:07:45.000Z","updated_at":"2025-05-29T11:44:38.000Z","dependencies_parsed_at":"2025-05-01T16:21:59.570Z","dependency_job_id":"eab82256-30ad-4618-adf6-c084483a3ebe","html_url":"https://github.com/danq8/neo_watcher","commit_stats":null,"previous_names":["danq8/hacs_neo_watcher","danq8/neo_watcher"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/danq8/neo_watcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fneo_watcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fneo_watcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fneo_watcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fneo_watcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danq8","download_url":"https://codeload.github.com/danq8/neo_watcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danq8%2Fneo_watcher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33153895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T09:28:26.183Z","status":"ssl_error","status_checked_at":"2026-05-17T09:27:52.702Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["2024-yr4","asteroids","comets","ela","home-assistant","homeassistant","nasa","near-earth-objects","space"],"created_at":"2025-12-29T06:55:06.962Z","updated_at":"2026-05-17T20:35:11.550Z","avatar_url":"https://github.com/danq8.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/danq8/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/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\nFor each Near Earth Object you choose to track, a link is created to NASA's NEO Orbital Viewer,\u003cbr/\u003ewhich is especially fascinating as it gives you an incredible 4D model that shows you how the object will pass through our solar system over time. \u003cbr/\u003e(That's NASA's work!)\n\n\u003cimg src=\"https://raw.githubusercontent.com/danq8/neo_watcher/main/doc/NASA_NEO_Orbital_Viewer.JPG\" alt=\"NASA Near Earth Object Orbital Viewer\" title=\"NASA's Near Earth Object Orbital Viewer\" height=\"300\" /\u003e\n\nAn example of how to display the information on a page is given here:\n\u003cimg src=\"https://raw.githubusercontent.com/danq8/neo_watcher/main/doc/Example_Page.JPG\" alt=\"Near Earth Object Watcher example page\" title=\"Near Earth Object Watcher example page\" height=\"500\" /\u003e\n\n\u003ca href=\"https://raw.githubusercontent.com/danq8/neo_watcher/main/doc/Example_view.yaml\" target=”_blank”\u003eDownload this example Home Assistant page yaml here\u003c/a\u003e\u003cbr/\u003e\n\nThis component takes the data for the next 1 week (up to 2 years) provided by the NASA Near Earth Object Web Service\u003cbr /\u003e  For your chosen time period, it can show you anything from the top 1 to the top 20 \"potentially dangerous\" and non \"potentially dangerous\" objects passing by Earth.\u003cbr /\u003eThere is also the option of watching specific NEOs (like everyone's favourite \"2024 YR4\").\u003cbr /\u003e  The sensors contain attributes including speed, size, how close to earth it will get, and the date that it will be at it's closest, or the next time it will be close.\u003cbr /\u003e\n\n\u003cdetails\u003e\u003csummary\u003eClick here to find out why I created this component\u003c/summary\u003e\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\u003c/details\u003e\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\n### Installation via HACS\n\nHave [HACS](https://hacs.xyz/) installed on your Home Assistant.\n\n* Adding NEO Watcher to HACS can be done using this button:\n\n[![image](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=danq8\u0026amp;repository=neo_watcher\u0026amp;category=integration)\n\n* Click Install on the `NEO Watcher` integration.\n* Restart Home Assistant.\n\u003e [!NOTE]\n\u003e If the button above doesn't work, add `https://github.com/danq8/neo_watcher` as a custom repository with a type of Integration in HACS.\n\n\u003cdetails\u003e\u003csummary\u003eManual installation\u003c/summary\u003e\n \n* Copy `neo_watcher`  folder from [latest release](https://github.com/danq8/neo_watcher/releases/latest) to [`custom_components` folder](https://developers.home-assistant.io/docs/creating_integration_file_structure/#where-home-assistant-looks-for-integrations) in your config directory.\n* Restart the Home Assistant.\n* go to Settings --\u003e Devices \u0026 services, and click on \"+ ADD INTEGRATION\"\n* Search for NEO Watcher, click on the result, enter your API key and click SUBMIT.\n\u003c/details\u003e\n\u003cbr/\u003e\n\n# Configuration\n\nSimply go to Settings --\u003e \"Devices and services\" --\u003e \"Add integration\"\u003cbr/\u003echoose the NEO Watcher integration\u003cbr/\u003e\nYou will then see this page:\u003cbr/\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/danq8/neo_watcher/main/doc/Config_Page_1.JPG\" alt=\"NEO Watcher 1st configuration page\" title=\"NEO Watcher 1st configuration page\" height=\"250\" /\u003e\u003cbr/\u003e\nPaste in your NASA API key,\u003cbr/\u003echoose between watching a particular object or having the top (closest) objects,\u003cbr/\u003ethen choose what hour of day you want the data refreshed.\u003cbr/\u003e\u003cbr/\u003e\n\n\u003cdetails\u003e\u003csummary\u003eConfigure Top NEOs\u003c/summary\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/danq8/neo_watcher/main/doc/Config_Page_2a.JPG\" alt=\"NEO Watcher 2nd configuration page\" title=\"NEO Watcher 2nd configuration page\" height=\"250\" /\u003e\u003cbr/\u003e\nHere you'll be able to choose how far to look into the future in weeks (Maximum 2 years).\u003cbr/\u003e\nAs well as whether you just want just the first closest top objects (potentially dangerous and non-potentially dangerous) all the way up to the top 20 objects.\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003eWatch a specific NEO\u003c/summary\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/danq8/neo_watcher/main/doc/Config_Page_2b.JPG\" alt=\"NEO Watcher 3rd configuration page\" title=\"NEO Watcher 3rd configuration page\" height=\"250\" /\u003e\u003cbr/\u003e\nHere you'll simply need to type in the name or designation of the object.\u003cbr/\u003e(You can find these on NASA's NEO page: [https://cneos.jpl.nasa.gov/ca/](https://cneos.jpl.nasa.gov/ca/)\u003cbr/\u003e\n\u003c/details\u003e\nClick submit and the data will start to load\u003cbr/\u003e\n\nOnce initialised you should see the new sensors. There will be one showing the integration stats, along with how ever many NEOs you've selected to watch.\n\n\n\n \n\u003cdetails\u003e\u003csummary\u003eContributing To The Project\u003c/summary\u003e\n![python badge](https://img.shields.io/badge/Made%20with-Python-orange)\n![github contributors](https://img.shields.io/github/contributors/danq8/neo_watcher?color=orange)\n![last commit](https://img.shields.io/github/last-commit/danq8/neo_watcher?color=orange)\n\nThere are several ways of contributing to this project, they include:\n\n- Suggesting new sensors or NEO information as a feature request\n\n  using this link: [Request a feature](https://github.com/danq8/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\u003c/details\u003e\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/neo_watcher)\n\n# My appreciation\n\nMy appreciation goes out to NASA,\u003cbr/\u003e\nand especially the SpaceRocks Team: David Greenfield, Arezu Sarvestani, Jason English and Peter Baunach.\u003cbr/\u003e\n[https://github.com/SpaceRocks/](https://github.com/SpaceRocks/)\u003cbr/\u003e\u003cbr/\u003e\nI have to mention the amazing work of the Home Assistant team [https://www.home-assistant.io/](https://www.home-assistant.io/)\u003cbr/\u003e\nAnd the HACS team [https://www.hacs.xyz/](https://www.hacs.xyz/)\u003cbr/\u003e\u003cbr/\u003e\nAlso, I have to say a big thanks to Google Gemini, without whose help I couldn't have done it.\u003cbr/\u003eGemini was a game collaborator, but did go off on a few tangents,\u003cbr/\u003e telling me on a few occasions that they were certain, certain, certain, certain that this time they had understood the errors from the logs, the hints and documentation I'd provided and that the new, new, new, new suggestion would be the right one.\u003cbr/\u003eI'd liken working with Gemini 2.5 with walking a puppy in a park for the first time. Full of enthusiasm and energy, but a little too focused on the strange new bug crawling around on the ground, rather than on me calling it back to safety.\u003cbr/\u003eBetween us we got the job done, and for that I'm grateful.\u003cbr/\u003e\n[https://gemini.google.com/app](https://gemini.google.com/app)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanq8%2Fneo_watcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanq8%2Fneo_watcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanq8%2Fneo_watcher/lists"}