https://github.com/fphammerle/ical2vdir

Convert single iCalendar .ics file into vdir directory 📅
https://github.com/fphammerle/ical2vdir

calendar convert events icalendar khal vdir

Last synced: 4 months ago
JSON representation

Convert single iCalendar .ics file into vdir directory 📅

• Host: GitHub
• URL: https://github.com/fphammerle/ical2vdir
• Owner: fphammerle
• License: gpl-3.0
• Created: 2020-02-05T20:04:58.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2026-01-31T10:54:32.000Z (5 months ago)
• Last Synced: 2026-01-31T21:33:57.233Z (5 months ago)
• Topics: calendar, convert, events, icalendar, khal, vdir
• Language: Python
• Homepage: https://pypi.org/project/ical2vdir/
• Size: 844 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: COPYING

Awesome Lists containing this project

README

          
# ical2vdir 📅

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![CI Pipeline Status](https://github.com/fphammerle/ical2vdir/workflows/tests/badge.svg)](https://github.com/fphammerle/ical2vdir/actions)

![Coverage Status](https://ipfs.io/ipfs/QmP8k5H4MkfspFxQxdL2kEZ4QQWQjF8xwPYD35KvNH4CA6/20230429T090002+0200/s3.amazonaws.com/assets.coveralls.io/badges/coveralls_100.svg)

[![Last Release](https://img.shields.io/pypi/v/ical2vdir.svg)](https://pypi.org/project/ical2vdir/#history)

[![Compatible Python Versions](https://img.shields.io/pypi/pyversions/ical2vdir.svg)](https://pypi.org/project/ical2vdir/)

Convert / split single [iCalendar](https://en.wikipedia.org/wiki/ICalendar)

`.ics` file into a

[vdir](https://vdirsyncer.readthedocs.io/en/stable/vdir.html) directory.

Pre-existing files will be updated or left unchanged.

Compatible with [khal](https://github.com/pimutils/khal).

## Setup

```sh

$ sudo apt-get install python3-icalendar # optional

$ pip3 install --user --upgrade ical2vdir

```

## Usage

```sh

$ ical2vdir < input.ics --output-dir /some/path

```

Or download `.ics` from [Google Calendar](https://calendar.google.com/):

```sh

$ curl https://calendar.google.com/calendar/ical/someone%40gmail.com/private-1234/basic.ics \

    | pipenv run ical2vdir --output-dir output/

```

Remove files from output directory that are not available in input:

```sh

$ ical2vdir < input.ics --output-dir /some/path --delete

```