Dates, reminders and repeats
A to-do can have a day you plan to start it, a deadline, a reminder and a repeat rule. All four are optional.
When and deadline
Photos are in the blue folder.
- Photos
- Fill in the form
- When is the day you plan to work on it. The to-do waits in Upcoming and appears in Today on that day.
- Deadline is the day it has to be finished. The row shows how many days are left, and it appears in Today when it is due.
Open a to-do and choose When or Deadline. Pick Today, This Evening, Tomorrow, Anytime or Someday, or choose Pick a Date… for the calendar.
Type a date in plain words
In the When and Deadline controls you can type instead of picking. Matches appear as you type, and Return chooses the first one.
today, tomorrow, tom | Today or tomorrow |
|---|---|
tonight, evening | Today, under This Evening |
fri, friday | The next Friday |
in 3 days, next week, weekend | Counted from today |
nov 22, 22 nov | That date |
anytime, someday | No date |
In the terminal, --when takes today, tomorrow, anytime, someday, inbox or a date written 2026-12-01.
Reminders
Open a to-do, choose Reminder, set a date and time, and choose Set Reminder. The row shows a bell with the time. To clear it, open the reminder again and choose Remove.
- iPhoneMac You get a notification at that time. Bluma asks for permission the first time you set a reminder. Tapping the notification opens the to-do.
- Web The browser can only notify you while Bluma is open in a tab.
A reminder keeps its clock time when you travel: 9:00 stays 9:00 in the new time zone.
bluma add "Take out the bins" -w today --evening --remind "today 19:30"
Repeating to-dos
- Open a to-do and choose Repeat.
- Choose how often: every so many days, weeks, months or years.
- Choose what it counts from. Due date keeps a fixed rhythm, like rent on the 1st. Completion counts from the day you finish, like a haircut every six weeks.
- Choose Set Repeat. The row shows a repeat mark.
When you complete a repeating to-do, the next one is created on its next date with the same notes, tags and checklist, and its deadline and reminder moved along. Canceling a repeating to-do ends the repeat. To stop one, open Repeat and choose Never.
bluma edit 3fk --repeat "every 2 weeks"
bluma edit 3fk --repeat "every 3 days after completion"
bluma edit 3fk --repeat none
Calendar events in Today and Upcoming
iPhoneMac Turn on Show Calendar Events in Settings and allow access. Your events for the day appear at the top of Today and under each day in Upcoming. They are read on the device and never sent to Bluma.
Still stuck?
Email support@bluma.sh and a person will answer. Say what you were doing and which app you were in. For a security problem, write to security@bluma.sh.