RoboEdu

Come funziona?

Le registrazioni partono dallo script roboEdu.sh, che recupera gli orari delle lezioni dall'endpoint pubblico di unibo.it e assegna ad ogni lezione selezionata un sottoprocesso, che aspetta l'inizio della lezione, fa partire la registrazione e la ferma. Quando mancano 10 minuti dall'inizio della lezione, viene affittato un server sul cloud di Hetzner attraverso Terraform, utilizzando la chiave fornita in secrets/hcloud_key. Con ansible viene preparato il server, installando pacchetti e trasferendo gli script necessari, dopodiché viene fatta partire la registrazione vera e propria.
Per unirsi alla lezione viene automatizzato il browser Chromium con Puppeteer, utilizzando le credenziali fornite in secrets/unibo_login.yml per accedere.
Vengono catturati degli screenshot ogni minuto per controllare che la registrazione prosegua correttamente e vengono trasferiti in screencaps/.
Le registrazioni vengono codificate con H.265 per ottimizzare lo spazio occupato, questo significa che sarà necessario utilizzare dei media player che supportano questo formato, quali VLC o MPV.
Una volta terminata la lezione, dopo 10 minuti viene scaricata la registrazione nella cartella regs/.

Dipendenze

• OpenSSH
• jq
• terraform
• ansible >= 2.8.0 (versioni precedenti potrebbero non riconoscere correttamente la versione di Python usata)
• telethon (installabile via pip, necessario solo se si desidera l'integrazione con Telegram)

Come far partire le registrazioni

• crea secrets/unibo_login.yml con variabili username, password, ad esempio:

username: "nome.cognome@studio.unibo.it"
password: "la_mia_password"

• crea secrets/hcloud_key contenente solo il token per le API di Hetzner
• lancia lo script con ./roboEdu.sh <nome_corso> <anno>, oppure lancia ./roboEdu.sh -h per ottenere le opzioni disponibili

Come automatizzare le registrazioni

Per rendere tutto questo automatico è consigliato preparare un cron job che lancia lo script ogni giorno prima dell'inizio della prima lezione. Un esempio potrebbe essere il seguente:

#!/bin/bash
mkdir -p /var/log/roboEdu/
/path/to/roboEdu.sh <nomecorso> <anno> >> /var/log/roboEdu/<nomecorso>-<anno>-$(date '+%y%m%d').log 2>&1

Come inviare le registrazioni su Telegram

• Vai su my.telegram.org, accedi con il tuo account Telegram, entra nella sezione API development tools e crea una App. Una volta creata, copia api_id e api_hash e copiali in secrets/telegram_api.yml, ad esempio:

api_id: 123456
api_hash: 'qwertyuiopasdfghjklzxcvbnm'

• Inserisci in materie.txt l'elenco delle materie registrate, in modo da inserire un tag nella descrizione dei messaggi inviati su Telegram. Se una materia non viene trovata in questo file verrà comunque mandata, ma senza tag. Essendo tag, i nomi devono essere senza spazi. ad esempio:

12355: SistemiOperativiM
12300-1: InternetOfThings1
12300-2: InternetOfThings2

• Esegui python3 utils.py sul computer in modo da generare la sessione necessaria per accedere automaticamente a Telegram. Quando richiesto inserisci il tuo numero di cellulare e il codice di verifica.
• Ottieni l'ID del gruppo/contatto/canale a cui inviare eseguendo python3 utils.py <filtro> dove <filtro> è il nome del contatto da cercare. Ad esempio, per cercare il canale Registrazioni ing info esegui python3 utils.py ing info o simili. NB: il contatto/canale/gruppo deve essere già nella tua lista dei contatti.
• Aggiungi allo script il parametro -T con di seguito l'ID del destinatario al quale inviare a registrazione (anche il tuo stesso id utente se vuoi mandarlo nei tuoi messaggi salvati).