timetree-exporter 0.7.0

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

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

Development

This project uses uv for dependency management.

Setup

1. Install uv:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Clone the repository and install dependencies:

   git clone https://github.com/eoleedi/TimeTree-Exporter.git
   cd TimeTree-Exporter
   uv sync
   

3. Install pre-commit hooks:

   uv run pre-commit install
   

Run Tests

uv run pytest tests

Run Linter

uv run ruff check --fix .

Run Formatter

uv run ruff format .

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