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' gcalcli v2.4.1 (Eric Davis, Brian HartvigsenJuly 2013 GCALCLI(1)