gcal-sync

Go to this page and create as many ics calendars as you want to sync. You can create a ics calendar to sync everything, or one calendar per list.
Leave this browser tab open because you'll need the ics links in the next steps.

Go to the google apps script and create a new project by clicking in the button showed in the next image.
It would be a good idea to rename the project to something like "gcal-sync".

Click on the initial file, which is the rectangle-1 on the image.

Replace the initial content present in the rectangle-2 with the gcal-sync code provided bellow.

⚠️ Warning
Remember to update the configs object according to your data and needs.

function getConfigs() {
  const configs = {
    settings: {
      sync_function: 'sync',                // function name to run every x minutes
      timezone_offset_correction: 0,        // hour correction to match maybe a daylight saving difference (if you want the events 1 hour "before", then put -1)
      update_frequency: 5,                  // wait time between sync checks (must be multiple of 5: 10, 15, etc)
      skip_mode: false,                     // if set to true, it will skip every sync (useful for not messing up your data if any bug occurs repeatedly)
      per_day_emails: {
        time_to_send: '22:00',              // time to email the summary
        email_daily_summary: false,         // email all the actions done in the day on the above time
        email_new_gcal_sync_release: false, // check one time per day and email when a new gcal-sync version is released on the above time
      },
      per_sync_emails: {
        email_errors: false,                // email when some error occurs
        email_session: false                // email when any item was added, updated or removed from your gcal
      }
    },
    github_sync: {
      username: 'lucasvtiradentes',         // github username
      personal_token: '',                   // github token, required if you want to sync private repo commits
      commits_configs: {
        should_sync: true,                  // controls if the github commits sync should be done
        commits_calendar: 'gh_commits',     // google calendar to insert commits as events
        ignored_repos: ['github-assets'],   // ignored repositories string array: ['repo1', 'repo2']
        parse_commit_emojis: true           // parse string emojis (:tada:) to emojis (✨)
      }
    },
    ticktick_sync: {
      should_sync: true,                    // controls if the ticktick sync should be done
      ics_calendars: [
        {
          link: 'webcal://link_A',          // all items from ticktick will be added to 'tasks' cal and, when completed, moved to 'done'
          gcal: 'tasks',
          gcal_done: 'done',
        },
        {
          link: 'webcal://link_B',          // all items from ticktick will be added to 'tasks' cal and, when completed, moved to 'done_healthy'
          gcal: 'tasks',
          gcal_done: 'done_healthy',
          tag: "HEALTHY"                    // this is a flag where we can "mark" tasks from this config to be ignored on other ics_calendars
        },
        {
          link: 'webcal://link_C',          // all items from ticktick, except the tasks marked with HEALTHY, will be added to 'tasks' cal and,  when completed, moved to 'done'
          gcal: 'tasks',
          gcal_done: 'done',
          ignoredTags: ['HEALTHY']
        }
      ]
    }
  };
  return configs
}

function getGcalSync(){

  let gcalSync;
  const configs = getConfigs()
  const useDevVersion = false

  if (useDevVersion){
    const GcalSync = getGcalSyncDev()
    gcalSync = new GcalSync(configs);
  } else {
    const version = "1.11.0"
    const gcalSyncContent = UrlFetchApp.fetch(`https://cdn.jsdelivr.net/npm/[email protected]`).getContentText();
    eval(gcalSyncContent)
    gcalSync = new GcalSync(configs);
  }

  return gcalSync;
}

function install() {
  const gcalSync = getGcalSync();
  gcalSync.install();
}

function uninstall() {
  const gcalSync = getGcalSync();
  gcalSync.uninstall();
}

function sync(){
  const gcalSync = getGcalSync()

  try{
    console.log(gcalSync.sync())
  } catch(e){
    gcalSync.handleError(e)
  }
}

function doGet(reqParams) {
  const gcalSync = getGcalSync()

  const response = {
    sessionData: {},
    logs: [],
    error: null
  }

  try {
    response.sessionData = gcalSync.sync()
    response.logs = gcalSync.getSessionLogs()
  } catch (e){
    response.error = e
    gcalSync.handleError(e)
  }

  return ContentService.createTextOutput(JSON.stringify(response)).setMimeType(ContentService.MimeType.JSON)
}

if you want to change the google event color, you can choose from 12 options:

1   -> blue
2   -> green
3   -> purple
4   -> red
5   -> yellow
6   -> orange
7   -> turquoise
8   -> gray
9   -> bold blue
10  -> bold green
11  -> bold red

Go to the project settings by clicking on the first image rectangle. After that, check the option to show the appsscript.json in our project, a file that manages the required google api access.

Go back to the project files, and replace the content present in the appsscript.json with the following code:

{
  "timeZone": "Etc/GMT",
  "dependencies": {
    "enabledAdvancedServices": [
      {
        "userSymbol": "Calendar",
        "serviceId": "calendar",
        "version": "v3"
      }
    ]
  },
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.scriptapp",
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/calendar",
    "https://www.googleapis.com/auth/tasks",
    "https://www.googleapis.com/auth/script.send_mail",
    "https://www.googleapis.com/auth/userinfo.email"
  ],
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "webapp": {
    "executeAs": "USER_DEPLOYING",
    "access": "ANYONE_ANONYMOUS"
  }
}

Just follow what the bellow image shows, which is to select the install function and run it.
After, a popup will appear asking your permission, and you'll have to accept it.

It will allow you to sync whenever you go to a generated link.
Just do as the image shows.

# Clone this repository
$ git clone https://github.com/lucasvtiradentes/gcal-sync

# Go into the repository
$ cd gcal-sync

# Install dependencies
$ npm install

If you want to contribute to the project, fork the project, make the necessary changes, and to test your work on google apps scripts with do this:

1. run npm run build in order to generate the dist files. After that, create a new GAS file (ex: dev_gcal.gs) and paste the content of gcalsync_dev on this new GAS file.

2. after that, update the content of the getGcalSync as specified bellow:

function getGcalSync() {
  // ...
  const useDevVersion = true; // set this to true to use your gcal-sync version

  if (useDevVersion) {
    const GcalSync = getGcalSyncDev(); // your work is here
  }
  // ...
}

now you can test your work really easy on production/GAS!