Provided by: gcalcli_2.4.2-2_all 
NAME
gcalcli - Google Calendar Command Line Interface
SYNOPSIS
gcalcli [options] command [command args]
DESCRIPTION
gcalcli 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
--version
version information
--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>[#color]
'calendar' to work with (default is all calendars) - you can specify a calendar by name or by
substring
which can match multiple calendars
- you can use multiple '--cal' arguments on the
command line
- in the config file specify multiple calendars in
quotes separated by commas as:
cal: "foo", "bar", "my cal"
- an optional color override can be specified per
calendar using the ending hashtag:
--cal "Eric Davis"#green --cal foo#red
or via the config file:
cal: "foo"#red, "bar"#yellow, "my cal"#green
--24hr show all dates in 24 hour format
--detail-all
show event details in the 'agenda' output
--detail-location - the description width defaults to 80 characters
--detail-length - if 'short' is specified for the url then the event
--detail-reminders
link is shortened using http://goo.gl (slow!)
--detail-descr
--detail-descr-width
--detail-url [short,
long]
--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 'calw' and 'calm' command outputs (default
is 10)
--mon week begins with Monday for 'calw' and 'calm' command outputs (default is Sunday)
--nc don't use colors
--conky
use conky color escapes sequences instead of ansi terminal color escape sequences (requires using
the 'execpi' command in your conkyrc)
--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 ]
--tsv tab-separated output for 'agenda'. Format is: date, start, end, link, title, location, description
--locale <locale>
set a custom locale (i.e. 'de_DE.UTF-8'). Check the supported locales of your system first.
--reminder <mins>
number of minutes to use when setting reminders for the 'quick' and 'add' commands; if not
specified, Google code's default behavior occurs: no reminder is set (documented, incorrectly,
otherwise: as using the default for the calendar, but this does not actually happen)
--title <title>
event details used by the 'add' command
--where <location> - the duration is specified in minutes
--when <datetime> - make sure to quote strings with spaces
--duration <#> - the datetime format is 'MM/DD/YYYY HH:MM'
--descr <description> - the '--reminder' option can be specified as well
Commands:
list 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' '24/09/2007' '24/9/07' '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 a calendar - if a --cal is not specified then the event is
added to the default calendar
- example:
'Dinner with Eric 7pm tomorrow' '5pm 10/31 Trick or Treat'
add add a detailed event to a calendar - if a --cal is not specified then the event is
added to the default calendar
- example:
gcalcli --title 'Analysis of Algorithms Final'
--where UCI --when '12/14/2012 10:00' --duration 60 --descr 'It is going to be hard!' --reminder
30 add
import [-v] [file]
import an ics/vcal file to a calendar - if a --cal is not specified then the event is
added to the default calendar
- if a file is not specified then the data is read
from standard input
- if -v is given then each event in the file is
displayed and you're given the option to import or skip it, by default everything is imported
quietly without any interaction
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:
'notify-send -u critical -a gcalcli %s'