CalDAV Calendar Integration

Overview

CalDAV (Calendar Distributed Authoring and Versioning) is an open protocol that allows you to sync calendars across different applications and services. EventMoot supports CalDAV connections to a wide variety of calendar providers.

Supported Providers

Tier Requirements

Setting Up CalDAV

General Steps

1. Go to Settings → Calendars in EventMoot
2. Click Add Calendar and select your provider
3. Enter your credentials:
   • Server URL (for self-hosted providers)
   • Username (usually your email)
   • Password or app-specific password
4. Click Test Connection to verify
5. Select which calendars to sync

Provider-Specific Setup

Apple iCloud

Apple requires an app-specific password for third-party apps like EventMoot. Your regular Apple ID password will not work.

Step 1: Generate an App-Specific Password

1. Go to appleid.apple.com
2. Sign in with your Apple ID
3. In the Sign-In and Security section, click App-Specific Passwords
4. Click the + button or Generate an app-specific password
5. Enter a label like "EventMoot"
6. Click Create
7. Copy the 16-character password (format: xxxx-xxxx-xxxx-xxxx)

Important: You can only view this password once. Save it somewhere secure.

Step 2: Connect to EventMoot

1. Go to Settings → Calendars
2. Click Add Calendar → Apple iCloud
3. Enter your credentials:
   • Username: Your full iCloud email (e.g., yourname@icloud.com)
   • Password: The app-specific password you just created
4. Click Test Connection
5. Select which calendars to sync

Troubleshooting iCloud:

• Make sure you're using the app-specific password, not your Apple ID password
• Ensure two-factor authentication is enabled on your Apple ID (required for app-specific passwords)
• Try using your @icloud.com email if @me.com doesn't work

Nextcloud

Nextcloud is a self-hosted cloud platform. The server URL depends on your installation.

Step 1: Find Your CalDAV URL

1. Log into your Nextcloud instance
2. Go to Calendar app
3. Click the three dots next to a calendar
4. Click Copy private link or check the URL format

Your CalDAV URL typically follows this pattern:

https://your-nextcloud-domain.com/remote.php/dav

Step 2: Connect to EventMoot

1. Go to Settings → Calendars
2. Click Add Calendar → Nextcloud
3. Enter your credentials:
   • Server URL: Your Nextcloud CalDAV URL
   • Username: Your Nextcloud username
   • Password: Your Nextcloud password (or app password if using 2FA)
4. Click Test Connection
5. Select which calendars to sync

Troubleshooting Nextcloud:

• If using two-factor authentication, generate an app password in Settings → Security
• Ensure the Calendar app is enabled on your Nextcloud
• Check that your server has a valid SSL certificate

Fastmail

Fastmail uses standard CalDAV with your regular account password.

Step 1: Connect to EventMoot

1. Go to Settings → Calendars
2. Click Add Calendar → Fastmail
3. Enter your credentials:
   • Username: Your Fastmail email address
   • Password: Your Fastmail password (or app password)
4. Click Test Connection
5. Select which calendars to sync

Note: If you have two-factor authentication enabled, create an app password:

1. Go to Fastmail Settings → Privacy & Security → Integrations
2. Click New app password
3. Use this password in EventMoot

Zoho Calendar

Step 1: Connect to EventMoot

1. Go to Settings → Calendars
2. Click Add Calendar → Zoho
3. Enter your credentials:
   • Username: Your Zoho email address
   • Password: Your Zoho password or app-specific password
4. Click Test Connection
5. Select which calendars to sync

App-specific password for Zoho:

1. Go to accounts.zoho.com → Security → App Passwords
2. Generate a new password for EventMoot

Synology Calendar

Synology DSM has built-in CalDAV support through the Calendar package.

Step 1: Find Your CalDAV URL

Your Synology CalDAV URL follows this pattern:

https://your-nas-address:5001/caldav/[username]

Or via QuickConnect:

https://[quickconnect-id].quickconnect.to/caldav/[username]

Step 2: Connect to EventMoot

1. Go to Settings → Calendars
2. Click Add Calendar → Synology
3. Enter your credentials:
   • Server URL: Your Synology CalDAV URL
   • Username: Your DSM username
   • Password: Your DSM password
4. Click Test Connection
5. Select which calendars to sync

Troubleshooting Synology:

• Ensure the Calendar package is installed and running
• Check that CalDAV is enabled in Control Panel → Applications Services
• Verify your firewall allows external connections to port 5001

Custom CalDAV Server

For any CalDAV-compliant server (Radicale, Baïkal, DAViCal, etc.):

1. Go to Settings → Calendars
2. Click Add Calendar → Custom
3. Enter your server details:
   • Server URL: Your CalDAV server's principal URL
   • Username: Your account username
   • Password: Your account password
4. Click Test Connection
5. Select which calendars to sync

Finding your CalDAV URL:

• Check your server's documentation
• Common formats include:
  • https://server.com/caldav/
  • https://server.com/dav/calendars/user/
  • https://server.com/.well-known/caldav

Features

Automatic Event Sync

When an event is finalized in EventMoot, it's automatically added to your connected calendars:

• Event title, description, and location
• Start and end times
• Attendee list (if supported)

Conflict Detection

EventMoot checks your connected calendars for scheduling conflicts:

• See when proposed times clash with existing events
• Visual indicators on poll time slots
• Helps you vote for times that work

Multiple Calendars

Connect multiple calendars to:

• Sync events to specific calendars (e.g., "Gaming" calendar)
• Check conflicts across all your calendars
• Separate personal and group events

Security

Your calendar credentials are protected:

• Encrypted storage: Passwords encrypted with AES-256-GCM
• Never logged: Credentials never appear in logs
• Minimal access: We only read/write events you explicitly sync
• Easy removal: Delete connections instantly from settings

Credentials are used to:

• Verify your calendar connection
• Read events for conflict detection
• Write finalized events to your calendar

We never:

• Share your credentials with third parties
• Store passwords in plain text
• Access calendars you haven't selected

Troubleshooting

"Invalid username or password"

• Double-check your credentials
• For iCloud: Use an app-specific password, not your Apple ID password
• For services with 2FA: Generate an app password
• Ensure you're using the correct username format (often your email)

"CalDAV server not found" (404)

• Verify the server URL is correct
• Check that the CalDAV service is enabled on your server
• Try the .well-known/caldav URL for auto-discovery

"Could not connect to the server"

• Verify your internet connection
• Check if the server is accessible from outside your network
• Ensure your firewall allows the connection
• Verify SSL certificates are valid

Sync not working

• Check that you've selected calendars to sync
• Verify the calendar connection is still active
• Try disconnecting and reconnecting
• Ensure you have permission to write to the calendar

Events not appearing

• Wait a few minutes for sync to complete
• Check that the event was actually finalized (not just draft)
• Verify you selected the correct calendar for sync
• Look in the correct date range in your calendar app