Search code, repositories, users, issues, pull requests...
We read every piece of feedback, and take your input very seriously.
Use saved searches to filter your results more quickly.
To see all available qualifiers, see our documentation .
Spook 👻 Not your homie
Name already in use.
Use Git or checkout with SVN using the web URL.
Work fast with our official CLI. Learn more about the CLI .
- Open with GitHub Desktop
- Download ZIP
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
- 529 commits
Spook 👻 Not your homie.
Hi! I'm Spook 👻 and I'm a custom integration for use with Home Assistant. I will extend your Home Assistant instance with a huge set of scary powerful tools. 🛠️
Learn all about me in the extensive documentation
⚠️ Just to be very clear...
Spook is not affiliated with, endorsed, recommended, or supported by the Home Assistant project.
This custom integration is provided as-is, without any warranty or support. If you experience issues with this integration, or as a result of this integration, please go cry a lot on your own.
We've set up a separate document for our contribution guidelines .
Authors & contributors
The original setup of this repository is by Franck Nijhof .
Thanks to everyone who already contributed! ❤️
For a full list of all authors and contributors, check the contributor's page .
Spook isn't very good at speaking different languages, but you can help!
As a matter of fact, Spooks translation files are CC0 licensed !
Translating can be done from your webbrowser, no programming knowledge is needed!
Copyright (c) 2023-2024 Franck Nijhof
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, but NOT including the right to run, execute or use the Software or any executable binaries built from the source code.
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Code of conduct
Security policy, releases 42, sponsor this project.
- Python 100.0%
The new version of Spook is a leap forward
The first version of Spook was really interesting, especially the feature to insert historic data in the database. With the newer versions Frenck have lifted the integration to a whole new level!
If you are missing and odd feature in HA, then you should really check it out.
Repository frenck/spook not found.
Ok, so should I use Spook? No! The license doesn’t allow that (see below).
Time to zone out and relax 📍
A zone in Home Assistant is a virtual representation of a physical space. Think of it as drawing a circle on a map; that circle represents a zone. Zones are used to track the location of people and devices but can also be used to trigger automations based on entering or leaving a zone.
Spook adds new services to the zone integrations that allow you to manage and modify them using automations dynamically.
Figure 1 : Spook adds a service that allows importing data into the recorder.
Devices & entities ¶
Spook does not provide any new devices or entities for this integration.
Spook adds the following new service to your Home Assistant instance:
Create a zone ¶
Adds a new zone to your Home Assistant instance.
The radius attribute must be entered in meters.
Update a zone ¶
Updates properties of an existing zone.
The radius attribute must be entered in meters. Only the parameters that are provided will be updated. Other parameters will remain unchanged.
Delete a zone ¶
Deletes a zone from Home Assistant
Or delete multiple at ones:
Spook has no repair detections for this integration.
Uses cases ¶
Some use cases for the enhancements Spook provides for this integration:
- You could use these services to dynamically create and update zones around a car or a person using automations. Using these you could tell who is close to the car or notify if you are near a certain person.
Blueprints & tutorials ¶
There are currently no known blueprints or tutorials for the enhancements Spook provides for this integration. If you created one or stumbled upon one, please let us know in our discussion forums .
Features requests, ideas and support ¶
If you have an idea on how to further enhance this integration, for example, by adding a new service, entity, or repairs detection; feel free to let us know in our discussion forums .
Are you stuck using these new features? Or maybe you’ve run into a bug? Please check the Support page on where to go for help.