-
Notifications
You must be signed in to change notification settings - Fork 2
Home
Welcome to the TaskMate documentation. TaskMate is a Home Assistant integration that turns household chores into a gamified reward system for children.
| Topic | Description |
|---|---|
| Installation | How to install via HACS or manually |
| Getting Started | First-time setup walkthrough |
| Admin Panel | Web-based management dashboard in the HA sidebar |
| Children | Managing children and avatars |
| Chores | Creating and configuring chores |
| Chore Scheduling | Specific days, recurring, and one-shot modes |
| Timed Tasks | Duration-based chores with start/pause/stop timers |
| Task Groups | Coordinate rotation chores with sticky or spread policies |
| Bonus Subtasks | Optional extra-credit tasks within a chore |
| Rewards | Fixed costs, jackpots, and claim flow |
| Pool Mode (Savings Jars) | Dedicated savings pools for long-term reward goals |
| Bonus Points | Weekend multiplier, streaks, perfect week |
| Bonuses | Reusable point awards for positive behaviour |
| Penalties | Named point deductions for unwanted behaviour |
| Achievement Badges | Milestone badges with tiers, custom criteria, and point bonuses |
| Notifications | Built-in alerts, custom scheduled notifications, actionable mobile callbacks, and bus events |
| Dynamic Chore Visibility | Show/hide chores based on HA entity state |
| Settings | All configurable settings in one place |
| Dashboard Cards | All 17 Lovelace cards |
| Services | All callable services with examples |
| Sensor Reference | All entities and their attributes |
| Automations | Internal tasks, example automations, and templates |
| Localization | Supported languages and translation |
| Troubleshooting | Common issues and fixes |
| FAQ | Frequently asked questions |
Child completes chore → Parent approves (optional) → Points awarded
↓
Child claims reward
↓
Parent approves claim
↓
Reward granted
All data is stored locally in Home Assistant. Nothing is sent to external services.
Points — The currency children earn by completing chores. You choose the name (Stars, Coins, Bucks) and icon during setup.
Chores — Tasks assigned to one or more children. Can require parent approval before points are awarded.
Rewards — Goals children save up for. You set a fixed point cost — children work toward it at their own pace.
Streaks — How many consecutive days a child has completed at least one chore. Bonus points are awarded at configurable milestones.
Jackpot Rewards — Special rewards where all assigned children's points pool together toward a shared goal.
Timed Tasks — Chores where points are earned based on duration. Children start, pause, and stop a timer; points are calculated from elapsed time.
Task Groups — Coordinate related rotation-mode chores so they're assigned to the same child (sticky) or spread across different children (spread).
Achievement Badges — Milestone-based recognition with four tiers (Bronze, Silver, Gold, Platinum). 15 built-in badges plus custom badges with multi-criterion rules.
Bonus Subtasks — Optional extra-credit tasks within a chore that unlock after the parent chore is completed.
Current: 3.9.3
Requires: Home Assistant 2024.1+
License: MIT