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 actions to the person integration, that allows you to dynamically change the device trackers attached to a person in Home Assistant.
Devices & entities¶
Spook does not provide any new devices or entities for this integration.
Actions¶
Spook adds the following new actions to your Home Assistant instance:
Add a device tracker¶
Adds a device tracker to a person.
Action properties | |
---|---|
Action | Person: Add a device tracker 👻 |
Action name | person.add_device_tracker |
Action targets | No |
Action response | No response |
Spook's influence | Newly added action |
Developer tools | Try this action |
Action data parameters | |||
---|---|---|---|
Attribute | Type | Required | Default / Example |
entity_id | string | Yes | person.frenck |
device_tracker | string | list of strings | Yes | device_tracker.iphone |
1 2 3 4
action: 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 6
action: 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.
Action properties | |
---|---|
Action | Person: Remove a device tracker 👻 |
Action name | person.remove_device_tracker |
Action targets | No |
Action response | No response |
Spook's influence | Newly added action |
Developer tools | Try this action |
Action data parameters | |||
---|---|---|---|
Attribute | Type | Required | Default / Example |
entity_id | string | Yes | person.frenck |
device_tracker | string | list of strings | Yes | device_tracker.iphone |
1 2 3 4
action: 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 6
action: 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 action, 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.