Repository navigation
v7.3.0
TaskMate 7.3
The biggest release yet. The admin panel has a new layout: a section rail with page tabs along the top, and editors that open beside the page instead of over it. A library of about 200 chores and 45 rewards gets a family going in minutes. Chores can come up at set times of day (wash hands at breakfast, lunch and dinner). Then there's a long list from the ideas board: a screen-time bank, bin-day chores, shopping-list jobs, per-chore streaks, a completion heatmap, sibling checks, penalty warnings, praise notes, points expiry, reward gifts, seasonal themes and more. The kiosk gets the avatar picker and badges, the Parent Dashboard gets quality ratings, and the kiosk freeze on old iPads is fixed.
Minimum Home Assistant is still 2024.7.0. Nothing needs migrating. Every new feature that changes how points or chores behave stays off until you switch it on. There are now 32 dashboard cards, and every new string is translated into all 11 languages.
⚠️ Before you upgrade
Nothing needs migrating. These appear without any setup:
- The admin panel looks different. The old grouped sidebar is now a rail of seven sections (Today, Family, Earn, Spend, Points, Review, Settings), and each section's pages are tabs along the top. Settings, Notifications and Help & feedback are under the gear. Every page is still there; see Admin Panel → Navigation.
- The kiosk child screen shows a Badges tile, and a child can tap their face to change avatar. Turn them off with
show_badges: false/allow_avatar_change: false. - The child card gains a Today / Tomorrow switch (
show_tomorrow: falsehides it), 🔥 N days streaks on chores done several due days in a row, and the next reward with "At your pace you'll have it on…". - Deleted chores, rewards and quests wait 7 days in Settings → Recently deleted before they're gone for good.
🧭 New admin panel layout (PR #1121)
- Section rail and page tabs. The 22-page sidebar becomes six sections plus Settings, each with its pages as tabs across the top. A section reopens on the page you last used in it. Only Today shows a count on the rail, so nothing waiting on you is counted twice.
- Editors open beside the page. Every editor for a single item (child, chore, reward, penalty, bonus, raffle, group, quest, challenge, bounty, auction, badge) is a side panel. On screens 1100px and wider the page moves over and stays usable, so you can click from one item to the next; the item being edited is highlighted. Opening another item or page with unsaved changes asks first.
- Phones: the bottom bar holds Today, Family, Earn, Spend and More. Editors still fill the screen.
- Needs you filters: when more than one kind of thing is waiting, chips (Chores, Rewards, Swaps, Wishes) filter the list.
- Reward progress per child: each ordinary reward's card shows how close every child is, with a tick for who can get it now.
- Streaks on the Family page: each child's card shows their streak.
- Docs: Admin Panel
📚 Chore & reward library (PR #1118, #1122)
- Admin panel → Chores (or Rewards) → 📚 Library. 199 chores in 12 categories, 45 rewards, and the six built-in template packs, all translated.
- Filtered by age: pick the children you're choosing for (or Everyone) and the library shows what suits them, from their birthday or their setup-wizard age group. Adults and guests never appear.
- Search, Hide ones we already have, a category rail with counts, and age badges on every chore.
- Customise a chore before adding it (name, points or cost, time of day, days), and choose who it's for. The children it suits are ticked already. Add creates everything in one go and skips what you already have.
- Packs: ticking a pack selects all its chores, skipping the ones you have.
- Birthdays: the birthday nudge's See chore ideas opens the library on the chores that newly suit the child.
- Setup wizard: the chores and rewards steps have a Browse the whole library link.
- The library's 15 min extra screen time reward adds 15 minutes to the screen-time bank when the bank is on, and is an ordinary reward when it isn't.
- Rewards stay fixed-cost. Chores and rewards remember the library entry they came from (kept through backup and restore), so Added survives a rename.
- New admin-only WebSocket command
taskmate/library/add, logged in the audit log. - Docs: Chore & Reward Library
⏰ Chores at set times (PR #1119, #1122)
- Chore editor → When → How often in a day → At set times. Up to 5 times a day, each with a name, a window and its own points. Presets: breakfast · lunch · dinner, morning & evening, 8am · 2pm · 8pm, pet breakfast & tea.
- Each time is ticked off on its own, only while it's open (plus the chore's claim allowance). Parents can tick any time that isn't done.
- For the day the chore counts once, when every time is done: that's what moves streaks, the weekly target and the weekly card. An optional all-times bonus is paid once a day.
- Approvals, undo and reject work per time, and everything reads Wash hands (Lunch).
- Mandatory chores owe a miss for each time that closes undone.
- Editing the times mid-day keeps today's ticks.
- On the cards: the child card and kiosk show one row per time or one row with a pill per time. Set the family default in Settings → Chores with set times, or per card with
set_times_layout: family | rows | pills. - Services:
taskmate.complete_choretakestime_id(leave it out for the time open now).taskmate.add_choretakestimesandtimes_bonus. - Docs: Chores at Set Times
📺 Screen-time bank (PR #1120)
- A reward can carry screen minutes: approving it adds them to the child's balance.
- Devices: give each child the switches, media players, input booleans, binary sensors, remotes or lights that count as screen time. While any is on, a minute is spent every minute. Optionally turn them off at zero.
- Daily allowance: free minutes each school day and each weekend or holiday day. The allowance is spent first, then the bank; unused allowance expires or carries over.
- Weekend jar: a child saves unused minutes (up to a cap) with Save on their card, and the jar empties into the bank at the opening time (Saturday 08:00 by default).
- Low-balance and run-out notifications and events. The child card's screen-time strip works in every design.
- Services:
taskmate.adjust_screen_time,taskmate.save_screen_time. - Docs: Screen-Time Bank
🗑️ Bin-day chores (PR #1120)
- Settings → Bin-day chores. The evening before a collection, TaskMate reads your bin calendars (Waste Collection Schedule, an iCal feed, or a local calendar) and adds "♻️ Put the Recycling out" for each bin. First to do it, or taking turns. Optionally adds "Bring the Recycling in" on the day.
- Event:
taskmate_bin_day. - Docs: Bin-Day Chores
🛒 Shopping-list jobs (PR #1120)
- Add "#tm fetch logs from the shed" to a to-do list (or say it to Assist) and a couple of minutes later the children see 🛒 Fetch logs from the shed. When it's done and approved, TaskMate ticks the item off. An item ticked off first removes the job.
- Event:
taskmate_shopping_job. - Docs: Shopping-List Jobs
✅ Chore extras (PR #1120)
- Per-chore streaks: 🔥 12 days on a chore done on every due day in a row. Each chore follows its own schedule, so holidays, sick days and a sibling's turn don't break it. Docs
- Sibling checks: an older child checks a younger one's chore for a small bonus. Looks done approves it; Not yet leaves it for a parent with a note. Service
taskmate.sibling_check. Docs - Praise notes: approve with a short message, signed with your name, that the child sees on their card. Offered in the panel's approval queue and the approvals card. Docs
- Tomorrow preview: a Today / Tomorrow switch on the child card. Docs
- Child-chosen reminders: a child picks when to be reminded about a chore, within limits you set. Service
taskmate.set_chore_reminder. Docs - Penalty warnings: a penalty can warn first and only deduct the second time, resetting daily or weekly. Event
taskmate_penalty_warning. Docs
🎁 Reward extras (PR #1120)
- Points expiry (off by default): points not spent within a set number of days expire, oldest first, with a warning on the child's card. Docs
- Per-child limits: N claims per day, week or month. The rewards card shows Again on .
- Printable vouchers for owed and claimed rewards.
- Rate the reward: children give 1–3 stars after hand-over (
taskmate.rate_reward). The Rewards page shows a ratings table, with "never claimed · retire?". - Savings forecast: "At your pace you'll have it on…" on the child card.
- Reward pictures: upload a picture for a reward; it's shown on the rewards card and the child card.
- Gifts: one child can buy a reward for another (
recipient_idontaskmate.claim_reward). - Reward order: drag rewards into your own order on the Rewards page (or use Reorder on a touchscreen); the rewards card follows it.
- Docs: Reward Extras
🛠️ Panel tools (PR #1120)
- Recently deleted: deleted chores, rewards and quests are kept for 7 days. Undo on the delete message, and Restore in Settings → Recently deleted. Docs
- Settings search: a jump list of section names, every section findable with Ctrl K, and an unsaved-changes bar that asks before you leave.
- Child quick view: tap a child's face in the top bar for their points, level, streak, screen time, what's waiting and today's chores.
- View as child: the child's real card inside the panel, in any design.
- Insights → Economy: points earned against points spent over 8 weeks, with a warning when rewards have got too cheap.
- Insights → Calendar: a completion heatmap per child, also available as the new Heatmap card. Docs
🎨 Card looks (PR #1120)
- Compact child card:
density: compactgives one line per chore, in every design. - Seasonal themes (off by default): Halloween, Christmas and Summer dress the child and kiosk cards with a gradient header and a season emoji. Switch them on in Settings → Seasonal themes;
seasonal: falsekeeps a card plain. - The child's colour now tints their child card header, progress bars and confetti, and their kiosk screen (unless the card sets
header_color). - A done animation per child: confetti, stamp, fireworks or sticker, picked in the child's editor. Reduced motion plays nothing.
- Dark mode: the care strips have dark variants.
- Docs: Card Looks
🖥️ Kiosk: avatars and badges (PR #1117, closes #1112)
- The kiosk child screen has the child card's avatar picker: tap the face to switch between unlocked avatars.
- A Badges tile in the side column shows earned badges and the progress towards the closest next one.
- New options
show_badgesandallow_avatar_change, both on by default. - Docs: Kiosk Mode
⭐ Parent Dashboard: quality ratings (PR #1116, closes #1114)
- The Parent Dashboard's Approvals tab has the same 1–3 star picker as the approvals card, in every card design, while quality ratings are switched on. Pick the stars, then tap the tick. Tap the picked star again to clear it.
- Docs: Quality Ratings
🐛 Fixes
- Kiosk froze on old iPads once a pet was still an egg (iOS 15 Safari). The egg is now drawn without a clip path and looks the same. (PR #1115, fixes #1113)
- Recurring boosts: a failed save or delete said "saved" and closed the dialog, and Test wake now always reported 0 screens. (PR #1120)
- Child card: record confetti replayed on every update when the browser blocks storage. (PR #1120)
- Cards: badge tracking crashed on a cold load before the card had its data. (PR #1120)
- Cards: the Today/Tomorrow switch and heatmap squares lost their colours on the Classic design, and empty heatmap days glared light grey in dark mode. (PR #1120)
- Panel: the delete prompt for chores, rewards and quests no longer says it can't be undone; the quick view no longer repeats the child's name; Economy week labels follow Home Assistant's language. (PR #1120)
- Child card: the avatar's edit pencil stays small on a compact card. (PR #1120)
- Shopping jobs: a job retired because its item left the list isn't put in Recently deleted. (PR #1120)
- Rewards: a deleted reward keeps its picture until Recently deleted lets it go. (PR #1120)