Downloads a calendar in ICS format and uploads it to a CalDAV server, regularly. Your employee, school, or whoever shares a calendar as a link to an ICS file and you'd like to have it on another CalDAV server? Look no further.
Install requirements from requirements.txt and run ics_caldav_sync.py file
using Python 3.8 or higher.
There exist also Dockerfile and docker-compose.yml files so you can
run it on your Docker server.
Set the settings as environment variables:
- REMOTE_URL (str): ICS file URL.
- LOCAL_URL (str): CalDAV URL.
- LOCAL_CALENDAR_NAME (str): The name of your CalDAV calendar.
- LOCAL_USERNAME (str): CalDAV username.
- LOCAL_PASSWORD (str): CalDAV password.
- REMOTE_USERNAME (str, optional): ICS host username.
- REMOTE_PASSWORD (str, optional): ICS host password.
- SYNC_EVERY (str): How often should the synchronisation occur? For example: 2 minutes, 1 hour. Synchronise once if empty.
This script can be also used as a library in your Python script using ICSToCalDAVSync
class and its synchronise method.
def ICSToCalDAVSync.__init__(
self,
*,
remote_url: str,
local_url: str,
local_calendar_name: str,
local_username: str,
local_password: str,
remote_username: str = "",
remote_password: str = "",
)
def ICSToCalDavSync.synchronise(self):
"""
The main function which:
1) Pulls all the events from the remote calendar,
2) Saves them into the local calendar,
3) Removes local events which are not in the remote any more.
"""
In my case, my new shiny Bluetooth wristwatch, Casio Edifice ECB-10, did not support synchronisation with [https://support.apple.com/en-us/HT202361](calendar subscriptions). And so this script was created.