Skip to content

A server which exposes an existing OpenGroupware database as an iCalendar service.

License

Notifications You must be signed in to change notification settings

geo-data/ogo-ical

Repository files navigation

OpenGroupware iCalendar Service

GitHub release Travis CI Go Report Card GoDoc

This repository provides a server which exposes an existing OpenGroupware database as an iCalendar service. This makes it suitable for integrating OpenGroupware installations with external calendar services which require resources in iCalendar format.

Usage

Let's assume the services is installed and configured to run on http://localhost:8080 To use it you need to point your calendar software to the iCalendar feed at http://localhost:8080 and add one or more filters (you can't download the whole calendar at once for security reasons). You can filter by username and/or case insensitive matching of event titles. Examples are:

Feeds show future events and past events up to a month ago. Note that feeds are read only - you can't update OpenGroupware from your external calendar.

Configuration

$ ogo-ical -h
Usage of ./ogo-ical:
  -address string
        server address (default ":8080")
  -dsn string
        postgresql Data Source Name
  -version
        display version information

The server can also be configured by setting the $OGO_ICAL_DSN and $OGO_ICAL_ADDRESS environment variables which set the -dsn and -address flags respectively.

Installation

Binary download

You can download a self contained ogo-ical binary compiled for Linux x86_64 from the latest release.

Via Docker

The latest version is available from the Docker Registry at geodata/ogo-ical:latest. It can be run as follows:

docker run -d -e OGO_ICAL_ADDRESS=my.server:80 -e "OGO_ICAL_DSN=host=postgres dbname=ogo" geodata/ogo-ical:latest

From source

Install Go and simply:

go get github.com/geo-data/ogo-ical

This should install the ogo-ical binary under $GOPATH/bin.

License

license

MIT - See the file LICENSE for details.

About

A server which exposes an existing OpenGroupware database as an iCalendar service.

Resources

License

Stars

Watchers

Forks

Packages

No packages published