Skip to content

A tool that notifies you when courses at EPFL are available for registration.

Notifications You must be signed in to change notification settings

Maeeen/shs-notifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SHS Notifier npm version works on my machine

⚠️ This project is meant to be used on EPFL's IS-Academia. No support will be given on any other ISA infrastructures.

Demo

Demonstration

Its goal

Its goal is to detect when a course is going to be available by polling ISA's website, and notifying when one or multiple courses are available.

How to install?

Via npm

  • Install node.js
  • Install shs-notifier via npm: npm i -g shs-notifier

Clone it

  • Install node.js
  • Open up a terminal and clone the project (git clone https://github.com/Maeeen/shs-notifier), then type cd shs-notifier
  • npm i

How to use?

There is two ways to use this tool. The first one involves following an interactive CLI and the other one is suited for server deployment via command-line arguments.

Interactive CLI version

  • Simply execute the program (node . if you cloned, or npx shs-notifier via npm)
  • Follow the instructions! I hope it is friendly enough.

Command-line arguments

    -h, --help                 : Prints this
    --cookie=<cookie>          : Log in with this isa-cookie (mandatory or --creds)
    --creds=<user>*<pass>      : Log in with the given credentials (mandatory or --cookie)
    --watch=<course_ids>       : Watch courses with the given courses' id, separated by commas
    --discord-webhook-url=<url>: Will trigger the given discord's webhook when the course is available
    --spam-discord             : Spam the webhook instead of only one send. Default=false
    --disable-desktop-notify   : Disables desktop notification
    --polling-interval=<int>   : The polling interval, in milliseconds. Default=5000
    --tg-creds=<token>*<id>    : Bot token and dst chat id, update and activate telegram bot.

Code quality

This is not a well written program, and to be honest, I do not care. There is maybe 4 comments in the whole project. And oh yeah, I am a lazy guy.

Project's name origin

Anyone at EPFL can guess it lol.

Contributing

See the contributing page

About

A tool that notifies you when courses at EPFL are available for registration.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published