# Task Wheel of Fortune

> Open source integration for Home Assistant: distributes household chores fairly by a draw with eight animations, respects absences and capacity, with schedules, history and statistics. Installable via HACS.

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.

## Key facts

- Licence: MIT
- Install: HACS
- Home Assistant: 2025.6 or later
- Languages: DE · EN
- Version: 0.4.0
- Source code: https://github.com/stacknoise/hass-task-wheel-of-fortune

## 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.

Tags: 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.

Tags: 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.

Tags: Automationen

## The draw

Eight ways to decide who is up.

- Wheel of fortune
- Lottery drum
- Slot machine
- Plinko
- Spotlight
- Scratch cards: scratch by hand until “Winner!” shows up
- Breaking news
- Award ceremony: “And the task goes to …”

## 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 ↗](https://my.home-assistant.io/redirect/hacs_repository/?owner=stacknoise&repository=hass-task-wheel-of-fortune&category=integration)

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.

Example (YAML):

```yaml
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.

## Contact

- Developer: Anton Graichen-Hartl, Stacknoise (https://www.stacknoise.com/en/)
- E-Mail: anton.hartl@stacknoise.com
- GitHub: https://github.com/stacknoise
- Web page: https://www.stacknoise.com/en/task-wheel/
- Deutsche Version: https://www.stacknoise.com/task-wheel.md