Skip to content

Settings

Jump to bottom
tempus2016 edited this page May 4, 2026 · 2 revisions

All TaskMate settings are configured via Settings → Integrations → TaskMate → Configure → Settings.

Settings Reference

Setting Default Range Description
Points Currency Name Stars — Display name for the points currency (Stars, Coins, Bucks, Tokens, etc.). Shown on all cards and notifications.
Points Currency Icon mdi:star Any MDI icon Icon shown next to point values throughout the UI.
Weekend Points Multiplier 2.0 1.0–5.0 Multiplier applied to chore points on Saturday and Sunday. Set 1.0 to disable. Formula: weekend_bonus = round(base_points × (multiplier − 1.0)). The bonus is logged as a separate transaction.
Streak Reset Mode reset reset / pause What happens when a child misses a day. Reset: streak goes back to 0. Pause: streak freezes and resumes on the next completion.
Streak Milestone Bonuses on on / off Master toggle for streak milestone point bonuses.
Streak Milestone Configuration 3:5, 7:10, 14:20, 30:50, 60:100, 100:200 days:points CSV Custom milestone thresholds. Each entry awards bonus points when the child's streak reaches that day count. Milestones reset when the streak resets, so they can be re-earned.
Perfect Week Bonus on on / off Award bonus points when a child completes at least one chore every day Mon–Sun. Checked Monday at midnight.
Perfect Week Bonus Points 50 10–500 Points awarded per perfect week.
Notification Service (empty) Any notify.* service Optional HA notify service for push notifications on pending chore approvals and reward claims. e.g. notify.mobile_app_johns_phone. Leave empty to use persistent notifications only. See Notifications.
Calendar Projection Days 14 1–90 How many days ahead chore assignments are published to configured HA calendar entities. Higher values give more planning visibility but create more calendar entries. See Calendar Integration.
History Days to Keep 90 30–365 Number of days of completion history to retain. Older records are pruned daily at 00:01.

Time-of-Day Boundaries (v3.6.0+)

These settings control the time windows used for morning, afternoon, evening, and night chores when publishing to HA calendar entities. Configurable via the Admin Panel.

Setting Default Format Description
Morning Start 06:00 HH:MM Start of the morning time window
Morning End 12:00 HH:MM End of the morning time window
Afternoon Start 12:00 HH:MM Start of the afternoon time window
Afternoon End 17:00 HH:MM End of the afternoon time window
Evening Start 17:00 HH:MM Start of the evening time window
Evening End 21:00 HH:MM End of the evening time window
Night Start 21:00 HH:MM Start of the night time window
Night End 23:59 HH:MM End of the night time window

Invalid values fall back to the defaults. anytime chores are published as all-day calendar events.

Where Settings Apply

  • Currency name and icon — shown on all cards, sensors, and notifications
  • Weekend multiplier — applied automatically when approve_chore runs on a Saturday or Sunday
  • Streak settings — checked at midnight (00:00:05) daily; milestones checked on each chore approval
  • Perfect week — checked Monday at midnight for the previous Mon–Sun period
  • Notification service — fires on every pending chore approval and pending reward claim
  • Calendar projection — recalculated at midnight and whenever a chore is created or edited
  • History pruning — runs daily at 00:01
  • Time-of-day boundaries — affect calendar event windows when publishing chore assignments

Related

Clone this wiki locally