Pronote Card

Features

• Two cards: a full Pronote Card (custom:pronote-card) and a compact Pronote Mini Card (custom:pronote-mini-card)
• Several students (one Pronote account each, parent accounts included): one text tab per student, the header naming the one shown; or pick them with device / devices
• Header icon in a tinted round badge, red when a lesson of the day is canceled, orange when one has changed; status chip with the homework still to do
• Animated picture of the school, following the day: lesson going on, lesson canceled, homework to do, homework done (see Animations); beside it the lesson going on or the next one, the canceled and changed lessons still to come and the homework for the next school day
• Timetable tab: today and the next school day, the lesson going on with a pulsing dot and its progress, past lessons dimmed, canceled lessons struck through in red, changed lessons in orange with Pronote's own status ("Teacher absent", "Room changed"…), tests, outings and detentions tagged, the lunch break between the morning and the afternoon, rooms and teachers
• Homework tab: grouped by due day, a check circle for the homework done and an empty one for the homework to do, the subject in its Pronote color; a click opens the full text and the attachments in a popup at the top of the card
• Grades tab: overall average of the period, latest grades on their own scale (out of 20, 10…) with their coefficient, the class average and the class min and max, averages per subject with a bar, the class marker and the class min and max, evaluations with their acquisition levels; period buttons to look back at a past term or semester (its overall average, grades and averages)
• School life tab: counters (absences, late arrivals, punishments, unread information), absences and late arrivals justified or not, punishments, today's menu, the school's information with the unread ones marked
• Collapsible sections (chevron to the right when folded, down when unfolded), folded back by a click elsewhere on the page
• Mini card: next lesson, the changes of the day still to come and the homework for the next school day; the detail button (top right) switches it to the full card's content and back, a click anywhere outside the card brings the compact view back
• Click any value to open its Home Assistant history (more-info dialog)
• Visual editor in the dashboard UI for both cards (no YAML needed)
• Light and dark mode, 22 languages (see Translations)
• Single file, no external dependency

Supported integrations

The cards read the sensors of the current period (lessons_today, lessons_tomorrow, lessons_next_day, homework, grades, averages, overall_average, evaluations, absences, delays, punishments, menus, information_and_surveys, class, current_period, periods). The Grades tab also reads the sensors the integration creates for the past terms or semesters (grades_period, averages_period, overall_average_period, evaluations_period, e.g. sensor.pronote_<student>_averages_trimestre_1): one button per past period, then the current one. The integration creates them only for the periods before the current one (none during the first term), and only when the school's periods are terms or semesters. The class min and max (min, max) and the coefficient (coefficient) are the attributes the integration gives on each grade and average (no coefficient per subject average: Pronote's averages do not carry one). Versions of the integration older than its translated entity names are recognized from their entity ids (sensor.pronote_<student>_timetable_today…). A sensor the integration does not create (menus at a school without a canteen, evaluations…) simply hides its part of the card.

Note

Pronote gives no way to tick a homework from Home Assistant: the cards show it as done or to do as Pronote reports it (ticked in the Pronote app).

Prerequisites

Home Assistant 2024.8 or later, with the Pronote integration configured for at least one student.

Configuration

Card types#

Visual editor#

Edit a dashboard, click Add card and search for Pronote Card or Pronote Mini Card. All students are shown by default; pick some of them (full card) or one (mini card) in the list, choose the tabs and their order, the default tab, the sections folded by default, what to show, and the language. The preview updates live, and options left at their default are kept out of the generated YAML.

Minimal#

type: custom:pronote-card

type: custom:pronote-mini-card

Full options#

type: custom:pronote-card
devices:
  - Alex Moreau
  - Sam Moreau
tabs:
  - timetable
  - homework
  - grades
  - school_life
default_tab: timetable
show_title: true
show_subtitle: true
show_picture: true
show_room: true
show_teacher: true
show_canceled: true
show_done_homework: true
show_class_average: true
show_min_max: true
show_coefficient: true
show_periods: true
max_grades: 5
collapsed:
  - evaluations
  - information
language: fr

type: custom:pronote-mini-card
device: Alex Moreau
title: Alex
show_picture: true
show_room: true
zoom: true
language: fr

Options reference#

Sidebar panel (optional)

The same bundle also holds a Pronote page for the sidebar. The cards never need it: add it only if you want it. It draws its own full-page layout (it does not embed the cards), with text tabs under the header: Today (the student, the lesson going on or the next one, the timetable, the homework for the next school day, the latest grades, the school life counters and the menu), Timetable (today and the next school day side by side), Homework, Grades and School life (laid out in columns). The tab is in the address (/pronote/homework), and with several students a button per student sits in the header (the one picked is remembered by the browser).

Declare it in configuration.yaml, pointing at the file the Marketplace installed, then restart Home Assistant:

