[README DE] [README EN]

LanisAPI

⚠ Notice

Because the Schulportal Hessen changes quickly and is very fragmented, some functions at specific schools or after a while may no longer work.

What is this?

It's an unofficial Python library for the Schulportal Hessen. Also available on PyPi.

Features

• 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.

App for the Schulportal Hessen

If you want to have an app for Lanis, check out SPH-vertretungsplan by @alessioC42. It's still in an early phase!

It would be also really nice if you contribute to this project, like bug reporting, if you know Dart and Flutter it would be nice to see your help or you could learn Dart, it's not hard.

How do I install it?

pip install lanisapi

Required is Python 3.11. (older versions are probably not working, I didn't tested it.)

Example

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.

How can I help?

1. You can report problems at Issues.
2. You can suggest ideas at Issues.
3. 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.

Credits

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

Notice

This project isn't officially related to the Schulportal Hessen. It's only a unofficial library, supported by the community.