https://github.com/lchausmann/gcalsync

Google calendar to org-mode file written in Golang.
https://github.com/lchausmann/gcalsync

emacs org-mode

Last synced: 4 months ago
JSON representation

Google calendar to org-mode file written in Golang.

• Host: GitHub
• URL: https://github.com/lchausmann/gcalsync
• Owner: lchausmann
• License: apache-2.0
• Created: 2018-03-04T09:19:43.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2022-04-08T07:51:21.000Z (almost 3 years ago)
• Last Synced: 2024-10-15T17:43:35.820Z (4 months ago)
• Topics: emacs, org-mode
• Language: Go
• Size: 47.9 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Awesome Lists containing this project

README

        
#+TITLE: 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: [[https://github.com/codemac/gcalorg][codemac/gcalorg]].

* Installation

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

#+BEGIN_SRC sh

go get -u github.com/lchausmann/gcalsync

#+END_SRC

* Configuration

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

The content of the file is:

#+BEGIN_EXAMPLE

#

# Format for an entry:

# personal:

#   tokenfile:

#   calendars:

#     : 

#     : <2calendarid>

#   titlefilters:

#     - Standup

#     - Status Report

#   orgfile: ~/private/org/calendar/cal-personal.org

:

  tokenfile: ~/.gcalsync/personal_secret.json

  tagname: Personal

  calendars:

    Personal: 

    Thor: 

  titlefilters:

    - Standup

    - Status Report

  orgfile: ~/private/org/calendar/cal-personal.org

#+END_EXAMPLE

The can be multiple stanzas in the configuration file.

* Usage

Run the tool after installation by:

#+BEGIN_SRC sh

gcalsync fetch 

#+END_SRC

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

* Pending Todos

** TODO Better documentation

** TODO Multi-architecture releases

** TODO Improved documentation