gcalcli

Langue: en

Version: November 2007 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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
--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 ]

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' '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 ALSO

Wiki page

FILES

~/.gcalcli
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
 
 

AUTHOR

Brandon Philips, Yaroslav Halchenko, Barak A. Pearlmutter Copyright © 2007 Brandon Philips <brandon@ifup.org>

Copyright © 2009 Yaroslav Halchenko <debian@onerussian.com>