If you need help with configuring Roombelt just to go to roombelt.com and ask for help using the chat widget.

Prerequsites

Roombelt is a Node.js application. We recommend installing Node.js 8.11.2 or newer with npm 5.6.0 or newer. You can download them from this website.

Roombelt uses Google API to authenticate users and access their calendars. You need to create your own project on Google Cloud Platform. This way you can be sure that nobody outside of your company will have access to your private data.

Create and configure project on Google Cloud Platform

  1. Create new project using the Create Project button.

  2. In the new project go to API Library and enable the following API-s

    • Google Calendar API

    • Google+ API

  3. Go to OAuth consent screen and set Product name shown to users to value Roombelt

  4. Go to Credentials and click Create Credentials -> OAuth client ID

    • Choose Application type to value Web application

    • Set Authorized redirect URIs to http://localhost:3000/api/oauth/callback

    • Click Save

    • Save Client ID and Client secret somewhere - you will need them in a moment

Install and configure Roombelt

Run the following in order to install the newest version of Roombelt.

$ npm install --global roombelt

In current directory create a file called roombelt.env with the following content

GOOGLE_CLIENT_ID=<CLIENT ID OF YOUR GOOGLE APP>
GOOGLE_CLIENT_SECRET=<CLIENT SECRET OF YOUR GOOGLE APP>
GOOGLE_REDIRECT_URL=http://localhost:3000/api/oauth/callback
DATABASE_URL=sqlite:roombelt.sqlite

Run the app

Just run the following command in the directory with file roombelt.env and roombelt should be available on http://localhost:3000.

$ roombelt