NAMEgcalcli - Google Calendar Command Line Interface
SYNOPSISgcalcli [options] command [command args]
DESCRIPTIONgcalcli is a Python application that allows you to access your Google Calendar from a command line. It's easy to get your agenda, search for events, and quickly add new events. Additionally gcalcli can be used as a reminder service to execute any application you want.
OPTIONS--help this usage text --config <file> config file to read (default is '~/.gcalclirc') --user <username> google username --pw <password> password --cals [all, 'calendars' to work with (default is all calendars) default, - default (your default main calendar) owner, - owner (your owned calendars) editor, - editor (editable calendar) contributor, - contributor (non-owner but able to edit) read, - read (read only calendars) freebusy] - freebusy (only free/busy info visible) --cal <name> 'calendar' to work with (default is all calendars) - you can specify a calendar by name or by using a regular expression to match multiple calendars - you can use multiple '--cal' arguments on the command line --details show all event details (i.e. length, location, reminders, contents) --ignore-started ignore old or already started events - when used with the 'agenda' command, ignore events that have already started and are in-progress with respect to the specified [start] time - when used with the 'search' command, ignore events that have already occurred and only show future events --width the number of characters to use for each column in the 'cal' command output (default is 10) --nc don't use colors --cal-owner-color specify the colors used for the calendars and dates --cal-editor-color each of these argument requires a <color> argument --cal-contributor-color which must be one of [ default, black, brightblack, --cal-read-color red, brightred, green, brightgreen, yellow, --cal-freebusy-color brightyellow, blue, brightblue, magenta, --date-color brightmagenta, cyan, brightcyan, white, --border-color brightwhite ]
COMMANDSlist list all calendars search <text> search for events - only matches whole words agenda [start] [end] get an agenda for a time period - start time default is 12am today - end time default is 5 days from start - example time strings: '9/24/2007' 'Sep 24 2007 3:30pm' '2007-09-24T15:30' '2007-09-24T15:30-8:00' '20070924T15' '8am' calw <weeks> [start] get a week based agenda in a nice calendar format - weeks is the number of weeks to display - start time default is beginning of this week - note that all events for the week(s) are displayed calm [start] get a month agenda in a nice calendar format - start time default is the beginning of this month - note that all events for the month are displayed and only one month will be displayed quick <text> quick add an event to your default calendar - example: 'Dinner with Eric 7pm tomorrow' '5pm 10/31 Trick or Treat' remind <mins> <command> execute command if event occurs within <mins> minutes time ('%s' in <command> is replaced with event start time and title text) - <mins> default is 10 - default command: 'gxmessage -display :0 -center \ -title "Ding, Ding, Ding!" %s'
SEE ALSOWiki page <//code.google.com/p/gcalcli/w/list>
FILES~/.gcalclirc If exists is consulted at startup for defaults. Formatted with a section header "gcalcli" followed by lines option: value. (See section OPTIONS above for list of valid options.) E.g., [gcalcli] user: bertie_ahern pw: topsecret cal: Irish Holidays
AUTHORBrandon Philips, Yaroslav Halchenko, Barak A. Pearlmutter
COPYRIGHTCopyright (C) 2007 Brandon Philips <email@example.com> Copyright (C) 2009 Yaroslav Halchenko <firstname.lastname@example.org> GCALCLI(1)