README.md

Homie

Homie is a simple command line application, that can sync tasks from multiple sources (Google Classroom or KRÉTA) to a Todoist to-do list. It's designed to run with cron every x minutes.

Setup

• From the Google Developers Console, set up a new API project with the Classroom api. Go to the Credentials tab, and download the credentials.json for the type Web application

• Download the latest executable from the releases page, or, clone this repo and cd to the bin/ folder.

• Place the credentials.json you downloaded in the same folder as homie.dart or the executable.

• Open credentials.json. Add two sections:

  1. an entry named 'todoist', and a child to it named 'token', with your api token (get it from here):

  "todoist": {
   "token": "your-api-token-here"
  }

  2. an entry named 'kreta', with your KRÉTA login deitails:

  "kreta": {
   "username": "username",
   "password": "password",
   "schoolCode": "klikXXXXX"
  }

• At the end, credentials.json should look something like this:

{
    "installed": {
        "client_id": "",
        "project_id": "",
        "auth_uri": "",
        "token_uri": "",
        "auth_provider_x509_cert_url": "",
        "client_secret": "",
        "redirect_uris": [
            "",
            ""
        ]
    },
    "todoist": {
        "token": ""
    },
    "kreta": {
        "username": "",
        "password": "",
        "schoolCode": ""
    }
}

• Start the executable with dart homie.dart or ./homie.exe. The first time you run the program, it will prompt you with a Google auth dialog in your browser. Follow the steps, then copy-paste the code into the terminal. After this, it'll automatically refresh the token every time, you don't need to do anything.

Thanks to

• @bczsalba: Name suggestion

This is an unofficial client for KRÉTA.