https://github.com/thesephist/frieden

My personal, read-only public availability calendar
https://github.com/thesephist/frieden

blocks-css calendar freebusy scheduling torus-dom

Last synced: 8 days ago
JSON representation

My personal, read-only public availability calendar

• Host: GitHub
• URL: https://github.com/thesephist/frieden
• Owner: thesephist
• License: mit
• Created: 2020-06-02T14:02:38.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-09-27T07:14:26.000Z (about 4 years ago)
• Last Synced: 2024-08-01T00:46:53.632Z (3 months ago)
• Topics: blocks-css, calendar, freebusy, scheduling, torus-dom
• Language: JavaScript
• Homepage: https://free.linus.zone
• Size: 115 KB
• Stars: 55
• Watchers: 4
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Frieden ✌️

Frieden is my personal, read-only public availability calendar, to reduce the back-and-forth in scheduling one-on-one meetings. Try the live app at [free.linus.zone](https://free.linus.zone).

Frieden is built with my usual arsenal of homebrew tools:

- A simple Go backend, proxying Google Calendar's API

- [Torus](https://github.com/thesephist/torus) driving the web UI

- [blocks.css](https://github.com/thesephist/blocks.css) for some visual flair

![Screenshot](screenshot.png)

## Usage and deployment

Frieden is deployed as a [systemd service](frieden.service) running as a static binary in Linux. You'll also need your calendars set up correctly with Google Calendar.

### Deployment secrets

To run Frieden, you'll need to place a `secrets.json` file in the root of the project. That file should look like this:

```json

{

    "apiKey": "",

    "calendars": [

        "[email protected]",

        "[email protected]"

    ]

}

```

You'll first need a Google Calendar API key, which you can find [here on their developer site](https://developers.google.com/calendar). Place that in the secrets file as the `"apiKey"`.

You'll also need to configure each calendar you want Frieden to proxy in the following way:

1. Set "Access Permissions" in calendar settings to be public, and "see only free/busy details" at least (if not full details)

2. Grab the calendar ID (commonly the user email if it's their primary calendar) and place it in `./secrets.json`

With these permissions, Frieden should be able to access the free/busy details of your calendars.