Cybozu2ICal

  1. Cybozu2ICal
    1. Name
    2. Synopsis
    3. Description
    4. Requirement
    5. Options
    6. Configuration
    7. Changes
      1. 0.03 (2006/04/17 07:59:25)
      2. 0.02 (2006-04-16 10:44:39)
      3. 0.01 (2006/04/15 16:29:24)
    8. Development
    9. See Also
    10. Author

Name

cybozu2ical - Convert Cybozu Office 6 calendar into iCalendar format

cybozu2ical-0.20.zip

Synopsis

 % cybozu2ical
 % cybozu2ical --conf /path/to/config.yaml

Description

"cybozu2ical" is a command line application that fetches Cybozu Office 6 calendar items and converts them into a iCal file. It allows you to easily integrate the Cybozu Calendar into iCalendar-enabled Calendar applications, such as Microsoft Outlook, Apple iCal, and of course, Google Calendar.

You can run this via crontab, for example, every 1 hour.

Requirement

This application requires perl 5.8.0 with following Perl modules installed on your box.

  • Text::CSV_XS
  • Data::ICal
  • DateTime
  • YAML

Options

This application has a command-line option as follows:

--output /path/to/output.ics
Specifies the output file. By default, this application outputs to STDOUT.
--conf path/to/config.yaml
Specified the path to a configuration file. By default, "config.yaml" in the current directory.
--compat-google-calendar
Outputs an iCalendar format, which is compatible with Google Calendar.
--debug
Outputs Cybozu Office 6 CSV data as a COMMENT field of each events.
--input-csv /path/to/input.csv
Instead of requesting Cybozu Office 6 server, reads from a local CSV file.
--output-csv /path/to/output.csv
Specifies the output CSV file for debugging.
--help
Shows command-line options.

Configuration

The distributions includes a sample configuration file "config.yaml.sample". You can rename it to "config.yaml" and configure "cybozu2ical".

cybozu_url
Set the URL of your Cybozu Office 6.
calname
Set the calendar name. iCalendar application which properly handles X-WR-CALNAME header, is expected to use this string as a calendar name.
username, userid
Set your username or userid for Cybozu Office 6.
password
Set your password for Cybozu Office 6.
time_zone
Set the timezone of your Cybozu Office 6 (e.g., Asia/Tokyo).
tzname
Set the short timezone name of your Cybozu Office 6 (e.g., JST).
input_encoding
Set the charset of Cybozu Office 6. By default, input_encoding is "shiftjis".
output_encoding
Set the charset of iCalendar file. By default, output_encoding is "utf8". If you need to output multibyte strings as Numeric Character References, set output_encoding to "ncr".

Changes

0.03 (2006/04/17 07:59:25)

  • Now employ Getopt::Long and Pod::Usage and support sophisticated command-line options.

0.02 (2006-04-16 10:44:39)

  • Add TimeZone support.
  • Date::ICal was replaced by DateTime module.
  • Add an installation script .

0.01 (2006/04/15 16:29:24)

  • Initial Release.

Development

The development version is always available from the following:

/cybozu2ical/trunk

Any comments, suggestions, or patches are welcome (new ticket).

See Also

Author

Hirotaka Ogawa (hirotaka.ogawa at gmail.com)

This script is free software and licensed under the same terms as Perl (Artistic/GPL).