NAME

org2ical - convert appointments in org-mode files to .ics files

SYNOPSIS

org2ical [--debug] [--domain-id=example.org] --todo-file /path/to/file.org [--todo-file ...] [--include-tags tag,tag,...] [--exclude-tags tag,tag,...] --ics-file /path/to/outfile.ics

DESCRIPTION

Convert appointments (events; active timestamps) found in one or more org-mode files into an ical file.

The generated file may be served with a web server. Probably some kind of security (authentication, SSL) should be configured in such setup.

OPTIONS

--todo-file path

The path to an org-mode file. Mandatory. May be specified multiple times.

--ics-file path

The path for the output ical (.ics) file. Mandatory.

--include-tags tag,tag,...

Generate ical events only for TODO item matching one of the given tags (comma-separated list).

--exclude-tags tag,tag,...

Do not generate ical events for TODO item matching at least one of the given tags (comma-separated list).

--domain-id value

Specify the domain part of generated uids. If not given, then the fqdn (using hostname(1)) or short hostname (using Sys::Hostname) is taken.

--debug

Enable debugging, e.g. output of a diff(1) if there were changes to the generated .ics file.

HISTORY

Before version 0.05, the options --include-tags and --exclude-tags were not implemented. In these versions a hard-coded exclude tag list homecomputer,workcomputer,ignoreics was used. Since 0.05 there is no such hard-coded list.

EXAMPLE

A sample crontab entry:

0 * * * * org2ical --domain-id=example.org --todo-file $HOME/TODO.org --ics-file $HOME/public_html/secure/TODO.ics --exclude-tags homecomputer,workcomputer,ignoreics

TODO & LIMITATIONS

* the handling of description/summary/comment is not yet defined

AUTHOR

Slaven Rezic

SEE ALSO

org-daemon.