README for gcalsync

Purpose

The purpose of this tools is retrieve calendar events from a range of google calendars and generate an org-mode file to be included into it’s agenda view.

The backbone of this code is inspired from: codemac/gcalorg.

Installation

With a working golang tool chain the easiest way is to install using:

go get -u github.com/lchausmann/gcalsync

Configuration

The tool is configured by creating a configuration: $HOME/.gcalsync.yaml

The content of the file is:

#
# Format for an entry:
# personal:
#   tokenfile:
#   calendars:
#     <Tag>: <calendarid>
#     <Tag2>: <2calendarid>
#   titlefilters:
#     - Standup
#     - Status Report
#   orgfile: ~/private/org/calendar/cal-personal.org

<identifier>:
  tokenfile: ~/.gcalsync/personal_secret.json
  tagname: Personal
  calendars:
    Personal: <your calendarid>
    Thor: <next calenarid>
  titlefilters:
    - Standup
    - Status Report
  orgfile: ~/private/org/calendar/cal-personal.org

The can be multiple stanzas in the configuration file.

Usage

Run the tool after installation by:

gcalsync fetch <identifier>

The first run will prompt you to obtain a Oauth token from Google. Subsequent runs can completed using cron.

Pending Todos

Better documentation

Multi-architecture releases

Improved documentation