panel_custom:
  - name: pronote-panel
    sidebar_title: Pronote
    sidebar_icon: mdi:school
    url_path: pronote
    module_url: /local/community/ha-pronote-card/pronote-card.js
    # require_admin: true   # to keep it for administrators
    config:                 # optional, the card options below
      devices: [Alex Moreau, Sam Moreau]
      default_tab: today    # today, timetable, homework, grades or school_life
      max_grades: 10        # 10 by default on the panel

config takes the options of the full card (device, devices, title, show_room, show_teacher, show_canceled, show_done_homework, show_class_average, show_min_max, show_coefficient, show_periods, show_picture, max_grades, language), plus default_tab, which can also be today. Sections are always unfolded on the panel.

How it works

The cards read the Home Assistant entity and device registries instead of entity ids: every entity of the pronote platform is matched by its translation_key and grouped by the device it belongs to, one device per student (Pronote - <name>). Entity ids can therefore be in any language or renamed without breaking the cards. The lessons, homework, grades and the rest come from the attributes of the sensors, as the integration writes them.

• Next school day: the integration's lessons_next_day sensor (the next day with lessons, after a weekend or a holiday), else lessons_tomorrow. The timetable opens on today while a lesson is still to come, then on the next school day.
• Canceled and changed lessons: a lesson Pronote marks as canceled is struck through in red; a lesson that is not canceled but has a Pronote status (room change, replacement, exceptional lesson…) is outlined in orange. The status text is Pronote's own, in the school's language.
• Picture: lesson going on → class; else a canceled lesson still to come that day → canceled; else homework to do for the next school day → homework; else all of it done → done; else still.
• Grades are compared out of 20 whatever their scale; Pronote's decimal comma is read and numbers are written in the card's language. A grade that is not a number (absent, exempted) is shown as Pronote gives it.

Support

If you find this project useful, you can support its development:

Features

• Class min and max on the Grades tab: under each grade (beside the class average) and under each subject average, as the Pronote integration gives them; show_min_max: false hides them (#7, suggested by @mielikki33).
• Coefficient of each grade, beside its date; show_coefficient: false hides it (#7, suggested by @mielikki33).
• Period buttons on the Grades tab: one per past term or semester, then the current period, to compare the overall average, the grades and the averages of the periods. They read the sensors the integration creates for the past periods (averages_period, overall_average_period, grades_period, evaluations_period), named after its "Periods" sensor; shown only when such sensors exist (none during the first term), show_periods: false hides them (#7, suggested by @mielikki33).

Fixes

• Folding back on a tap elsewhere now works on iOS (Safari and the companion app): a tap on something that is not clickable sent no click to the page, so what a click elsewhere folds (unfolded sections, the detailed view of the mini card, popups) stayed open. The press and the release are caught instead; a slider dragged out of the card and a scroll do not fold anything.
• Leaving the card (another dashboard view, a conditional card hidden) brings it back in its default state.
• A click could do nothing: Home Assistant updates the card several times a second, and a rewrite of the card between the press and the release replaced the element pressed, so that the click was lost. The card is no longer rewritten while a press is in progress; the pending update is drawn right after the click.
• No focus ring after a mouse click or a tap: the focus is kept across updates only for the keyboard.

Features

• Sidebar panel (pronote-panel, optional, declared with panel_custom): a full-page Pronote view with text tabs (Today, Timetable, Homework, Grades, School life), the tab in the address, one button per student in the header, laid out in columns on wide screens. The cards stay independent of it.
• Icon of the project (brand/icon.svg, icon.png, icon@2x.png): the cards' school glyph on a tile in their accent color, with an "A+" badge; shown at the top of the README and on the panel's Today tab.

Features

• Pronote Card (custom:pronote-card): header with the student, class and school, and a status chip (homework still to do); an animated picture of the school with the lesson going on or the next one, the canceled and changed lessons still to come and the homework for the next school day; then four text tabs:
  • Timetable: today or the next school day (Pronote's "next day" sensor), with the lesson going on (pulsing dot and progress bar), past lessons dimmed, canceled lessons struck through in red and changed lessons in orange with Pronote's status ("Teacher absent", "Room changed"…), tests, outings, detentions and the lunch break.
  • Homework: grouped by due day, done (checked) or to do, with the full text and the attachments in a popup at the top of the card.
  • Grades: overall average of the period, latest grades on their own scale with the class average, averages per subject with the class marker, evaluations with their acquisition levels.
  • School life: absences (justified or not), late arrivals, punishments, today's menu and the school's information (unread ones marked).
• Pronote Mini Card (custom:pronote-mini-card): next lesson (or the one going on), the changes still to come and the homework for the next school day; detail button at the top right to switch to the full card.
• Several students (several Pronote accounts): one text tab per student, or device / devices to pick them.
• Picture animated by the state of the day: lesson going on, lesson canceled, homework to do, homework done; still otherwise and with the reduced-motion setting.
• Collapsible sections folded back by a click elsewhere, visual editor for both cards, light and dark themes, 22 languages (English in the bundle, the others loaded on demand).