See issue #32 and the rewrite branch
For now, you can use v0.4.1
It's an unofficial Python library for the Schulportal Hessen. Also available on PyPi.
- Fetch homework or other tasks.
- Fetch substitution plan.
- Fetch calendar events.
- Fetch conversations.
- Fetch all schools that have Lanis.
- Fetch all web applets with their links.
Overview of future Features, Problems and other things here.
You want an app? Use lanis-mobile!
Lanis-mobile is open for new contributors!
pip install lanisapi
Required is Python 3.11. (older versions are probably not working, I didn't tested it.)
This example gives the substitution plan.
from lanisapi import LanisClient, LanisAccount, LanisCookies, School
def main():
client = LanisClient(LanisAccount("school id", "name.lastname", "password"))
or: client = LanisClient(LanisAccount(School("school", "city"), "name.lastname", "password"))
or: client = LanisClient(LanisCookie("school id", "session id"))
client.authenticate()
print(client.get_substitution_plan())
client.close()
if __name__ == "__main__":
main()
More infos at the wiki.
- You can report problems at Issues.
- You can suggest ideas at Issues.
- Contributing: You can contribute to this project either by code or improving the wiki. If you're new to contributing, look here and for this project there is also some help here.
Also if you like this project you can give it a star.
The Javascript project SPHclient from @alessioC42 helped me to understand the Schulportal Hessen.
The Android-App sph-planner from @koenidv helped me to understand the Level 2 encryption.
Other projects that didn't helped me but are cool:
- Flutter Android app SPH-Vertretungsplan also from @alessioC42
- TypeScript library Maria from Elderguardian
- Javascript app SchulportalApp from DerOwnerHD
- Flutter Android app lkwslr-sphplaner from flutter-preview
This project isn't officially related to the Schulportal Hessen. It's only a unofficial library, supported by the community.