Build status

Synopsis

Add Google Calendar events via the command line with this application

Motivation

We felt compelled to implement a command-line interface of Google Calendar in order to expand our skills using Go and Google API.

Installation

Prerequisites

Requires Go 1.5+ to be installed. This can usually be done through your package manager. See official documentation for more information.

Package Install

If $GOPATH is set:

go get github.com/carlso70/gocalendar

Also, make sure $PATH contains $GOPATH/bin in order to call the program from outside $GOPATH/bin.

Usage

To run the program, run

gocalendar

In order to use Google's calendar API, gocalendar will need to be given permission to manage your Google Calendar.

At the moment gocalendar requires permission, a web link will show, at which point there is a prompt for permission verification. After verification, a code appears that needs to be pasted back into the program.

The program should continue seamlessly after permissions are set.

Controls

Navigate the command-line-based interface using the up and down arrow keys and enter to proceed.

Proceed through text prompts with enter (leave blank for default option in brackets).

For the bullet-style checkbox prompts, use spacebar to select however many options you would like and hit enter to proceed.

Available actions

From the root menu you can add, delete, edit, view, and exit.

Event properties that can be changed: summary, location, description, time zone, begin time, and end time,

The following describes each action:

• add: Create a new event, and prompt for event properties.
• delete: Search for events, and prompt the deletion of the selected event.
• edit: Search for events, and give a list of properties to edit. Prompt for each property, and update the event in bulk.
• view: Search for events, and display information about the selected event.
• exit: Exit the application.

API Reference

Official Google Calendar API Go Quickstart: https://developers.google.com/google-apps/calendar/quickstart/go

Official Google Calendar API Reference: https://developers.google.com/google-apps/calendar/v3/reference/

Tests

CircleCI tests are automatically run. View test details here.

Contributors

Currently, carlso70 and kroppt are the main contributors and original creators of the project.

Feel free to fork and suggest some changes. It's always welcome.

Issues will be handled at our discretion, most likely when we have free time.