NAME

App::gcal - Command Line Interface interface to Google Calendar.

VERSION

version 1.121460

SYNOPSIS

  gcal --help

  gcal [events.ical, 'tomorrow at noon. Lunch with Bob', ...]

  gcal --username="bill" --password="1234" [events.ical, 'tomorrow at noon. Lunch with Bob', ...]

DESCRIPTION

The gcal command provides a quick and easy interface to Google Calendar from the command line.

Before using the gcal command, you need to provide your Google credentials. The most convenient way to do this is by using your ~.netrc file and supplying credentials for the google.com machine. For example:

  machine google.com
  login bill
  password 1234

NOTE: On Windows, your .netrc file is at %HOME%.netrc.

NOTE 2: On Unix, ensure your ~.netrc file has the permissions set to 600.

Alternatively, you can pass the username and password as a parameter to gcal, as follows:

  gcal --username="bill" --password="1234"

You can then pass one or more .ics files to the gcal command and it will be added to your Google Calendar.

You can also pass one or more strings to the gcal command, which will attempt to parse it and create a new event. It uses ICal::QuickAdd to parse, so has the same functionality and limitations.

Using Google's Two Factor Authentication

If you are using Google's two factor authentication (and you really should be), you will need to generate a new application-specific password for gcal. Save that in your .netrc file and use gcal as normal.

AUTHOR

Andrew Jones <andrew@arjones.co.uk>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Andrew Jones.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.