Notes

Putting my semester in my calendar

Canvas deadlines, NUSMods classes and exams in my Google Calendar, without typing any of it in.

I rely on my calendar a lot, and if something isn't in it, there's a good chance I'll forget about it. As a student, a big part of my life is classes, deadlines and exams, but none of them ended up in my calendar on their own. Deadlines lived on Canvas, my timetable lived on NUSMods, and I'd been meaning to build something that put them together for a really long time.

I was already working on it when a friend, Kei Lok, launched his own product, Cue, a free terminal autocomplete for Apple Terminal and VS Code (go support him!). Seeing that made me rush to get mine out the same day. Positive peer pressure, I guess.

Semsync takes your Canvas calendar link and your NUSMods timetable link and puts your deadlines, classes and exams into Google Calendar. It checks Canvas every hour, so if a deadline moves, it moves in your calendar too.

I built it for myself first and then shared it with people around me. I'm not really pushing it, but it's been nice to see about ten real people using it so far.

The part that took longest

Surprisingly, it wasn't Canvas or NUSMods. It was Google sign-in, and working out how much access Semsync should ask for.

My first version asked for access to your whole calendar. Google counts that as sensitive, so everyone signing in was shown a warning that the app wasn't verified, and an unverified app asking for that much can only have 100 users. Getting verified means going through Google's review process, which felt like a lot for a side project.

What fixed it was asking for less. There's a permission that only lets an app manage calendars it created itself, and since that one doesn't need a review, Semsync now makes its own "NUS semester" calendar and only ever touches that. The warning and the 100-user cap both went away, and as a bonus, Semsync can't see anything else in your calendar. The catch was that I made the change on launch day, so the first few people who had signed up had to connect Google one more time.

The first feedback

It came as a GitHub issue from a friend. Semsync used to remind you a day and three hours before every deadline, and they wanted an earlier heads-up for bigger assignments, along with a way to stop the reminders once something was handed in. Both were in two days later, so you can now choose your own reminder times and tick off a deadline to stop its reminders.

Where it is now

I like it a lot, and I'll definitely be using it for a long time to come. If I add anything, it might be reading Canvas announcements and pulling the dates out of them, but that would need a Canvas API token, which is a lot more access than a calendar link, so I haven't decided yet. I've also wondered about opening it up to other universities, which I'm still thinking about.

It's free at semsync.live, and the code is on GitHub.