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.
-
Generate ical events only for TODO item matching one of the given tags (comma-separated list).
-
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