The person integration in Home Assistant allows you to track the location of people in your household. It is a collection of device trackers that are grouped together to represent the current location of a person. Additionally, a person may have a user account attached to it, which allows the person to log in to the Home Assistant.
Spook adds some new services to the person integration, that allows you to dynamically change the device trackers attached to a person in Home Assistant.
Figure 1:Spook adds some new services to the person integration.
Devices & entities¶
Spook does not provide any new devices or entities for this integration.
Services¶
Spook adds the following new service to your Home Assistant instance:
Add a device tracker¶
Adds a device tracker to a person.
| Service properties | |
|---|---|
| Service | Person: Add a device tracker 👻 |
| Service name | person.add_device_tracker |
| Service targets | No |
| Service response | No response |
| Spook's influence | Newly added service |
| Developer tools | Try this service
 |
| Service call data | |||
|---|---|---|---|
| Attribute | Type | Required | Default / Example |
entity_id | string | Yes | person.frenck |
device_tracker | string | list of strings | Yes | device_tracker.iphone |
Example service call in YAML
1 2 3 4service: person.add_device_tracker data: entity_id: person.frenck device_tracker: device_tracker.iphone
To add multiple device trackers at once, use a list:
1 2 3 4 5 6service: person.add_device_tracker data: entity_id: person.frenck device_tracker: - device_tracker.iphone - device_tracker.ipad
Remove a device tracker¶
Removes a device tracker from a person.
| Service properties | |
|---|---|
| Service | Person: Remove a device tracker 👻 |
| Service name | person.remove_device_tracker |
| Service targets | No |
| Service response | No response |
| Spook's influence | Newly added service |
| Developer tools | Try this service
|
| Service call data | |||
|---|---|---|---|
| Attribute | Type | Required | Default / Example |
entity_id | string | Yes | person.frenck |
device_tracker | string | list of strings | Yes | device_tracker.iphone |
Example service call in YAML
1 2 3 4service: person.remove_device_tracker data: entity_id: person.frenck device_tracker: device_tracker.iphone
To remove multiple device trackers at once, use a list:
1 2 3 4 5 6service: person.remove_device_tracker data: entity_id: person.frenck device_tracker: - device_tracker.iphone - device_tracker.ipad
Repairs¶
Spook has no repair detections for this integration.
Uses cases¶
Some use cases for the enhancements Spook provides for this integration:
- Adding/removing temporary device trackers that represent a location of a person. For example, if you have a tracker in a car, you could temporary attach it to a person if you know that person took that car.
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.