MultiWeek uses your macOS system calendars. To add a new calendar:

1. Open System Settings > Internet Accounts (or Calendar.app > Settings > Accounts)

2. Add your account (iCloud, Google, Exchange, etc.)

3. Enable the Calendar checkbox for that account

4. Open MultiWeek — it will request calendar access if not already granted

5. Go to Settings > Calendars tab to toggle visibility of individual calendars

MultiWeek automatically discovers all calendars configured in macOS. You cannot add calendars inside MultiWeek itself.

In the Calendars selector above the grid you can select which calendars you want to show at the time.

Click the grid preset selector in the settings on General tab (shows e.g. "3 x 2"). Choose from 15 presets:

1x1 Focused single week

2x1 This week + next

2x2 Monthly overview (4 weeks)

3x2 Six-week planning (default)

4x3 Quarterly view

5x4 20-week strategic view

Switching presets preserves all your data and settings.

Best and easiest way to change font size is from the toolbar where it says e.g., 0.80x. Just click that button and choose your preferred font size for the events text.

Settings > Date & Time tab:

Clock format 12-hour, 24-hour, or System (follows macOS)

Date format DMY compact (1.3.), DMY padded (01.03.), MDY compact (3/1), ISO 8601 (2026-03-01)

Week start Monday (European), Sunday (US), or System

Use the regional presets (System / European / US) at the bottom of Settings to configure all of these at once.

Settings > Date & Time tab:

- Week start day: Monday, Sunday, or System

- Week display style: European (Mon-Sun) or US (Sun-Sat) or System

- Week numbers follow ISO 8601 standard

The "Reset to Default" button offers presets: System (follows OS), European (Mon start, 24h, DMY, Celsius), or US (Sun start, 12h, MDY, Fahrenheit).

Settings > General > Language — choose from 25 languages: English, Finnish, Swedish, Spanish, German, French, Italian, Portuguese, Dutch, Polish, Ukrainian, Turkish, Romanian, Greek, Czech, Hungarian, Bulgarian, Norwegian, Danish, Chinese (Simplified), Hindi, Arabic, Bengali, Japanese, or System (auto-detect from macOS).

The change takes effect immediately.

Settings > General > Color Scheme — choose:

- Follow OS — matches your macOS appearance setting

- Light — always light theme

- Dark — always dark theme

Many color settings (highlights, grid, daylight) have separate values for light and dark mode.

MultiWeek keyboard shortcuts:

• ⌘T — Go to today

• ⌘F — Toggle search

• Escape — Cancel (dialog/editor/searching)

• Enter/Return — Save (editor/dialog)

• ⌘Q — Quit app

1. Click the Rules button in the toolbar (or Settings > Rules)

2. Click Add Rule

3. Configure:

- Field — what to match: Title, Location, Notes, Sender domain, Attendee domain, Has meeting link, Created by me, etc. (13 fields available)

- Operator — how to match: contains, is, is not, in list, has any outside list, is empty, etc. (12 operators)

- Value — the text or domain to match against

- Color — pick a highlight color from the 14-color palette

4. Enable the rule with the toggle

5. Add multiple conditions per rule (AND logic)

Quick start: Use built-in presets like "External invited me" for instant setup.

When multiple rules match the same event, colors blend automatically (up to 3 colors). Text color adjusts automatically for readability.

Hover over any event — a popover appears after a short delay (default 120 ms) showing:

- Title, time, and calendar

- Organizer and attendees

- Location and notes

- Meeting links (Teams, Zoom, Google Meet, Webex)

Adjust in Settings > General:

Popup Open Delay 0-800 ms

Popup Scroll Speed 1.0x-6.0x

Hide Invitation Metadata removes technical data from invites

Show Event Info Popover enable/disable entirely

Settings > Highlights tab — all colors have separate light/dark mode values:

Today highlight Background shading of today's column

Current time indicator Horizontal line at current time

Current week highlight Accent on current week's header

Hover fill color Fill when hovering over an event

Hover fill opacity Opacity of hover fill

Hover border color Border when hovering over an event

Hover border opacity Opacity of hover border

Search border color Border on matching events during search

Search fill color Fill on matching events during search

Search fill opacity Opacity of search fill

Grid background color Background of the week grid cells

Grid line color Color of hourly grid lines

Daylight background color Tint of the daylight gradient

Sunrise marker color Color of sunrise indicator line

