krzysckh / librusik

Fancy, self-hosted Librus Synergia web client with many cool features. Those include independent average calculation, countdowns, messages, attendances %% calculation and many more.

Home Page:https://dani3l0.github.io/librusik/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Preview photo

Check out the wiki for more detailed information!


Features

The coolest ones:

πŸ“‹ Grades with independent average calculation - works even if school has disabled it

βœ‰οΈ Messages with downloading attachments

βœ… Attendances with per-semester per-subject frequency %% calculation

🏠 School free days with countdown to next holiday

πŸͺ Cookies - you won't be logged out each time you close the browser

🧹 Grades cleanup - removes subjects without grades from Grades page

βŒ› Cool countdown gauges on home screen

πŸŒ™ Dark theme

πŸŽ‰ Confetti


Installation

1. Clone the repo:

git clone https://github.com/dani3l0/librusik && cd librusik

2. Install required dependencies:

pip install -r requirements.txt

3. And, finally run it:

python3 librusik.py

Done! Librusik is now running at localhost:7777.


Configuration

Go to localhost:7777/panel to manage your Librusik instance. Default user is admin and password is admin.

Interface is friendly enough to painlessly configure your Librusik instance.


Reporting a bug

Feel free to open new issues when something doesn't work or you want to ask for new features/improvements.

If you encounter a bug, remember to attach some logs (exception traceback or just a detailed description).

Also, ping me somewhere so we can test whether fixes work as intended as I have no access to Librus anymore.


Some other words

Because this was my first app written in Python, code is a terrible mess. Don't expect it to be super readable and flexible.

It just works (It actually worked since 2019 xD)

About

Fancy, self-hosted Librus Synergia web client with many cool features. Those include independent average calculation, countdowns, messages, attendances %% calculation and many more.

https://dani3l0.github.io/librusik/

License:MIT License


Languages

Language:Python 42.0%Language:HTML 24.6%Language:JavaScript 21.2%Language:CSS 12.2%