ical: iCalendar format parser and org-mode converter.

[ bsd3, deprecated, library, program, web ] [ Propose Tags ]
Deprecated in favor of iCalendar

Please see README.md

[Skip to Readme]


Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


  • No Candidates
Versions [RSS] 0.0.0, 0.0.1
Dependencies aeson, attoparsec, base (>=4.7 && <5), containers, either (<5), ical, mtl, text, time (>=1.5), transformers [details]
License BSD-3-Clause
Copyright 2015 Chris Done
Author Chris Done
Maintainer chrisdone@gmail.com
Revised Revision 1 made by GeorgeWilson at 2018-06-12T04:34:48Z
Category Web
Home page http://github.com/chrisdone/ical#readme
Source repo head: git clone https://github.com/chrisdone/ical
Uploaded by ChrisDone at 2015-11-24T10:18:52Z
Executables ical-org
Downloads 1772 total (5 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2016-11-29 [all 3 reports]

Readme for ical-0.0.1

[back to package description]


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> <output.org> [--base=YYYY-MM-DD (default: 1970-01-01)]


$ stack install ical


$ git clone https://github.com/chrisdone/ical.git
$ cd ical
$ stack build
$ stack exec -- ical-org input.ics output.org

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 https://calendar.google.com/calendar/ical/chrisdone%40gmail.com/private-<my code here>/basic.ics
/home/chris/.local/bin/ical-org basic.ics basic.org --base=2015-06-01

cp basic.org /home/chris/Dropbox/Org/gc.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. gc.org 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.