Provided by: gcalcli_2.4.2-2_all bug

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)