icsp - iCalendar (.ics) parser

Fast and simple command-line tool to convert calendar exports (.ics files) into CSV files for easy analysis and usage in broader use-cases.

Combine this with CSV tools such as xsv, q or csvkit for calendar data superpowers.

Installation

To install the script, put it in your bin path and make sure it's executable.

Alternatively run this install script (bash):

# Always check scripts before running them...
sh <(curl -sSL https://raw.githubusercontent.com/loteoo/icsp/main/install)

With enough traction on the project, I will create proper installers and publish it to common package managers.

Usage examples

Run icsp -h for usage.

Examples:

# Basic usage
icsp calendar.ics > calendar.csv

# Download calendar from the internet as CSV
curl -s https://foobar/path/to/calendar.ics | icsp > calendar.csv

# Display specified fields in table format using 'column' command
icsp -c 'DTSTART,DTEND,SUMMARY' calendar.ics | column -t -s ','

Some public calendars to try out:

How to get some .ics files to try it out:

From Google CalendarFrom Outlook

Motivation

While common calendar software (Google, outlook, apple calendars, etc) may provide API access to your calendar data, it is usually a very involved setup that requires changing account configuration or permissions, dealing with authentication / authorization and reading company specific docs.

At the same time, they all provide very simple import/export features just a few clicks away using the iCalendar (.ics) format from 1998. Let's use that instead!

PRs, issues and ideas are welcome.

Give the repo a star to show your support!