How to use Whisp

1. Every N units

Use this for: regular habits and recurring tasks where the cadence is "every X minutes/hours/days/weeks/months".

• Every 30 minutes — drink water, micro-breaks. Time-of-day is ignored; it just keeps stepping.
• Every 4 hours — medication timing.
• Every 3 days at 09:00 — alternate-day routines.
• Every 2 weeks at 18:00 — fortnightly check-ins.
• Every 1 month — monthly review.

Start from (optional) — anchors the cycle to a specific date, including in the past. Use this when "every 2 weeks" needs to land on a specific day. Example: bin night every fortnight, anchor on the next collection date.

Sub-day intervals (minutes/hours) ignore the time-of-day picker and the Start-from anchor — they just step from now.

2. Specific days of week

Use this for: reminders that should fire on chosen weekdays at a specific time.

• Mon, Wed, Fri at 07:00 — gym days.
• Sat, Sun at 10:00 — weekend ritual.
• Mon-Fri at 09:00 — workday standup.

A time-of-day is required — pick Fixed, Random, or a Random Window.

3. One-off (date + time)

Use this for: a single fire — appointments, deadlines, "remind me on X day".

• Appointment, follow-up call, expiration date.
• Pick the date and time directly. Both are interpreted in your timezone.

4. Cron expression

Use this for: patterns the other types can't express. Standard 5-field cron — minute, hour, day-of-month, month, day-of-week.

• 0 9 * * * — 09:00 every day.
• 0 9 1 * * — 09:00 on the 1st of every month.
• 30 18 * * 5 — 18:30 every Friday.
• 0 8,12,18 * * * — 08:00, 12:00, and 18:00 every day.

Evaluated in your timezone. If you're not familiar with cron, use one of the other types instead.

Time of day

For weekly schedules and day/week/month intervals, you choose how the time of fire is decided:

• Fixed — same time every fire (e.g. 09:00).
• Random — anywhere in the 24-hour day. Useful for "don't make this a habit-time".
• Random window — random within an interval (e.g. 09:00–18:00). Good for "during work hours".

Note field

An optional longer body shown when the reminder fires — dosage, instructions, links, anything you don't want in the title. Markdown special characters are escaped before sending to Telegram.

Pause / Resume / Delete

Pause stops a reminder from firing without losing it. Resume re-computes the next fire from now. Delete is permanent.