Nodeliad è un bot Telegram realizzato in Node.js per monitorare i consumi della propria linea Iliad.
Il progetto è nato per via della mancanza di un'app ufficiale per iOS che costringe gli utenti a controllare i consumi dal PC o attraverso il sito sotto rete Iliad per evitare di dover effettuare il login.
- 💰 controllo del credito residuo
- ⏰ controllo della data di rinnovo
- 🗓 notifica automatica prima del rinnovo
- 🇮🇹 controllo dei consumi effettuati in Italia
- 🌎 controllo dei consumi effettuati all'estero
- 💶 controllo consumi e costi extra in Italia
- 💵 controllo consumi e costi extra all'estero
/credito
/consumi
/consumiestero
/costiextra
/costiextraestero
- Clonare il repository con
git clone https://github.com/Nicuz/Nodeliad.git
oppure cliccando sul bottone in alto a destraClone or Download
- Entrare nella directory di Nodeliad
- Installare le dipendenze con
npm install
- Rinominare il file
.env.template
in.env
e modificarlo inserendo i propri dati di accesso al sito di Iliad, il token del vostro bot fornito da BotFather, il vostro id di Telegram ottenibile con rawdatabot e quanti giorni prima del rinnovo volete essere avvisati. L'id viene utilizzato per fare un controllo sull'utente che invia un comando, il bot fornirà i dettagli sulla linea solo all'utente con l'id specificato. - Compilare il bot con
npm run build
- Avviare il bot con
node bot.js
Questa sezione è pensata per i meno pratici di git che quindi non conoscono tutti i suoi comandi e funzionalità. Ogni volta che una nuova versione del bot viene rilasciata, è possibile scaricare automaticamente i file che sono stati aggiornati entrando nella cartella in cui avete clonato il repo e lanciando il comando git pull
. Il file .env
che avete creato rimarrà al suo posto senza subire cambiamenti e non perderete alcun tipo di configurazione.
Un metodo semplice ed efficace per aggiornare la lista delle dipendenze nel caso dovessero essere aggiunti o rimossi dei moduli consiste nell'eliminare la cartella node_modules
e lanciare il comando npm install
.
Terminato l'aggiornamento vi basterà riavviare il bot.
Se volete gestire il bot tramite PM2, dopo aver creato il file .env
eseguite il comando pm2 start pm2-ecosystem.config.js
Se volete usare Docker, dopo aver clonato il repository e modificato il .env
effettuate una docker build:
docker build . -t nodeliad
Terminata la build avviate il bot:
docker run -it --name=nodeliad-bot nodeliad
- Lanciare il comando
whereis node
per trovare il binario di node, nel mio caso/usr/local/bin/node
sudo nano /etc/systemd/system/nodeliad.service
e incollare il testo seguente avendo l'accortezza di modificare il path del binario di node e quello dello del bot.
Description=Nodeliad Bot
After=network.target
[Service]
Type=idle
ExecStart=/path/binario/node /path/nodeliad/dist/bot.js
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable nodeliad
sudo systemctl start nodeliad
Se tutto è stato configurato correttamente, lanciando il comando sudo systemctl status nodeliad
vedrete che il servizio è in esecuzione 💪
Consultare CHANGELOG.md