Pronote integration for Home Assistant

Installation

Using HACS

OR

If you can't find the integration, add this repository to HACS, then:
HACS > Integrations > Pronote

Manual install

Copy the pronote folder from latest release to the custom_components folder in your config folder.

Configuration

Click on the following button:

Or go to :
Settings > Devices & Sevices > Integrations > Add Integration, and search for "Pronote"

You can choose between two options when adding a config entry.

Option 1: using username and password

Use your Pronote URL with username, password and ENT (optional):

Option 2: using the QR Code

Install the following Chrome Extension: QR Code Reader (only needed for setup).

Create the QR Code from your Pronote account:

Use the extension to scan the QR Code:

And copy the JSON ouput that looks like:

{"jeton":"XXXXXXXXXXX[...]XXXXXXXXXXXXXX","login":"YYYYYYYYYYYYYY","url":"https://[id of your school].index-education.net/pronote/..."}

Paste it, and enter the PIN code used for the generation:

Parent account

If using a Parent account, you'll have to select the child you want to add:

Usage

This integration provides several sensors, always prefixed with pronote_LASTNAME_FIRSTNAME (where LASTNAME and FIRSTNAME are replaced), for example sensor.pronote_LASTNAME_FIRSTNAME_today_s_timetable.

Sensor	Description
sensor.pronote_LASTNAME_FIRSTNAME_class	basic informations about your child's class
[...]_today_s_timetable	today's timetable
[...]_tomorrow_s_timetable	tomorrow's timetable
[...]_next_day_s_timetable	next school day timetable
[...]_period_s_timetable	timetable for next 15 days
[...]_timetable_ical_url	iCal URL for the timetable (if available)
[...]_next_alarm	next alarm timestamp based on timetable
[...]_grades	latest grades (current period)
[...]_homework	homework
[...]_period_s_homework	homework for max 15 days
[...]_absences	absences (current period)
[...]_evaluations	evaluations (current period)
[...]_averages	averages (current period)
[...]_punishments	punishments (current period)
[...]_delays	delays (current period)
[...]_overall_average	overall average (current period)
[...]_information_and_surveys	information and surveys
[...]_menus	menus (if available)
[...]_current_period	current period name and dates
[...]_periods	list of all periods
[...]_previous_periods	list of previous periods
[...]_active_periods	list of active periods (previous + current)

For each previous period (e.g. trimestre_1), the following sensors are also created:

Sensor	Description
[...]_grades_trimestre_1	grades for the period
[...]_averages_trimestre_1	averages for the period
[...]_absences_trimestre_1	absences for the period
[...]_delays_trimestre_1	delays for the period
[...]_evaluations_trimestre_1	evaluations for the period
[...]_punishments_trimestre_1	punishments for the period
[...]_overall_average_trimestre_1	overall average for the period

The sensors are updated every 15 minutes.

Cards

Cards are available here: https://github.com/delphiki/lovelace-pronote