Skip to content
scaarupPublic

About

Fetches information from Aula about your children

Topics

Resources

Stars

125 stars

Watchers

7 watching

Forks

Repository files navigation

Current Release Github All Releases

Aula

This is a custom component for Home Assistant to integrate Aula.

  • Installable and updatable through the Home Assistant Marketplace (formerly HACS)

  • UI config flow

  • School schedules as Home Assistant calendars

  • Booked meetings (skole-hjem-samtaler, forældresamtaler) as Home Assistant calendars (opt-in)

  • "Ugeplaner/Ugenoter" from "Min Uddannelse", "Meebook", "EasyIQ" and "Docendo"

  • "Opgaver" (assignments) from "Min Uddannelse", including the teacher's notes, see Opgaver

  • Messages - if there are unread messages, we turn a binary sensor on and populate it with the message details.

  • "Huskelisten" (reminders) from "Systematic", see Huskelisten

  • Use the builtin aula.api_call service to interact directly with Aula's API, see Service.

    "Ugeplaner/ugenoter/huskelisten" are stored as sensor attributes. Can be rendered like:

    {{ state_attr("sensor.hojelse_skole_emilie", "ugeplan") }}

    And visualized in your dashboard with the markdown card:

    type: markdown
    content: '{{ state_attr("sensor.hojelse_skole_emilie", "ugeplan") }}'
    title: Ugeplan for Emilie

    Another example using vertical-stack and collapsable-cards:

    image

type: vertical-stack
cards:
  - type: custom:collapsable-cards
    title: Ugeplan Emilie
    cards:
      - type: markdown
        content: '{{ state_attr("sensor.hojelse_skole_emilie", "ugeplan") }}'
  - type: custom:collapsable-cards
    title: Ugeplan Emilie, næste uge
    cards:
      - type: markdown
        content: '{{ state_attr("sensor.hojelse_skole_emilie", "ugeplan_next") }}'
  - type: custom:collapsable-cards
    title: Ugeplan Rasmus
    cards:
      - type: markdown
        content: '{{ state_attr("sensor.hojelse_skole_rasmus", "ugeplan") }}'
  - type: custom:collapsable-cards
    title: Ugeplan Rasmus, næste uge
    cards:
      - type: markdown
        content: '{{ state_attr("sensor.hojelse_skole_rasmus", "ugeplan_next") }}'

image

  • Lots of small fixes and optimizations

Installation

Marketplace (recommended)

Home Assistant 2026.11 and newer ships with the Marketplace (the successor of HACS), under Settings > Marketplace. The Aula repository is available there.

  • Open Settings > Marketplace.
  • Search for and download the "Aula" integration.
  • Restart Home Assistant.

On Home Assistant older than 2026.11 the same catalog is available through the HACS custom integration.

Manual installation

  • Download the latest release.
  • Unpack the release and copy the custom_components/aula directory into the custom_components directory of your Home Assistant installation.
  • Restart Home Assistant.

Setup

Shortcut:

  • Go to Settings -> Integrations -> Add Integration
  • Search for "Aula" and follow the instructions in the config flow.

Login (MitID)

You must log in with the guardian's MitID; childlogin is not supported.

  • Enter your MitID username. You then approve the login in the MitID app.
  • If you use a MitID token device instead, the flow asks for your MitID password and the code from the token device.
  • If several MitID identities are found, you pick the one to use for Aula.
  • Choose which features to enable (school schedule, ugeplaner, Min Uddannelse assignments, booked meetings). You can change this later under Configure.

Aula issues a refresh token that Home Assistant renews automatically and stores, so you stay logged in across restarts. Only when the refresh token has expired or is revoked does Home Assistant ask you to re-authenticate in the integration card: approve MitID once more, no need to delete the integration.

Entities

