Pronote Discord Bot
Un bot Discord très simple qui envoie des notifications dans un salon sur Discord lorsqu'un devoir ou une note est ajouté sur Pronote, ou lorsqu'un enseignant est absent ! 📚
Si vous êtes plus à l'aise avec Python vous pouvez également utiliser le bot de busybox11, qui sera surement compatible avec la dernière version de Pronote bientôt ! 💫
Information
Le bot utilise une API de Pronote non officielle. Index Eduction, l'entreprise possédant Pronote n'a pas donné son accord pour l'utilisation de cette API. Vous pouvez donc risquer des poursuites judiciaires si vous utilisez ce bot. Je ne suis pas responsable de vos actes.
Fonctionnalités
Ce bot incroyable peut vous permettre de réaliser plusieurs actions et d'avoirs des informations sur :
Notifications
- Vos nouvelles notes
- Indique le niveau de la note
- La meilleure note de la classe
- Une note au-dessus de la moyenne de la classe
- Indique votre note
- Indique la moyenne de la casse
- Indique la note la plus basse
- Et indique la note la plus haute
- Indique votre moyenne dans la matière
- Indique la moyenne de la *classe
- Indique le niveau de la note
- Puis pas extension, la moyenne générale
- Moyenne générale de l'élève
- Moyenne générale de la classe
- L'ancienne moyenne de l'élève
- L'ancienne moyenne de la *classe
- La modification qu'il y a eue pour l'élève
- La modification qu'il y a eue pour la classe
- Pour les devoirs
- La matière
- Le devoir
- La date pour le rendre
- Modification de cours
- Si le cours est annulé ou que le professeur est absent
- La matière
- Le professeur
- La date
- Nouvelles communications
- L'auteur de la communication
- Le titre de la communication
- Le contenu de la communication
- Outil de calcul de la note du bac automatique
- Calcule les notes obtenues au contrôle continu en première et en terminale
- Calcule la note obtenue aux épreuves données
- Applique les coefficients
Commandes
/configpour configurer le bot/contenupour afficher le contenu d'un cours/courspour avoir l'emploie du temps du jour/fichierpour afficher un fichier/graphvous donne un graphique des modifications d'une moyenne (classe/élève pour une matière ou non)/helppour avoir la liste des commandes/historyvous donne la liste des modifications d'une moyenne (classe/élève pour une matière ou non)/infospour avoir les informations sur le compte/logoutpour se déconnecter du compte/menupour avoir le menu du jour ⚠ ATTENTION COMMANDE EN DEV/notespour avoir les notes d'une matière/pingpour avoir le ping du bot et quelques informations/points-baccalcule automatiquement le nombre de points obtenu pour le bac/recheckpour forcer une vérification sur le moment
Installation
Node.js
Node.js est requis pour le bon fonctionnement du bot. Il faut donc aller le télécharger sur son site à la dernière version, c'est-à-dire la 16.x.X
Windows
- Cloner le repository (
git clone https://github.com/Merlode11/pronote-discord-bot) ou alors téléchargez la version compressée depuis GitHub - Renommer le fichier
.env.exampleen.envet le compléter. - Lancer le bot avec le ficher bat
start-pronote-bot.bat - C'est fini !
Mac/Linux Ou aussi Windows, ça fonctionne aussi très bien
Il y a juste une étape en plus, ne vous inquiétez pas
- Cloner le repository (
git clone https://github.com/Merlode11/pronote-discord-bot) ou alors téléchargez la version compressée depuis GitHub - Renommer le fichier
.env.exampleen.envet le compléter. - Installer les modules (
npm install) Via un terminal pointant vers le dossier du bot (cd EMPLACEMENT_DOSSIER) - Lancer le bot (
node index.js) - C'est fini !
Remplir son .env
PRONOTE_URL
Indiquez ici votre URL sur lequel vous accédez à pronote, sans le eleve.html et sa suite. Il faudra s'arrêter à /pronote/
Exemple:
https://0050006e.index-education.net/pronote/
PRONOTE_CASUniquement dans le cas où vous ne pouvez PAS vous connecter directement par Pronote, mais devez passer par une interface régionale spéciale.
Si vous pouvez vous connecter directement sur l'interface de Pronote, l'API devrait fonctionner PEU IMPORTE VOTRE ACADÉMIE
Sinon, l'API propose de se connecter à Pronote avec des comptes des académies suivantes :
CAS list
- Académie d'Orleans-Tours (CAS : ac-orleans-tours, URL : "ent.netocentre.fr") - Académie de Besançon (CAS : ac-besancon, URL : "cas.eclat-bfc.fr") - Académie de Bordeaux (CAS : ac-bordeaux, URL : "mon.lyceeconnecte.fr") - Académie de Bordeaux 2 (CAS : ac-bordeaux2, URL : "ent2d.ac-bordeaux.fr") - Académie de Caen (CAS : ac-caen, URL : "fip.itslearning.com") - Académie de Clermont-Ferrand (CAS : ac-clermont, URL : "cas.ent.auvergnerhonealpes.fr") - Académie de Dijon (CAS : ac-dijon, URL : "cas.eclat-bfc.fr") - Académie de Grenoble (CAS : ac-grenoble, URL : "cas.ent.auvergnerhonealpes.fr") - Académie de la Loire (CAS : cybercolleges42, URL : "cas.cybercolleges42.fr") - Académie de Lille (CAS : ac-lille, URL : "cas.savoirsnumeriques62.fr") - Académie de Lille (CAS : ac-lille2, URL : "teleservices.ac-lille.fr") - Académie de Limoges (CAS : ac-limoges, URL : "mon.lyceeconnecte.fr") - Académie de Lyon (CAS : ac-lyon, URL : "cas.ent.auvergnerhonealpes.fr) - Académie de Marseille (CAS : atrium-sud, URL : "atrium-sud.fr") - Académie de Montpellier (CAS : ac-montpellier, URL : "cas.mon-ent-occitanie.fr") - Académie de Nancy-Metz (CAS : ac-nancy-metz, URL : "cas.monbureaunumerique.fr") - Académie de Nantes (CAS : ac-nantes, URL : "cas3.e-lyco.fr") - Académie de Poitiers (CAS : ac-poitiers, URL : "mon.lyceeconnecte.fr") - Académie de Reims (CAS : ac-reims, URL : "cas.monbureaunumerique.fr") - Académie de Rouen (Arsene76) (CAS : arsene76, URL : "cas.arsene76.fr") - Académie de Rouen (CAS : ac-rouen, URL : "nero.l-educdenormandie.fr") - Académie de Strasbourg (CAS : ac-strasbourg, URL : "cas.monbureaunumerique.fr") - Académie de Toulouse (CAS : ac-toulouse, URL : "cas.mon-ent-occitanie.fr") - Académie du Val-d'Oise (CAS : ac-valdoise, URL : "cas.moncollege.valdoise.fr") - ENT "Agora 06" (Nice) (CAS : agora06, URL : "cas.agora06.fr") - ENT "Haute-Garonne" (CAS : haute-garonne, URL : "cas.ecollege.haute-garonne.fr") - ENT "Hauts-de-France" (CAS : hdf, URL : "enthdf.fr") - ENT "La Classe" (Lyon) (CAS : laclasse, URL : "www.laclasse.com") - ENT "Lycee Connecte" (Nouvelle-Aquitaine) (CAS : lyceeconnecte, URL : "mon.lyceeconnecte.fr") - ENT "Seine-et-Marne" (CAS : seine-et-marne, URL : "ent77.seine-et-marne.fr") - ENT "Somme" (CAS : somme, URL : "college.entsomme.fr") - ENT "Portail Famille" (Orleans Tours) (CAS : portail-famille, URL : "seshat.ac-orleans-tours.fr:8443") - ENT "Toutatice" (Rennes) (CAS : toutatice, URL : "www.toutatice.fr") - ENT "Île de France" (CAS : iledefrance, URL : "ent.iledefrance.fr") - ENT "Mon collège Essonne" (CAS : moncollege-essonne, URL : "www.moncollege-ent.essonne.fr") - ENT "Paris Classe Numerique" (CAS : parisclassenumerique, URL : "ent.parisclassenumerique.fr") - ENT "Lycee Jean Renoir Munich" (CAS : ljr-munich, URL : "cas.kosmoseducation.com") - ENT "L'Eure en Normandie" (CAS : eure-normandie, URL : "cas.ent27.fr") - ENT "Mon Bureau Numérique" via EduConnect (CAS: monbureaunumerique-educonnect, URL: "cas.monbureaunumerique.fr")PRONOTE_USERNAME et PRONOTE_PASSWORD
Indiquez ici votre identifiant (USERNAME) et votre mot de passe (PASSWORD) pour que le bot puisse se connecter à pronote via votre compte
⚠ Vous identifiants doivent rester PRIVÉES et personne ne doit y avoir accès. Faite attention à ne donner aucun de vos identifiants, ne pas donner directement le code. Vous pourriez par oubli donner vos identifiants. Faites bien attention de donner le code uniquement via ce repository
TOKEN
Indiquez ici le token de votre bot pour qu'il puisse se connecter à Discord. Allez dans le portail développeur et récupérez ici le token de votre bot
CHANNEL
Complétez toutes les variables finissant par CHANNEL par les identifiants des salons où seront envoyées les notifications :
HOMEWORKS_CHANNEL_IDLe salon pour les nouveaux devoirs à la maisonMARKS_CHANNEL_IDLe salon pour les nouvelles notesAWAY_CHANNEL_IDLe salon où seront envoyées les cours annulésINFOS_CHANNEL_IDLe salon pour les nouvelles informations (Communication & sondages)
AUTO_UPDATE
Vous devez indiquer ici si vous voulez que le bot se mette à jour automatiquement ou non. Si vous souhaitez que le bot se mette à jour automatiquement, mettez true sinon mettez false.
Une confirmation sera demandée si jamais le bot détecte une version plus récente de celle qu'il possède
Crédit
Le bot est à l'origine créé par @Androz2091. Je lui ai apporté une grande part de ma touche personnelle pour l'améliorer et le rendre plus utile que ce qu'il n'était.
Retours
Bugs
En cas de bug ou de problème d'installation vous pouvez ouvrir une Issue ou alors contactez-moi sur Discord: Merlode#8128
Suggestions
Si vous avez la moindre suggestion, proposez là dans les Issue, elles sont là pour ça
Merci
Merci à vous de me supporter dans cette aventure que je commence tout juste et si vous pouvez laisser une petite star ça ferait vraiment plaisir N'hésitez pas à partager ce bot à tous ceux qui en ont besoin !