Files
homelab/~/Documents/git/applescript-calendar-sync/README.md
2025-10-19 17:02:16 -05:00

1.6 KiB

AppleScript Calendar Sync

An AppleScript utility that synchronizes calendar events between two calendar accounts for the current day.

Overview

This script reads events from a source calendar and mirrors them to a destination calendar, including removal of events that no longer exist in the source. It's designed to keep two calendars in sync automatically.

Features

  • Synchronizes events for the current day only
  • Configurable source and destination calendars
  • Comprehensive logging and error handling
  • Progress tracking and user notifications
  • Handles event creation, updates, and removal

Configuration

Edit the configuration properties at the top of calendar-sync.applescript:

property sourceAccountName : "Work Account"
property sourceCalendarName : "Main Calendar"
property destinationAccountName : "Personal Account"
property destinationCalendarName : "Synced Events"
property enableLogging : true
property enableDebugMode : false

Usage

  1. Configure the source and destination calendar settings
  2. Run the script using Script Editor or from the command line with osascript
  3. The script will sync today's events and display a summary

Documentation

The docs/ directory contains the complete specification:

  • requirements.md - Detailed requirements and user stories
  • design.md - Technical design and architecture
  • tasks.md - Implementation plan and task breakdown

Development Status

This project is currently in development. See docs/tasks.md for the current implementation progress.

Requirements

  • macOS with Calendar app
  • AppleScript support
  • Access to both source and destination calendar accounts