For each child the integration creates (names depend on the child's first name and your school):

Entity Purpose
sensor.<school>_<child> Main sensor with the weekly plans, assignments and reminders as attributes
calendar.skoleskema_<child> School schedule (opt-in)
calendar.ugeplan_<child> Lessons from EasyIQ and Docendo (see Ugeplaner)
calendar.samtaler_<child> Booked meetings (opt-in)
calendar.fodselsdage_<child> Birthdays
binary_sensor.aula_aulamessage On when there are unread messages, with the message details as attributes

If two or more of your children are in the same class, every one of them gets the class's lessons in their own schedule.

Booked meetings (samtaler)

Enable "booked meetings" when adding the integration, or later under the integration's Configure options. Each child then gets a calendar.samtaler_<name> calendar with the time you booked for every skole-hjem-samtale and forældresamtale in Aula — only your own booked slot, not the whole booking period, and not other families' slots. Events are titled with the child's first name, e.g. "Emilie: Skole-hjem-samtale". Meetings are looked up 100 days ahead and refreshed every 30 minutes. A meeting you have not booked a time for yet does not appear.

Ugeplaner (weekly plans)

Enable "ugeplaner" when adding the integration, or later under Configure. The integration picks the ugeplan source from the widgets your school has enabled in Aula:

Source Aula widget
Min Uddannelse 0029 / 0023
Meebook 0004
EasyIQ 0001 / 0128 / 0142
Docendo 0057

This week's and next week's plan are stored in the ugeplan and ugeplan_next attributes of the child's sensor. For EasyIQ and Docendo, lessons are also added to the child's "Ugeplan " calendar.

Docendo: Docendo returns one weekplan per class. The plan is matched to a child by the class shown in Aula (e.g. "4I"), ignoring case, spaces and punctuation. With one child, an unmatched plan is still shown; with several children, a plan that matches none of their classes is skipped (logged at debug level). Docendo plans are refreshed every 30 minutes.

EasyIQ "Generelt om ugen": On EasyIQ SkolePortal (widget 0128), the teachers' weekly letter ("Generelt om ugen") is put at the top of ugeplan / ugeplan_next under its own heading. It is also added to the "Ugeplan " calendar as an all-day event, Monday to Friday, with the letter as plain text in the description. Weeks without a letter are unchanged.

Ugeplaner are read through the same unofficial widget endpoints that Aula's own web page uses, and can change without notice. If an update breaks them, you can go back to the previous version in the Marketplace (Aula → ⋮ → Redownload → pick the version).

Opgaver (Min Uddannelse assignments)

Enable "assignments from Min Uddannelse" when adding the integration, or later under Configure. This needs the Min Uddannelse assignments widget in Aula (0030, or 0023 at schools that do not expose 0030 to guardians). If your school has neither, the integration logs an error and shows no assignments.

For the current and next ISO week, each child's sensor gets:

  • mu_opgaver / mu_opgaver_next: the assignments as HTML, including the teacher's notes (indhold), ready for a markdown card.
  • mu_opgaver_data / mu_opgaver_next_data: the same as structured lists with id, titel, dato, ugedag, fag and indhold, for use in templates and automations.

The notes are fetched from the Min Uddannelse web API. If that fails, the assignments are still shown, just without notes.

type: markdown
title: Opgaver for Emilie
content: '{{ state_attr("sensor.hojelse_skole_emilie", "mu_opgaver") }}'

Huskelisten (Systematic)

Schools that use Systematic's "Huskelisten" widget (0062 in Aula) get the child's reminders (homework and team reminders) in the huskelisten attribute of the child's sensor.

Service: aula.api_call

Makes a custom call to Aula's API with your login. uri is the part after the API base URL, e.g. ?method=presence.updatePresenceTemplate. Without post_data the call is a GET; with JSON post_data it is a POST. A POST can change data in Aula, so use it with care. See services.yaml for a full example.

Known issues

  • You must use the guardian MitID; childlogin is not supported.
  • Ugeplaner and assignments are read through unofficial endpoints and can break when the provider changes them.
  • Entity names contain your school's name (e.g. sensor.hojelse_skole_emilie) and differ from the examples in this README.

Support

Join our Discord https://discord.gg/SnfRg3DWG6 and feel free to ask in #homeassistant

About

Fetches information from Aula about your children

Topics

Resources

Stars

125 stars

Watchers

7 watching

Forks

Releases

Packages

Used by

Contributors

Languages