ucltt-ics is a HTTP-based iCalendar interface for the timetable system used at UCL so that it can be synced to "normal" calendar software. It is fairly crude, but seems to work mostly the way it should. Username and password is set in config or passed through HTTP basic authentication.
If a username is set in the config, HTTP basic auth is completely disabled.
If you want to use this with Google Calendar which doesn't support HTTP Basic Auth, you should just set a fixed username and password in the config.
Note that this server runs over HTTP, which means passwords are transmitted in cleartext if you use basic auth. Just something to bear in mind.
To run:
export UCL_USERNAME=...
export UCL_PASSWORD=...
npm start
You will then be able to access the iCalendar at http://yourdomain.com:54321/ and can put that URL straight into your calendaring application to have it synced. Beware that since this is doing web scraping, you might not want to scrape it too often.
The app is built so it can be run off Heroku. If you don't know what that is or how to do it, you can either follow the Heroku guide or follow these quick steps:
- Sign up
heroku loginheroku create <app name>git push heroku masterheroku ps:scale web=1heroku config:add UCL_USERNAME=<your_username>heroku config:add UCL_PASSWORD=<your_password>heroku open
Enjoy free hosting of the app.
Well, I was annoyed at having to log in to the UCL Timetable portal all the time, so I figured I'd do something about it. Had I taken the time to actually look around for a bit, I would have noticed that there was already a WebCal subscription URL built in, but I didn't see that until I'd finished. At least I got the experience of getting to play with Node and Heroku.