timetree-exporter 0.6.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.)

Installation

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

brew install eoleedi/tap/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.

Advanced Usage

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

  timetree-exporter -e [e-mail]
  

• You can 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
  

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
   

Running Tests

uv run pytest tests

Running Linter

uv run pylint timetree_exporter

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