In favour of


iCalendar format parser and org-mode converter.

Version on this page:0.0.1
LTS Haskell 10.10:0.0.1
Stackage Nightly 2017-12-24:0.0.1
Latest on Hackage:0.0.1@rev:1

See all snapshots ical appears in

BSD-3-Clause licensed by Chris Done
Maintained by [email protected]
This version can be pinned in stack with:ical-0.0.1@sha256:e7cf9f7343b9eb10ad46a3e83467a0c5c08aeecca3d3e261d8ca9e3b99cb3a43,1579

Module documentation for 0.0.1

Used by 1 package in lts-9.21(full list with versions):


iCalendar parser.

Also usable as a command-line tool called ical-org to generate org-mode agenda files.


$ ical-org
ical-org: expected <input.ics> <> [--base=YYYY-MM-DD (default: 1970-01-01)]


$ stack install ical


$ git clone
$ cd ical
$ stack build
$ stack exec -- ical-org input.ics

Typical use

I’ve setup on my server a crontab that will run this command every 5 minutes.

Here is my crontab entry:

*/5 * * * * sh /home/chris/gc-update

Here is my gc-update script:

mkdir -p /tmp/ical
cd /tmp/ical

wget<my code here>/basic.ics
/home/chris/.local/bin/ical-org basic.ics --base=2015-06-01

cp /home/chris/Dropbox/Org/

rm -r /tmp/ical

My org-mode files are stored in Dropbox, so this update is replicated to my Dropbox which then my desktop computer will download only if there is any change.

Open the file e.g. into an Emacs buffer and enable M-x auto-revert-mode.

Example output

* DONE Cafe Bookique
  SCHEDULED: <2015-08-26>
  - State "DONE"       from "TODO"       [2015-08-26]

* DONE Lez Muvi at astra
  SCHEDULED: <2015-08-31>
  - State "DONE"       from "TODO"       [2015-08-31]

* DONE Meet Giulia at p. Italia
  SCHEDULED: <2015-09-01>
  - State "DONE"       from "TODO"       [2015-09-01]

* DONE Ping Dave on content
  SCHEDULED: <2015-09-03>
  - State "DONE"       from "TODO"       [2015-09-03]

* DONE Espressioni
  SCHEDULED: <2015-09-03>
  - State "DONE"       from "TODO"       [2015-09-03]

* DONE Stay at Hotel Glam Milano
  SCHEDULED: <2015-09-04>
  - State "DONE"       from "TODO"       [2015-09-06]

* DONE Go get a sheet for toga. And maybe a sword
  SCHEDULED: <2015-09-04>
  - State "DONE"       from "TODO"       [2015-09-04]

* DONE Get train to Milan (leaves at 17:43)
  SCHEDULED: <2015-09-04>
  - State "DONE"       from "TODO"       [2015-09-04]

* DONE The Sword live in Milan
  SCHEDULED: <2015-09-04>
  - State "DONE"       from "TODO"       [2015-09-04]

Known issues

I can’t be bothered to resolve time zones yet. There is some work involved in reading them in, involving daylight savings time. For now everything is assumed to be UTC, but given that the main use-case, outputting org-mode files, only outputs dates, this is not a huge problem.