Provided by: gcalcli_2.4.2-2_all bug


       gcalcli - Google Calendar Command Line Interface


       gcalcli [options] command [command args]


       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


       --help this usage text

              version information

       --config <file>
              config file to read (default is '~/.gcalclirc')

       --user <username>
              google username

       --pw <password>

       --cals [all,
              'calendars' to work with (default is all calendars)

              - default (your default main calendar)

       owner, - owner (your owned calendars)

              - editor (editable calendar)

              - contributor (non-owner but able to edit)

       read,  - read (read only calendars)

              - 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

              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

              link is shortened using (slow!)



       --detail-url [short,


              ignore  old or already started events - when used with the 'agenda' command, ignore

              that have already started and are in-progress with respect to the specified [start]

              - when used with the 'search' command, ignore events

              that have already occurred and only show future events

              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

              use conky color escapes sequences instead of ansi terminal color  escape  sequences
              (requires using the 'execpi' command in your conkyrc)

              specify the colors used for the calendars and dates

              each of these argument requires a <color> argument

              which must be one of [ default, black, brightblack,

              red, brightred, green, brightgreen, yellow,

              brightyellow, blue, brightblue, magenta,

              brightmagenta, cyan, brightcyan, white,

              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


       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

              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

              'notify-send -u critical -a gcalcli %s'

gcalcli v2.4.1 (Eric Davis, Brian HartvigsenJuly 2013                                  GCALCLI(1)