timetree-exporter 0.7.2

A Tool for Exporting TimeTree Calendar and Convert to iCal format(.ics)

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.)

[!Warning] This is an independent, community-built project and is not affiliated with or endorsed by TimeTree, Inc. It uses unofficial, reverse-engineered TimeTree web APIs, which may change or stop working at any time without notice. As a result, the tool could break unexpectedly. Please use it responsibly—sending too many requests in a short period may lead to rate limiting, temporary blocks, or other restrictions from TimeTree.

Installation

[!Note] Timetree Exporter requires Python 3.10 or later.

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

brew install eoleedi/tap/timetree-exporter

You can also install it using uvx, pip, or pipx:

pip install timetree-exporter

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.

Advanced Usage

• Specify your email address using the -e option.

  timetree-exporter -e [e-mail]
  

• Specify the calendar code using the -c or --calendar_code option.

  timetree-exporter -c calendar_code
  

  Note: Find the calendar code in the URL of the calendar page or when running the script without the -c option.

• You can pass your email address and password with environment variables. (usually for automation purposes)

  export TIMETREE_EMAIL=[e-mail]
  export TIMETREE_PASSWORD=password
  

• Create separate ICS files for each label with a custom output directory.

  timetree-exporter --split-by-label
  

  This creates individual ICS files for each label (e.g., timetree_work.ics, timetree_personal.ics).

Limitations

• TimeTree labels include both a category name and a color. When using --split-by-label, each category is saved as a separate ICS file.
• Label color information is preserved in the ICS output, but Google Calendar does not apply those event colors when importing ICS files. If you rely on colors to organize events, you may need to check historical color information in TimeTree.

Support

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