Skip to main content

Converting ICAL file into org-mode format.

Project description

ical2orgpy
==========

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:

http://orgmode.org/worg/org-tutorials/org-google-sync.html

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
org-document.

Installation
============

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 https://raw.githubusercontent.com/mitsuhiko/pipsi/master/get-pipsi.py | python
$ cd <to project folder>
$ pipsi install .


Usage
=====
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::

#!/bin/bash

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

# no customization needed below

$WGET -O $ICSFILE $URL
$ICS2ORG $ICSFILE $ORGFILE
rm -f $ICSFILE

See further instructions here:

http://orgmode.org/worg/org-tutorials/org-google-sync.html

Development
===========
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
(py27)$

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.

Source Distribution

ical2orgpy-0.3.0.tar.gz (25.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page