spook is a free, open source internet of things (iot) project written in Python and released under MIT. It has 1,761 GitHub stars, 108 forks and 29 open issues, and was last pushed 15 hours ago. On this registry it ranks #52 of 99 tracked projects in Internet of Things (IoT), with 5 head-to-head comparisons available. It gained 439 stars over the last 30 tracked days.

What is spook?

Spook is a custom integration for Home Assistant that extends a Home Assistant instance with a set of extra tools, aimed at people who already run Home Assistant and want more capability without forking core components.

What it is

Spook is a Python custom integration for Home Assistant, distributed under the MIT licence and maintained primarily by Franck Nijhof, who set up the original repository. It loads into an existing Home Assistant installation as a custom component rather than as a replacement for anything in Home Assistant itself. The project describes itself as adding "a huge set of scary powerful tools" to the instance, and its full documentation lives at spook.boo rather than in the repository README.

The concrete problem it addresses is the gap between stock Home Assistant and the specific configuration or automation behaviour an operator wants. Instead of editing Home Assistant core, maintaining a fork, or writing bespoke scripts per instance, an operator installs one integration and gets those tools in place. Spook is explicit that it is not affiliated with, endorsed by, recommended by, or supported by the Home Assistant project, and that it is provided as-is without warranty. The repository is tagged across a wide set of Home Assistant topics, including home-assistant-config, home-assistant-configuration, home-assistant-custom, and home-assistant-integration, which reflects that positioning as a config and automation add-on.

Key capabilities

  • Ships as a Home Assistant custom integration under custom_components/spook, so it installs alongside a stock instance instead of replacing core components.
  • Distributed through the Home Assistant Community Store, indicated by the hacs-integration topic and the related home-assistant-custom and home-assistant-component tags.
  • Adds extra tooling to a running Home Assistant instance, described in the README as extending the instance with a large set of tools.
  • Handles localisation through Weblate, with translation files kept under custom_components/spook/translations/ and licensed CC0, separate from the MIT-licensed code.
  • Targets Home Assistant configuration work, matching the home-assistant-config and home-assistant-configuration topics.
  • Sits in the home automation space broadly, with home-automation and the playful home-destruction topics applied to the repository.
  • Maintains public documentation at spook.boo covering the integration's tooling beyond what the README shows.

Who uses it and how

  • Home Assistant operators who want additional tools without patching or forking Home Assistant core.
  • HACS users, since the integration is published as a HACS-installable custom integration rather than a core component.
  • Automation-focused setups, given the repository's Home Assistant automation, configuration, and custom-integration tags.
  • Translators without programming background, who contribute localisation through the hosted Weblate project.
  • Contributors following the separate guidelines at spook.boo/development, working alongside the original author and the wider contributor list.

Getting started

Install it as a Home Assistant custom integration, available through the Home Assistant Community Store, with the full setup and usage documentation at spook.boo.

How it compares

No list of paid products replaced by this project is provided, and the facts name no comparable tools, so on the evidence available Spook stands alone in this registry.

When to use it โ€” and when not to

Use it if you already run Home Assistant and want extra tooling as a custom integration rather than a core change. Do not pick it if you are outside Home Assistant, if you need vendor-backed support, or if you require an official Home Assistant component, since the project states plainly that it is not affiliated with, endorsed by, or supported by Home Assistant and ships as-is without warranty. Note the trade-offs: 29 open issues, repository text that is thin on detail compared with the external documentation, and localisation that the project itself admits is incomplete.

project readme (upstream, from github) โ€” read inline

Spook ๐Ÿ‘ป Your homie.

GitHub Release Project Stage License Project Maintenance Coverage OpenSSF Scorecard

Spook - Your homie

About

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.

Contributing

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.

Translating Spook

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!

Translation status

License

Copyright (c) 2023-2026 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 use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

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.

Frequently asked questions

Is spook free to use?

spook is open source under the MIT licence. There is no licence fee and no seat count โ€” you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does spook do?

A scary ๐Ÿ‘ป powerful toolbox ๐Ÿงฐ for Home Assistant ๐Ÿก

What is spook written in?

spook is primarily written in Python. Its source is publicly available at https://github.com/frenck/spook, and it has 1,761 GitHub stars.