Time Tools

Overview

Time Tools helps you run countdown timers (focus, workout, meditation, and more), track custom counters, and collaborate in Time Groups with live sync.

• Web: /time and /time-groups
• Android: Menu → Time Tools / Time Groups

Timer modes

Completing timers can award XP (focus and workout sessions need at least about 5 minutes for full rewards).

Counters

Create a named counter with a category and type:

• Taps — tap +1 to increment (each press adds one)
• Seconds — start/stop, then add elapsed time to the total

Optional target values grant XP when reached.

Time groups

1. Create a group and add members (like todo groups).
2. Start a shared countdown — choose who can pause/stop:
   • Only me (host)
   • Any group member
3. Use shared counters — everyone sees updates in real time.

Only one active group timer runs at a time per group.

API (developers)

Authenticated REST:

• GET /api/time-tools/presets — timer catalog
• GET|POST|PATCH /api/time-tools/timers — personal timers
• GET|POST /api/time-tools/counters — personal counters
• GET|POST /api/time-groups — groups
• POST /api/time-groups/:groupId/timers — group timer (controlMode required)

Socket.IO (group rooms): emit time_group:join with { groupId }; listen for time_timer:updated, time_timer:ended, time_counter:updated.