Skip to main content

Converting ICAL file into org-mode format.

Project description


This script converts an ical calendar (for instance, as exported from google
calendar) into an org-mode document. It is conceived as a replacement of the
awk script located here:

The main difference is that ical2orgpy correctly manages recurring events
of "yearly", "daily" and "weekly" types. ical2orgpy duplicates all
recurring events falling into a specified time-frame into the exported


The command `ical2orgpy` is provided by means of python package `ical2orgpy`.

Use `pip` (recommended to install into virtualenv)::

$ pip install ical2orgpy

Installing from source code

You can install the package directly from git source like this::

$ cd <to project folder>
$ pip install --user .

To use the script, just call::

$ ~/.local/bin/ical2orgpy

Alternatively, you can use the `pipsi` package, by just doing::

$ curl | python
$ cd <to project folder>
$ pipsi install .

Simply use the `ical2orgpy` command::

$ ical2orgpy --help

or, if installed locally from the git repo::

$ ~/.local/bin/ical2orgpy

.. highlight:: bash

The script requires two files, the input ics and the output org
document. Usually, `ical2orgpy` is called within a script that grabs the
ical file from some source (i.e. Google Calendar), and generates the
appropriate org document. Such an script would have the following shape::


# customize these
WGET=<path to wget>
ICS2ORG=<path to ical2org>
ORGFILE=<path to orgfile>
URL=<url to your private Google calendar>

# no customization needed below

rm -f $ICSFILE

See further instructions here:

Clone the repository and cd into it.

Assuming you have Python 2.7 and `tox` package installed::

$ tox -e py27

Then activate the virtualenv::

$ source .tox/py27/bin/activate

And use here the package.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ical2orgpy, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size ical2orgpy-0.3.0.tar.gz (25.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page