Sunset marker color Color of sunset indicator line

Use "Sync to Theme Palette" to automatically adjust all colors to match your selected calendar color palette.

- Double-click an event to open the editor, or right-click > Edit

- The editor allows changing: title, start/end time, all-day toggle, calendar, location, notes, recurrence (daily/weekly/monthly/yearly), time zone, reminders, and availability status

- For recurring events, you can choose to edit: this event only, this and future events, or all events in the series

- Click Save to apply changes, or Cancel to discard

Moving:

1. If drag mode is locked, click the lock icon in the toolbar to unlock (auto-relocks after your chosen timeout: 10s/20s/30s/60s)

2. Click and hold the event

3. Drag it to the new day/time slot

4. Release — the event is moved immediately

Copying:

- Hold Cmd or Option while dragging to copy instead of move

Configure drag behavior in Settings > General > Event Dragging: Disabled, Unlock for 10/20/30/60 seconds, or Always enabled.

1. Settings > Date & Time > Weather section

2. Enable Show Weather Forecast

3. Enter your Country and City

4. Choose Temperature Unit: Celsius or Fahrenheit

5. Click Confirm Location to verify geocoding

Weather icons and min/max temperatures appear on each day's header. Forecasts cover up to 16 days and update every 45 minutes. Data from Open-Meteo (free, no account needed).

Settings > Date & Time > enable Show Moon Phases

Moon phase icons appear on the calendar showing all 8 phases: New Moon, Waxing Crescent, First Quarter, Waxing Gibbous, Full Moon, Waning Gibbous, Last Quarter, and Waning Crescent.

1. Settings > Highlights > Daylight Background section

2. Enable Daylight Background — requires a confirmed weather location

3. Optionally enable Sunrise/Sunset Markers for horizontal lines at sunrise and sunset times

4. Adjust Tint Strength and marker colors/opacities separately for light and dark mode

The background shows a gradient from dark (night) through twilight to bright (midday) based on solar elevation calculations for your location.

ICS Export:

1. Right-click an event > Share as ICS…

2. Choose scope: This event only or Entire series (for recurring events)

3. Choose delivery: Email or among macOS’s share destinations

4. The recipient gets a standard .ics file compatible with most calendar apps

Outlook Integration:

‍ ‍- In the calendar even editor click Open Outlook (today) to see today’s events in the Outlook’s user interface.

‍ ‍- When creating a new event and invites to others are needed, fill in the basic information such as Title, Start and End and then click Continue in Outlook to switch to Outlook and add recipients and other advanced Exchange related settings for the event.

‍ ‍- You can right-click on the calendar grid and choose New Event (Outlook) directly instead of just New Event if you know that you need to add invited recipients.

It is possible to change created events in the Outlook afterwards. For example if you do multi-week planning for the project - create all the required events in the big grid using MultiWeek and then send the invites week by week in Outlook.

- Requires an Exchange/Outlook calendar source

- Enable/disable Outlook integration in Settings

NOTE: Received invites are shown as read-only in MultiWeek. You can open today’s date in Outlook with one click from MultiWeek.

RSVP invites (= Exchange events with recipients requested to respond) can only be created by switching to Outlook via integration - with one click from Multiweek. Creating invites directly from MultiWeek is not currently supported due to integration interface limitations.

- Calendar sources: MultiWeek reads calendars from macOS. You must add accounts in System Settings first. Calendar providers not supported by macOS (e.g. some proprietary systems) are not available.

- Weather forecast range: Up to 16 days. Beyond that, no forecast is shown.

- Daylight/Moon features: Require a confirmed weather location to be configured.

- Drag-and-drop: Not available for read-only calendars or calendars with limited access permissions.

- Recurring event editing: Scope choices (this event / future / all) depend on what the calendar source supports. Some providers may not support all options.

- Search: Searches visible text fields (title, location, notes). Does not search attendee names or email addresses.

- ICS export: Generates standard .ics files. Complex Exchange-specific features (e.g., Teams meeting metadata) may not be preserved.

- Outlook integration has limited functionality due to the technical features of Outlook deeplinks that cannot carry all the date. For example opening an event directly in Outlook is not supported by Outlook, the workaround is opening today’s date.

- Event creation: Requires Full Calendar Access permission. With read-only access, events cannot be created or edited.

- Grid size: Maximum 5x4 (20 weeks). Larger grids may impact performance depending on the number of calendars and events.