Carnet scolaire — PRONOTE et EcoleDirecte pour Home Assistant
Carnet scolaire est une intégration Home Assistant permettant d'intégrer PRONOTE et EcoleDirecte directement dans votre installation domotique.
Retrouvez dans Home Assistant les informations scolaires de vos enfants : emploi du temps, devoirs, notes, moyennes, absences, retards, évaluations, actualités, discussions, menus et bien plus encore.
L'intégration est conçue pour les élèves comme pour les parents utilisant un compte PRONOTE, EcoleDirecte ou un ENT.
🏫 Votre établissement utilise une autre plateforme ? Carnet scolaire est conçu pour accueillir plusieurs sources : PRONOTE et EcoleDirecte sont les deux premières. Si l'ENT ou le logiciel de vie scolaire de vos enfants n'est pas encore pris en charge, ouvrez un ticket en indiquant la plateforme, le type de compte (parent ou élève) et les données qui vous seraient utiles. Chaque demande aide à choisir la prochaine source à intégrer.
✨ Fonctionnalités
📅 Vie scolaire
- Emploi du temps
- Prochains cours
- Devoirs
- Notes et moyennes
- Évaluations par compétences
- Absences
- Retards
- Punitions
- Bulletins
- Actualités
- Discussions
- Menus de cantine
- Informations sur le personnel
🤖 Automatisations Home Assistant
Carnet scolaire s'intègre nativement dans le moteur d'automatisation de Home Assistant.
Vous pouvez notamment créer des automatisations lorsqu'une nouvelle note apparaît, lorsqu'un devoir est ajouté ou lorsqu'un événement scolaire change.
L'intégration fournit :
Aucune programmation en YAML n'est nécessaire pour les automatisations courantes.
👨👩👧👦 Comptes parents
Les comptes parents avec plusieurs enfants sont pris en charge.
Chaque enfant est représenté comme un appareil Home Assistant distinct, tout en partageant la même session PRONOTE et le même budget de requêtes.
🔐 Connexion sécurisée
Trois méthodes de connexion sont disponibles :
- QR code — recommandé
- Identifiant et mot de passe
- Connexion via ENT
L'enrôlement par QR code permet à Home Assistant de s'enregistrer comme appareil auprès de PRONOTE sans avoir à conserver votre mot de passe.
🛡️ Protection contre les requêtes excessives
PRONOTE peut limiter les requêtes provenant d'une même adresse IP.
Carnet scolaire intègre donc un limiteur de requêtes à plusieurs niveaux afin d'éviter les sollicitations excessives :
- espacement minimal entre les requêtes
- seau à jetons horaire
- plafond quotidien
- compteurs de connexion séparés
- cadence configurable des différentes collectes
Le budget par défaut est d'environ 180 requêtes par jour et par enfant.
L'intégration estime également le coût des réglages avant leur application afin de rendre leur impact visible.
🚀 Installation
Avec HACS
Carnet scolaire s'installe avec HACS comme dépôt personnalisé.
1. Ajouter le dépôt à HACS et télécharger l'intégration
Ce bouton ouvre votre Home Assistant sur la fiche du dépôt dans HACS. Il ne
reste qu'à Télécharger, puis à redémarrer Home Assistant.
2. Ajouter l'intégration
Le formulaire demande d'abord comment vous vous connectez — QR code,
identifiants, ou ENT. Le guide de l'utilisateur
décrit les trois modes et dit lequel choisir.
- Ouvrez HACS
- Ouvrez le menu ⋮ puis Dépôts personnalisés
- Ajoutez
https://github.com/FiveElements/ha-carnet-scolaire
- Sélectionnez la catégorie Intégration, puis Ajouter
- Installez Carnet scolaire, puis redémarrez Home Assistant
- Paramètres → Appareils et services → Ajouter une intégration, cherchez PRONOTE
💡 Une intégration HACS officielle pourra être utilisée lorsqu'elle sera disponible. En attendant, l'installation par dépôt personnalisé permet d'utiliser Carnet scolaire directement depuis HACS.
Installation manuelle
Copiez le dossier :
custom_components/carnet_scolaire/
dans le dossier custom_components/ de votre configuration Home Assistant, puis redémarrez Home Assistant.
Version minimale
Carnet scolaire nécessite actuellement :
Home Assistant 2026.9.0 ou supérieur
📊 Afficher les données PRONOTE
Carnet scolaire fournit des entités Home Assistant natives :
sensorbinary_sensorcalendartodoimageeventbutton
Vous pouvez donc utiliser les cartes natives de Home Assistant pour construire votre propre tableau de bord.
La documentation explique également comment créer un tableau de bord complet à partir des données PRONOTE.
👉 Afficher les données PRONOTE dans Home Assistant
🎨 Cartes Lovelace
Des cartes Lovelace spécialement conçues pour Carnet scolaire sont disponibles dans un dépôt séparé :
FiveElements/ha-carnet-scolaire-cards — documentation, une page par carte.
Elles permettent notamment d'afficher :
Les cartes sont optionnelles : Carnet scolaire fonctionne avec les cartes natives de Home Assistant.
🔧 Services et actions
Carnet scolaire fournit plusieurs services Home Assistant.
Certains services permettent notamment d'accéder à :
- l'URL iCal de l'emploi du temps
- l'identité de l'élève
- l'emploi du temps au format PDF
- l'état du limiteur de requêtes
Le catalogue des entités et des services donne, pour chaque champ publié, d'où il vient.
Des opérations d'écriture sont également disponibles, activées à l'installation et désactivables dans les options :
- cocher un devoir
- marquer une actualité comme lue
- envoyer un message
🔒 Vie privée et sécurité
La protection des données PRONOTE est une priorité du projet.
Les informations sensibles ne sont pas stockées dans les états des entités ou dans leurs attributs.
Cela concerne notamment :
- l'URL iCal
- les informations d'identité
- le lien vers le PDF de l'emploi du temps
- les informations d'authentification
Les données sensibles sont fournies uniquement lorsqu'elles sont explicitement demandées par un service.
Le fichier de diagnostic ne contient pas le contenu des données scolaires. Les identifiants d'élèves y sont également protégés.
Le détail de ce qui est conservé, de ce qui ne l'est pas et de ce que contient
le fichier de diagnostic est au § 11 du guide.
⚠️ Ne configurez jamais le journaliseur pronotepy en niveau DEBUG.
Le mode DEBUG de pronotepy peut contenir des informations sensibles provenant des requêtes PRONOTE.
🧠 Pourquoi Carnet scolaire ?
Carnet scolaire a été conçu autour de quelques principes importants.
Ne jamais confondre une absence de données avec une donnée vide
Une liste vide peut être parfaitement valide : par exemple, une semaine sans devoirs.
À l'inverse, la disparition inattendue d'une donnée obligatoire peut indiquer un changement du protocole PRONOTE.
Carnet scolaire distingue donc ces deux situations afin d'éviter de publier silencieusement des données incorrectes dans Home Assistant.
Une session partagée pour plusieurs enfants
Avec un compte parent, chaque enfant dispose de son propre appareil Home Assistant, tout en partageant la même session PRONOTE.
Cela évite de multiplier inutilement les connexions.
Des événements utilisables directement dans les automatisations
Les événements permettent de réagir précisément aux changements.
Par exemple :
« Une nouvelle note vient d'être publiée en mathématiques. »
plutôt que simplement :
« Le nombre de notes a changé. »
Cela permet de créer des automatisations Home Assistant plus fiables et plus simples.
📚 Documentation
La documentation complète est disponible ici :
📖 Documentation Carnet scolaire
Elle contient notamment :
🤝 Contribuer
Les contributions, rapports de bugs et suggestions sont les bienvenus.
Avant d'ouvrir une issue :
- vérifiez la documentation
- utilisez les formulaires d'issue : ils demandent ce qu'il faut, et rappellent ce qu'il ne faut pas coller dans une issue publique
- lisez
CONTRIBUTING.md avant une pull request
- ne partagez jamais d'identifiants PRONOTE réels
- ne joignez jamais de données scolaires personnelles
- ne joignez jamais de logs
pronotepy en mode DEBUG
👉 Créer une issue
⚠️ Important
PRONOTE est un service tiers.
Carnet scolaire n'est pas développé, maintenu ou officiellement supporté par Index Éducation / PRONOTE.
Le fonctionnement de l'intégration dépend de l'API et du comportement de PRONOTE. Une évolution de PRONOTE ou de l'ENT utilisé par votre établissement peut nécessiter une adaptation de l'intégration.
⭐ Vous utilisez Carnet scolaire ?
Si cette intégration vous est utile :
- ⭐ ajoutez une étoile au projet GitHub
- 🐛 signalez les problèmes rencontrés
- 💡 proposez des améliorations
- 📖 contribuez à la documentation
- 📣 partagez le projet avec d'autres utilisateurs de Home Assistant
Chaque étoile et chaque contribution aide le projet à être découvert par les utilisateurs qui recherchent une intégration PRONOTE ou EcoleDirecte pour Home Assistant.
📄 Licence
Carnet scolaire est distribué sous licence MIT.
