#README Nooit meer handmatig inloggen op studievolg.hsleiden Geen eens ondersteuning voor mobiele apparaten! Dit simpele programmatje houd jou op de hoogte van jouw cijfers, geen gedoe, gewoon up to date zijn. Kies voor Telegram of email notificaties.
####Hoe werkt het?
- Het script logt voor jou in door een browser na te doen, en haalt hierdoor de "OSIRIS - Resultaten" pagina op.
- Deze wordt vervolgens doorgespit op cijfers, en vergelijkt deze met de cijfers van de vorige keer.
- Heb je een nieuw cijfer(s)? Dan krijg je via jouw Telegram bot of jouw email een notificatie
##Requirements:
- Telegram
- Python 2.7
- Klein beetje tijd
##Setup
Installeer de dependencies van het programmatje door:
sudo pip install -r requirements.txt
of
sudo pip2.7 install -r requirements.txt
als je ook python 3.x geinstalleerd hebt
Kopieer/hernoem config.json.example naar config.json.
Vul hier jouw student gegevens in, je gewenste interval (minuten), en de tekst die de bot stuurt bij de melding.
Start main.py
###Telegram Maak een nieuwe telegram bot aan via @BotFather: https://core.telegram.org/bots#6-botfather en vul de token in config.json in, zorg ervoor dat de velden gmailusername en gmailpassword leeg zijn (Op dit moment kan je nog niet beide tegelijk ontvangen) Als je een nieuwe bot hebt aangemaakt kan je het gesprek met de bot beginnen door te klikken op het linkje die de BotFather opstuurt.
###E-Mail In plaats van telegram kan je ook gebruik maken van e-mail. Zorg er dan voor de je het telegram token veld leeg laat. Vul jouw juiste mail gegevens in, In plaats van jouw eigen gmail wachtwoord kan je ook een applicatie-specifiek wachtwoord aanmaken https://security.google.com/settings/security/apppasswords Vul de juiste ontvanger(s) in (dit kunnen meerdere zijn, als je het als list invoert) Gebruik voor email_server en email_port die van jouw email adres.
Voor bijvoorbeeld gmail is dat smtp.gmail.com
met port 587
##Start
Start de applicatie met python main.py
of met python main.py & disown
om het programma op de achtergrond te laten draaien
Je kan ook bij het opstarten van je machine het programma laten uitvoeren door een regel in de crontab te zetten
sudo crontab -e
En vervolgens bijvoorbeeld voor een standaard raspberry pi installatie:
@reboot python /home/pi/studievolg_scraper/main.py
als dit niet werkt moet je het commando hierboven gebruiken
Om de bot automatisch een notificatie naar jou te laten sturen moet je 1x /start
zeggen tegen de bot,
de chat_id zal dan worden opgeslagen, en zolang je die niet weg haalt uit je config.json weet hij jou te vinden.
Dit commando wordt uitgevoerd als je op "Begin" drukt in de chat met de bot.
##Commands Maak gebruik van het toetsenbord dat wordt opgestuurd door de bot. Op dit moment zijn er 2 mogelijkheden: '/all': dit geeft de laatste 15 cijfers terug '/latest': dit geeft jouw laatste cijfer terug
Als je de bot wilt helpen uitbreiden kan je een PR maken