About
Web Untis is a custom integration that brings Web Untis school timetable data into Home Assistant. It connects through the vendor's cloud and is set up in the UI, where login can use a username and password or a key and server details, and the timetable source can be a class, student or teacher. It provides calendars for exams and homework, events for lesson changes and new homework, and sensors for the next lesson, school start and end times, and a homework list. Actions can count lessons in a time range, fetch the timetable, and return school years. Options cover filters for subjects and classes, calendar content, lesson display, notifications, and a live timetable with a countdown during breaks. A bundled homework card is registered automatically, and repair notices appear when a password changes.
Automatic summary of the README and code of JonasJoKuJonas/homeassistant-WebUntis. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Sign in
- Password
- Username
Manual login
- School name or search termYou do not have to enter the full name of the school. The integration will search for schools matching your input.
- Choose your school:
- Timetable source
- Full name/ClassEnter the full name of the student/teacher or the class name
Pick klasse
- Back
- Class
Pick student
- Back
- Fore Name
- Surname
Also asked when at the pick teacher step.
Qr login
- Key
- QRCode payloadThe payload usually starts with untis://. You can get it by scanning the QRCode with your phone or by copying the payload
- School
- School number
- Server URL
- Username
Timetable source
- Select the timetable data source:
Change the connection
- Password
After setup
- Exclude data from requestThis option is set automatically if the user has no rights, to prevent error spamming.
- Generate JSONGenerate JSON in Sensor Attributes - enable only if needed.
- Keep logged inTry to save the session data. (BETA)
- Calendar - descriptionDetermine what should be in the description of a calendar event.
- Replace event namee.g., Cancelled: ❌
- Calendar - LocationSpecify what to display for location.
- Calendar - cancelled lessonsShow cancelled lessons in the calendar.
- Calendar - Room changeShow room changes in the calendar.
- Homework - display modeChoose how homework events appear in the homework calendar: spanning the assigned date through the due date (default), or on the due date only.
- Name
- Platform
- Notify Service
- Start before schoolMinutes before the first lesson.
- End after schoolMinutes after the last lesson.
- Timer during breakShow a countdown to the next lesson during breaks.
- Live Activity
- Platform-Specific Notification Datae.g., notification_icon: mdi:school-outline
- Notify Service IDe.g., notify.discord
- Name
- Notify on
- Platform-Specific Target Data
- Notify Templatemay overwrite data keys
- Do not filter lessons for notifications and eventsWhen enabled the events and notifications are triggered for filtered lessons.
- Filter mode - DescriptionHide lessons that contain the following phrases in the description. (Comma-separated list) Not affected by blacklist/whitelist.
- Filter mode - classes
- Filter modeApplies to both subject and class filters
- Filter mode - subjects
- No SubjectsAllow lessons with no subjects
- Add Teacher to subjectSelect which subjects should be displayed with the teacher's name.
- Max. break time between double lessonsIdentical consecutive lessons will be combined to double lessons if the break time is shorter than this value.
- Compact parallel lessonsLessons with the same time or overlapping times will also be merged.
- Long name
- Replace Lesson namee.g., M: Math
- Live Activities
Texts from the code of JonasJoKuJonas/homeassistant-WebUntis.
Entities
- CalendarsExams, Homework
- EventsLesson Change, New Homework
- SensorsNext Lesson, Next Lesson to Wake Up, Today's School End, Today's School Start, Homework List
Actions
- Count HoursCount lessons within a time range.Fields: Activate Filter, Count Cancelled lessons, Device, End, Start
- Get REST timetableGet WebUntis timetable via the REST API (includes exams and lesson info)Fields: Device, End, Raw response, Start
- Get SchoolyearsGet WebUntis schoolyearsFields: Device
- Get TimetableGet the timetable in a given time range.Fields: Activate Filter, Simplify Results, Tolerance for combining (minutes), Device, End, Show Cancelled lessons, Start
Troubleshooting
- Repair noticesNotices it can show in Settings, Repairs:Password has been changed, Live Timetable: notify target unreachable
Shows in Vulpo
Calendar card, Chart card, Apple Watch.Information
- Installs
- 753 sharing analytics
- GitHub stars
- 151
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v3.3.1,
- Category
- Productivity and information, Calendars and to-dos
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
webuntis- Issues
- Report an issue











