Author: Patrick Hof firstname.lastname@example.org
Copyright: Copyright (C) 2008 Patrick Hof
Download: git clone git://github.com/courts/ical2rem.rb.git
YARD docs: http://courts.github.com/ical2rem.rb
ical2rem.rb is based on the Perl program
ical2rem.pl by Justin B.
Alcorn . It converts an iCalendar file's
VTODO components to
Remind syntax. You should be
able to use it as a drop-in replacement for
ical2rem.pl with only minor
modifications. The command line client which comes with ical2rem.rb is called
ical2rem-cli and can be found in the
ical2rem.rb requires RiCal You can
install it with RubyGems:
gem install ri_cal
ical2rem.rb itself has a gemspec file, so you can easily build a gem
and install it with:
gem build ical2rem.rb.gemspec gem install ical2rem.rb.-x.x.x.gem
Besides that, no further installation steps are required. Note that ical2rem.rb only works with ruby 1.9, not 1.8.
You can get usage information by running
ical2rem-cli with the
Usage: ical2rem-cli [options] < input-file [> output-file] --label LABEL Calendar name --lead-time LEAD Advance minutes to start reminders --heading HEADING Define a priority for static entries -t, --todos Process TODOs? -c, --config-file FILE Use config file FILE (default: .ical2rem.yaml) -d, --debug Show debug info -h, --help Show this help
The configuration file (default
.ical2rem.yaml) further explains the
options you can supply.
ical2rem-cli will read any iCalendar file parseable by RiCal from
STDIN and print its output to
ical2rem.rb was mainly written because
ICal::Parser, the iCal
ical2rem.pl uses, bailed out on my 64bit Ubuntu I was
using at the time. Also,
ical2rem.pl does not support showing starting
and ending times of events.
The first version used Sam Roberts' vPim, but since it didn't work well with Ruby 1.9 for some time, I decided to switch to RiCal.
ical2rem.rb parses iCalendar
VEVENTs in a similar way to
ical2rem.pl, but it will also recognize
TIME-DATE values in
DTEND and add them to the output by using remind's
ical2rem.rb also parses iCalendar
ical2rem-cli will not
parse them by default, parsing has to be enabled with the command line switch
'-t'. At the moment, the same simple approach to parsing as in
ical2rem.pl is used. This may improve in future versions.
Bug Reports / Feature Requests / Patches
Please send bug reports to my e-mail address given above. Adding
[BUG ical2rem.rb] to the subject will greatly increase your chance of not
getting stuck in my spam filter. The same goes for feature requests, including
[FEATURE ical2rem.rb] would be nice.
For patches, please send them as git patches formatted with
git-format-patch -n if possible. Make sure they commit cleanly against
Otherwise, at least include
[PATCH ical2rem.rb] in your subject.