Intégration domotique PRONOTE, gratuite et open source
Notes, devoirs, emploi du temps et absences PRONOTE, avec déclencheurs de scènes et widgets.
Publiée par prohand
- Appareils
- Version 0.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration amène PRONOTE, le logiciel de vie scolaire de la plupart des établissements français, dans Gladys : notes, devoirs, emploi du temps, absences et messages non lus d'un élève — ou de chaque enfant d'un compte parent.
Elle lit PRONOTE comme le fait l'application PRONOTE, toutes les quelques minutes, et publie ce qu'elle trouve sous forme d'appareils Gladys, de déclencheurs de scènes et de widgets de tableau de bord.
PRONOTE et Index Éducation ne sont pas impliqués dans cette intégration. Elle utilise la bibliothèque libre pawnote pour dialoguer avec PRONOTE.
Prérequis
- Gladys 5.1 ou plus récent.
- Un compte PRONOTE élève ou parent (les comptes enseignants ne sont pas pris en charge).
- L'adresse de votre espace PRONOTE, telle que l'affiche votre navigateur, par
exemple
https://0123456a.index-education.net/pronote/.
Configuration
Dans Gladys, ouvrez Intégrations → PRONOTE → Configuration.
| Champ | Quoi mettre |
|---|---|
| Adresse PRONOTE | L'adresse de l'espace PRONOTE. La fin (eleve.html, parent.html) n'est pas nécessaire. |
| Type de compte | Élève pour un compte élève, Parent pour un compte parent (un appareil par enfant). |
| Identifiant / Mot de passe | Votre identifiant et votre mot de passe PRONOTE. |
| Intervalle de rafraîchissement (min) | Fréquence de lecture de PRONOTE. 15 minutes suffisent ; le serveur est partagé par tout l'établissement. |
| Horizon des devoirs | Nombre de jours à l'avance pour compter et lister les devoirs à faire (7 par défaut). |
| Fuseau horaire de l'établissement | Europe/Paris par défaut. Outre-mer : Indian/Reunion, America/Martinique, Pacific/Noumea… |
| Journaux détaillés | À activer pour comprendre un problème, puis à désactiver. |
Enregistrez, puis appuyez sur Tester la connexion : elle indique qui est connecté et ce qui a été trouvé pour chaque élève.
Après la première connexion, PRONOTE donne à l'intégration un jeton de session qui remplace le mot de passe pour les connexions suivantes, comme le fait l'application mobile PRONOTE. Il est gardé dans le stockage propre à l'intégration.
Comptes qui se connectent par un ENT
Si vous accédez à PRONOTE par l'ENT de votre région (Mon Bureau Numérique, ENT77, Skolengo…), vous n'avez pas de mot de passe PRONOTE. Utilisez un QR code :
- Dans PRONOTE, sur un ordinateur, ouvrez le menu à côté de votre nom et choisissez QR code pour l'application mobile. Choisissez un code à 4 chiffres.
- Scannez le QR code avec l'appareil photo du téléphone (pas avec l'application
PRONOTE) : le téléphone affiche un texte qui commence par
{"jeton". Copiez-le. - Dans Gladys, appuyez sur Se connecter avec un QR code, collez le texte et saisissez le code à 4 chiffres. Faites vite : le QR code n'est valable que quelques minutes.
Laissez vides les champs adresse, identifiant et mot de passe, ou ne renseignez que l'adresse. La session est ensuite gardée comme après une connexion par mot de passe.
Appareils
Appuyez sur Découvrir (ou attendez la première lecture) pour voir les appareils, puis créez-les.
Un appareil par élève :
| Fonctionnalité | Valeur |
|---|---|
| Overall average | La moyenne générale de la période en cours, sur 20 (quand l'établissement l'affiche). |
| Homework to do | Les devoirs pas encore faits, à rendre dans l'horizon des devoirs. |
| Homework for the next school day | Les devoirs pas encore faits, pour le prochain jour de cours. |
| Absences (period) | Les absences de la période en cours. |
| Delays (period) | Les retards de la période en cours. |
| Next lesson | Texte, par exemple 14:00 MATHEMATIQUES (B12) (avec la date si ce n'est pas aujourd'hui). |
| Next school day start | Texte, par exemple 08:00 : le premier cours maintenu du prochain jour de cours. |
| Last grade | Texte, par exemple MATHEMATIQUES 15/20 (12/10). |
Les noms des fonctionnalités sont en anglais à la création ; vous pouvez les renommer dans Gladys.
Un appareil pour le compte : le nombre de messages non lus.
Les appareils sont en lecture seule : rien n'est modifié dans PRONOTE.
Scènes
Déclencheurs
| Déclencheur | Quand | Variables |
|---|---|---|
| Une nouvelle note est publiée | Une note est apparue depuis la lecture précédente. | nom de l'élève, matière, note, sur, note sur 20, note telle qu'écrite, coefficient, moyenne de la classe, commentaire, date |
| Un nouveau devoir est donné | Un devoir est apparu ou a changé. | nom de l'élève, matière, description, pour le |
| Un cours est annulé | Un cours des prochains jours est désormais annulé. | nom de l'élève, matière, date, heure de début, heure de fin, statut PRONOTE |
| Une absence ou un retard est saisi | L'établissement a saisi une absence ou un retard. | nom de l'élève, type (absence / delay), date, justifié (yes / no), minutes de retard, motif |
Chaque déclencheur peut être limité à un élève. La première lecture après l'installation ne fait que mémoriser ce qui existe déjà : rien n'est annoncé pour les notes des semaines passées.
Actions
- Lire PRONOTE maintenant : met à jour appareils et widgets tout de suite. Les nouveautés trouvées sont annoncées par les déclencheurs à la lecture programmée suivante.
- Obtenir la journée d'un élève : pour aujourd'hui, demain ou le prochain jour de cours, donne le nombre de cours, le début du premier, la fin du dernier, les matières annulées, et les devoirs à faire sous forme de liste prête à être lue à voix haute.
Exemple : chaque jour de semaine à 07:00 → Obtenir la journée d'un élève (prochain jour de cours) → Dire « Premier cours à {{first_lesson}}. Devoirs : {{homework_text}} ».
Widgets
- Élève PRONOTE : moyenne, devoirs à faire, absences, prochain cours, prochain jour de cours, dernière note, messages non lus, et la liste des devoirs. Un bouton Actualiser relit PRONOTE.
- Emploi du temps PRONOTE : les cours d'aujourd'hui, de demain ou du prochain jour de cours, avec les cours annulés et les contrôles signalés.
Les deux affichent la dernière lecture : ouvrir un tableau de bord n'interroge jamais PRONOTE.
Boutons de l'écran de configuration
- Tester la connexion : lit PRONOTE et dit ce qui a été trouvé, ou pourquoi pas.
- Se connecter avec un QR code : voir plus haut.
- Oublier la session enregistrée : supprime le jeton de session enregistré (pour changer de compte, ou après un changement de mot de passe ailleurs).
Dépannage
| Message | Que faire |
|---|---|
| PRONOTE a refusé l'identifiant ou le mot de passe | Vérifiez-les sur le site PRONOTE. La lecture est suspendue jusqu'à l'enregistrement de la configuration ou un test. |
| PRONOTE demande de configurer la sécurité | Connectez-vous une fois dans l'application ou le site PRONOTE pour la terminer (nouveau mot de passe, PIN), puis utilisez le QR code. |
| L'adresse IP a été suspendue | Trop d'échecs de connexion : patientez (en général une heure) avant de réessayer. |
| Le serveur est injoignable | Vérifiez l'adresse. Un serveur occupé est réessayé à la lecture suivante. |
Activez Journaux détaillés pour voir chaque étape dans les journaux de l'intégration. Les mots de passe et jetons ne sont jamais journalisés.
Limites connues
- Comptes parents avec plusieurs enfants : l'emploi du temps est lu pour chaque enfant, mais pour les notes, devoirs et absences PRONOTE peut répondre pour l'enfant qu'il sélectionne par défaut. Si deux enfants affichent les mêmes notes, utilisez plutôt le compte élève de chaque enfant.
- Les comptes enseignants ne sont pas pris en charge.
- PRONOTE n'a pas de notifications : les nouveautés sont trouvées à chaque lecture, une nouvelle note apparaît donc dans l'intervalle de rafraîchissement.
Vos données
Le mot de passe reste dans la configuration secrète de Gladys. Le jeton de session est gardé dans le stockage privé de l'intégration ; notes, devoirs et emploi du temps ne sont gardés qu'en mémoire et publiés dans votre Gladys. Rien n'est envoyé ailleurs.
Paramètres de configuration
Voici les paramètres demandés par PRONOTE dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | L'intégration lit votre espace PRONOTE sur le serveur de l'établissement, comme le fait l'application PRONOTE : notes, devoirs, emploi du temps, absences et messages non lus. Renseignez l'adresse de l'espace PRONOTE (celle que vous ouvrez dans un navigateur), le type de compte, votre identifiant et votre mot de passe, puis enregistrez. Si vous vous connectez par un ENT (pas de mot de passe PRONOTE), laissez le mot de passe vide et utilisez le bouton « Se connecter avec un QR code » plus bas. |
| Adresse PRONOTE | string | Non | L'adresse de l'espace PRONOTE, telle que l'affiche le navigateur, par exemple https://0123456a.index-education.net/pronote/. La fin de l'adresse (eleve.html, parent.html) n'est pas nécessaire. |
| Type de compte | select | Non | Élève : un élève. Parent : chaque enfant du compte, un appareil chacun. |
| Identifiant | string | Non | |
| Mot de passe | secret | Non | Utilisé seulement quand il n'y a pas de session enregistrée : après la première connexion, PRONOTE donne un jeton de session qui le remplace, gardé dans le stockage propre à l'intégration. |
| Intervalle de rafraîchissement (min) | number | Non | Fréquence de lecture de PRONOTE, en minutes. Le serveur est partagé par tout l'établissement : 15 minutes suffisent largement pour les notes et les devoirs. |
| Horizon des devoirs (jours) | number | Non | Nombre de jours à l'avance pour compter et lister les devoirs à faire. |
| Fuseau horaire de l'établissement | string | Non | PRONOTE donne les heures sans fuseau horaire : elles sont lues dans celui-ci. Un nom IANA, par exemple Europe/Paris, Indian/Reunion, America/Martinique. |
| Journaux détaillés (debug) | boolean | Non | Journalise chaque étape des lectures PRONOTE. Les mots de passe et jetons ne sont jamais journalisés. |
Comment installer PRONOTE dans Gladys
- Dans Gladys, ouvrez Intégrations : PRONOTE apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-pronote:0.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-pronote.
PRONOTE nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
PRONOTE est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation