Area: Calendar
Path: /calendar
Icon: Calendar icon in the sidebar
Overview
The Calendar area shows events from connected providers (Microsoft Outlook, Nextcloud CalDAV, Open-Xchange). Provider badges indicate the source of each event.
Layout
| Element | Description |
|---|---|
| View switcher | Day, Week, Month, Agenda |
| Date navigation | Back/Forward, Today, date picker |
| Timeline / grid | Events by time and date |
| Agenda | List view of events |
Main Features
Create Event
- Click "+" or double-click on time slot
- New Event dialog opens
- Enter title, date/time, location, attendees, description, recurrence
- Choose provider when multiple calendars connected
- Save
Edit Event
- Click event → detail view → "Edit"
- Changes sync to connected provider
Recurring Events
- Daily, weekly, monthly, yearly
- End date or number of occurrences
- Edit single instances from series (optional)
Scheduling Assistant
- For events with attendees: View availability
- See free/busy time slots
- Choose optimal slot
- Requirement: Attendee calendars must be queryable (e.g. Microsoft)
Online Meeting
- Store video conference link in event
- Integration with meeting system (depends on setup)
- Sparks meeting: Additional meeting options (access, lobby, chat/polls/Q&A, recording, captions, language, transcripts) – see Event and meeting options
View Details
| View | Use |
|---|---|
| Day | Single day, hourly slots; detailed planning |
| Week | Weekdays side by side; week overview |
| Month | Month overview; compact events |
| Agenda | Chronological list; all events listed |
Details: Calendar Views
Data Backends (Providers)
The calendar supports multiple providers in parallel. Events are merged; a badge on the event shows the source.
| Provider | Protocol | Setup |
|---|---|---|
| Microsoft Outlook | Graph API | Settings → Provider Accounts → Calendar |
| Sparks Appointments (Scheduler) | Scheduler API | Automatic (Appointment Manager) |
| Google Calendar API | Settings → Provider Accounts → Calendar | |
| Nextcloud | CalDAV | CalDAV URL, user, password |
| Open-Xchange | OX API | OX server URL, credentials |
Details: Data Backends