README.md

TimeTree Exporter

A Tool for Exporting TimeTree Calendar and Convert to iCal format(.ics)
This script works by scraping the TimeTree web app and converting the data to iCal format. (The .ics file can then be imported into other calendar apps such as Google Calendar, Apple Calendar, Outlook Calendar, etc.)

Installation

If you are on mac, you can install it using brew:

brew install eoleedi/timetree-exporter/timetree-exporter

You can also install it using pip or pipx:

pip install timetree-exporter

Timetree Exporter requires Python 3.9 or later.

Usage

timetree-exporter -o path/to/output.ics

This will prompt you to enter your TimeTree email and password and select the calendar you want to export.

Then, you can import the ics file to your calendar app.

💡 Note: You are advised to import the ICS file into a separate calendar (e.g., Google Calendar) so that if anything goes wrong, you can simply delete the calendar and reimport it.

Additional Options

• You can specify your email address using the -e option.

  timetree-exporter -e email@example.com

Limitations

Alarms(Alerts) can't be imported to Google Calendar through iCal format due to Google's bug.

Support

If you think it's helpful, kindly support me!

Roadmap of the properties mapping to iCal

• ID
• Primary ID
• Calendar ID
• UUID
• Category
• Type
• Author ID
• Author Type
• Title
• All Day
• Start At
• Start Timezone
• End At
• End Timezone
• Label ID
• Location
• Location Latitude
• Location Longitude
• URL
• Note
• Lunar
• Attendees
• Recurrences
• Recurring UUID
• Alerts
• Parent ID
• Link Object ID
• Link Object ID String
• Row Order (Ignore since it's a property for timetree notes)
• Attachment
• Like Count
• Files
• Deactivated At
• Pinned At
• Updated At
• Created At