Obsidian SuiteDocumentation
Obsidian Mail Client: all chapters

Docs / Obsidian Mail Client / Calendar, People & To Do

Calendar

Press Ctrl+2, or click Calendar on the rail, to see your calendars.

Which accounts have a calendar

  • Outlook.com and Microsoft 365 accounts: the first time you open the Calendar, click Connect Outlook calendar. Your browser opens; sign in and allow the app to read and change your calendar. Your events then sync with Outlook.com or Microsoft 365, both ways.
  • Exchange and Obsidian accounts: the calendar comes with the account. There's nothing to connect.
  • Gmail and other IMAP accounts have no calendar in the app.

The calendars appear in a list on the left. Clear a calendar's box to hide its events. Disconnect stops showing a Microsoft account's calendar here; nothing on the server changes, and connecting again brings it back.

Views and moving around

ToDo this
See one day, the work week, the week or the monthHome > Day, Work Week, Week or Month, or Ctrl+Alt+1 to Ctrl+Alt+4
Go to todayHome > Today, or Ctrl+T
Go back or forwardPrevious and Next, or Alt+Left and Alt+Right
Get the latest from the serverHome > Refresh, or F9
See calendars side by sideHome > Side by Side (or the button beside the views)
PrintHome > Print, or Ctrl+P

Calendars side by side

With two calendars or more ticked in the list on the left, Side by Side shows each one as a column of its own in Day, Work Week and Week, its name and colour on top. The columns scroll together, and dragging or double-clicking in one makes the event in that calendar. Click Side by Side again to see them all in one view. Month always shows them together.

Birthdays

The Birthdays calendar (under Other calendars in the list) shows the birthdays of the people in People on their day every year, with their age when the year is known. A birthday on February 29 shows on February 28 in other years. Untick it to hide them. Birthdays are changed in the contact, not in the calendar.

Time zones

File > Options > Calendar > Time zones can show a second time zone's hours beside your own in Day, Work Week and Week, each with a label of your choice (for example Home and London).

An event can have a time zone of its own: in the event window, choose it under Time zone and type the times as they are there (9:00 London time, say). The calendar still shows the event at your own time, and the server keeps it in that zone, so it stays at 9:00 London time when the clocks change.

Weather

File > Options > Calendar > Weather shows the forecast for today and the next two days beside the calendar's title. It is off until you turn it on and choose your place (type a city and click Find). The forecast comes from Open-Meteo, free and without an account: only the place is sent (the name you type while choosing it, then its map coordinates a few times a day), nothing about your mail or calendar. Choose Fahrenheit or Celsius there too.

Print

Home > Print (Ctrl+P) opens the calendar in a print window. Choose the Print style (Day, Work week, Week, Month or Agenda (list)), check the page, and click Print…. It prints from the day you are looking at, with the calendars you have ticked.

Make an event

  • Click New Event, or press Ctrl+N (also Ctrl+Shift+A).
  • In the Day, Work Week and Week views, drag over empty time to make an event there.

The event window has:

  • a title, the Calendar it goes in, Start and End (or All day), and the Time zone they are in,
  • Repeat: Doesn't repeat, Every day, Every weekday, Every week, Every month (same date), Every month (same weekday), Every year, or Custom… (every few weeks on chosen days, ending Never, On date or After a number of times),
  • Location and Attendees (addresses separated by commas),
  • Reminder, from At start time to 1 week before, or None,
  • Show as: Free, Tentative, Busy, Away or Working elsewhere,
  • Private, and a description.

While you pick a time, the window warns you when it overlaps something else in your calendar. Click Save to keep the event.

An online meeting shows Join online meeting.

Change or delete an event

  • In the Day, Work Week and Week views, drag an event to move it, or drag its bottom edge to make it longer or shorter. Times snap to 15 minutes.
  • Double-click an event to open it.
  • Right-click an event for Open, Show as, and Delete. For a meeting someone else organized, you can Accept, answer Tentative or Decline, or Decline and remove it.
  • Select an event and press Delete to delete it.

For a repeating event, the app asks whether you mean Just this one or The entire series.

Invitations in your mail

Meeting invitations show a card above the message with Accept, Tentative and Decline. Your answer goes to the organizer and the meeting shows in your calendar. See Reading mail.

Meetings

These tools are in the event editor of an event you organize, under Attendees.

  • Scheduling Assistant shows you, your attendees and your rooms on one day, with their busy times across your working hours (Busy, Tentative, Away, Working elsewhere, No information). The meeting's own time is outlined. Use the arrows to move to another day. Below the grid, Suggested times lists the best times in the next week: first the times when everyone is free, otherwise the times with the fewest conflicts. Click one to take it.
    • Other people's free/busy comes from a work or school Microsoft account or an Obsidian Mail Server. Personal Microsoft accounts (Outlook.com), Gmail and other IMAP accounts don't share it, so the grid says so and shows only your own calendar.
  • Add a room lists your organization's rooms. Pick one and it is invited as a room (a resource); it also becomes the location if that is empty. On an Obsidian Mail Server, type the start of the room's name. Remove a room with the x beside it.
  • Teams meeting: on a work or school Microsoft account, tick it and Microsoft adds the Teams link to the invitation.
  • Add online meeting: on other accounts, enter your own meeting room's link (a Zoom personal room, Jitsi, Google Meet...). It goes into the location (if empty) and the notes, and the app remembers it for your next meetings.

Propose a new time

On an invitation in your mail, click Propose new time. Choose the day and time, whether you answer Tentative or Decline, and add a note if you like. If your Microsoft calendar has the meeting, Microsoft sends the proposal; otherwise the organizer gets it by mail (an iCalendar proposal Outlook understands).

When someone proposes a new time for your meeting, the message shows the time they propose with Accept proposal and Decline proposal. Accepting moves the meeting and the attendees get the update. Declining tells them the meeting stays as it was. A proposal is only acted on when it comes from the attendee it names, for a meeting of yours they are invited to.

Reminders

When an event's reminder comes due, the Reminders window opens on top of your other windows. Use Open to see the event, Dismiss or Dismiss All, or choose a time under Remind me again in (5 minutes to 1 day) and click Snooze.

Reminders come from the app, so it needs to be running (the tray is enough).

Share your calendar and open others

With a Microsoft 365 (work or school) account:

  • Share your calendar: right-click it on the left and choose Share calendar. You see who it is shared with and how much they can see. You can change their level or remove them, and share with someone new at Outlook's levels: Can view when I'm busy, Can view titles and locations, Can view all details, Can edit or Delegate. Microsoft sends them an invitation.
  • Open someone's calendar: choose Open shared calendar under the account and type their address. Their calendar shows beside yours, read-only. Right-click it and choose Close this calendar to take it off the list. The first time, Microsoft asks you to allow the app to read calendars shared with you.

Outlook.com calendars are shared from outlook.com. Gmail, IMAP and ActiveSync accounts can't share calendars from this app.

Export a calendar

To save a calendar as an .ics file for another calendar app, see Importing and exporting.