Skip to main content

Logging completions

Home Keeper supports per-completion detail on a task. The default is a 1-tap Done. This is useful for a maintenance log of a task's cost and notes.

A completion can record:

  • a free-form note
  • a cost
  • a photo
  • who completed it, a Home Assistant person entity

A task sets its capture mode in the On completion field:

  • One-tap done is the default, with no dialog.
  • Ask for details (optional) opens a dialog with the completion fields, all optional. A Skip details button completes the task without them.
  • Require details opens the dialog and blocks Done until a user fills the required fields.

The dialog uploads a photo through Home Assistant's image store. The who field lists the person entities.

A completion photo records the work on one date. For a photo that stays on the task, such as the place that needs work, use task photos. When the task has one, its cover shows at the top of the dialog.

To add a photo to a one-tap task, select the arrow beside Done, then Done with photo or note…. See after photos.

The task's history shows each completion's:

  • note
  • cost
  • photo
  • who

A past entry can be edited there without a change to the schedule. The details of the most recent completion are also attributes of the task's next due sensor. The home_keeper.complete_task and home_keeper.update_completion services accept the same fields.

The dialog's Completed at field defaults to now. A user can set it to log a completion for the time the work happened. The date and time fields in the panel use the time zone of Home Assistant, not the time zone of the browser.

The next due date of a floating task is measured from the completion date, so the completion date moves the schedule. A completion that is older than the most recent one only adds an entry to the history. It does not move the due date.

Only a change to the most recent completion moves the due date. A delete or a move of an older entry keeps the due date, and also keeps a snooze or a skip. A delete of the most recent completion of a fixed task puts back the due date that the task had before that completion.

The move date button on a history row changes the date of that entry. The edit button changes the recorded details and not the date. The home_keeper.move_completion service performs the same move.

The move-date dialog on a history row, re-timestamping one completion without touching its note, cost, photo, or who

The capture dialog and the required gate apply only in the panel. A task completed from another surface completes immediately, with whatever metadata is passed:

  • the native to-do checkbox, which passes no metadata
  • the mobile app
  • the device mark-done button
  • a bare home_keeper.complete_task service call

The dashboard card sends a user to the panel to complete a required task, instead of completing it directly. An automation can pass note, cost, photo, and who to the home_keeper.complete_task service.

The completion-details dialog (note, cost, who and photo captured when a task is marked done)

Task history annotated with per-completion cost and notes, each row editable

Undo a one-tap Done​

After a one-tap Done in the panel, a message names the task. Select Undo in the message to remove that completion. The task then has its previous due date again.