Open source · Home Assistant · v0.4.0

Task Wheel of Fortune

Who vacuums the living room today? The wheel decides: fairly, with a bit of fun and right inside Home Assistant. Whoever has done less lately or can take more load gets the bigger chance.

Task Wheel of Fortune: overview with assignments, next draw and points this month
Licence
MIT
Install
HACS
Home Assistant
2025.6 or later
Languages
DE · EN

Features

Share chores fairly, without arguing.

Fair by load

Whoever has had fewer points than their fair share in the period gets a bigger chance. The fair share depends on load capacity (full, half, paused) and on the days the person is around.

Eight animations

Wheel of fortune, lottery drum, slot machine, Plinko, spotlight, scratch cards, breaking news and an award ceremony. For the first five the size equals the chance; the others deliberately show none. For each schedule you pick the allowed variants, and with several one is picked at random each time.

  • Plinko
  • Rubbellose

People and absences

People are objects of their own, independent of Home Assistant users, with a colour, a load capacity and an optional notification. Absences apply once, on fixed weekdays, in a weekly rhythm or recurring, such as “every second Wednesday”.

Tasks with rules

Allowed people, points as effort, a deadline and a frequency: every round, at most n× per period or a fixed interval with tolerance. Plus a minimum load capacity and optionally an area from Home Assistant.

Schedules

Recurring, one-off or manual only, with a reminder if no draw happened for too long. Draws run automatically or in the panel with an animation; each person gets at most one task per round.

Swapping with a joker

Tasks can be swapped within a draw with people who are allowed to take them. “Stays undone” exists too: it counts like missed in points and statistics.

History and statistics

Every draw in the history with CSV export. The statistics show the fair share, completion rate, the task × person matrix and the draws per task against the target.

  • CSV

Deep in Home Assistant

Services (task_wheel.draw, complete, swap, set_absence), events for automations, sensors for open tasks and points, a to-do list per person (checking one off completes the task) and a button per schedule. Push messages go through any notify target.

  • Automationen

The draw

Eight ways to decide who is up.

Views

All in the sidebar of Home Assistant.

Overview, tasks, schedules, history and statistics, just as usable on a tablet and a phone as on a computer.

Edit a task: people, points, deadline, frequency and rules
A schedule with weekdays, tasks and animations
History of all draws
Statistics: fair share, completion rate, task × person

Installation

Set up in four steps.

Open in HACS ↗

  1. In HACS open the menu (⋮) → Custom repositories, add https://github.com/stacknoise/hass-task-wheel-of-fortune with the type Integration, or use the button above.
  2. Download “Task Wheel of Fortune” in HACS and restart Home Assistant.
  3. Settings → Devices & services → Add integration → Task Wheel of Fortune.
  4. Open “Task Wheel of Fortune” in the sidebar, create people, tasks and schedules and start the first round.
action: task_wheel.draw
data:
  schedule: weekly-plan

The integration is not yet in the default HACS list and is installed as a custom repository. All services, events and entities are documented in the README on GitHub. README on GitHub ↗

Built by Anton Graichen-Hartl.

Questions, ideas or a bug? An issue on GitHub helps, and so does an email.

Contact
stacknoise · terminal