Librusek

<p align="center"> <img src="https://raw.githubusercontent.com/SimonB50/librusek/refs/heads/main/assets/icon.svg" alt="Librusek Logo" width="100"/> </p> <h1 align="center">Librusek</h1> <p align="center"> <em>Custom mobile app for Librus Synergia</em> </p> <p align="center"> <a href="https://github.com/SimonB50/librusek/issues"> <img alt="GitHub issues" src="https://img.shields.io/github/issues/SimonB50/librusek"></a> <a href="https://github.com/SimonB50/librusek/stargazers"> <img alt="GitHub stars" src="https://img.shields.io/github/stars/SimonB50/librusek"></a> <a href="https://github.com/SimonB50/librusek/network"> <img alt="GitHub forks" src="https://img.shields.io/github/forks/SimonB50/librusek"></a> <a href="https://github.com/SimonB50/librusek"> <img alt="GitHub license" src="https://img.shields.io/github/license/SimonB50/librusek"></a> <a href="https://discord.com/users/426778259938738187"> <img alt="Discord" src="https://img.shields.io/badge/Discord-simonb50-blue?logo=discord"></a> </p> <p align="center"> <a href="#get-it-here">Get it here</a> • <a href="#check-it-out-in-action">Check it out in action</a> • <a href="#contact">Contact</a> • <a href="#credits">Credits</a> </p>

📚 About

Librusek is an alternative app for Librus Synergia, a popular school management system in Poland. It is designed to be more user-friendly and modern than the original website.

✨ Supported Synergia Features

• Logging in with Synergia: Librusek doesn't require you to create a Librus account, instead opting for the ability to login with your pre-existing Synergia account created for you by your school administrator.
• Landing page: All your account information, like your name, school, and the current lucky number is available in one place.
• Grades: View your grades and averages for each subject. You can also see the grades added the day prior. Librusek supports both the traditional and points-based (percentages) grading systems.
• Exams: Know when your upcoming exams take place. You can view all your upcoming and previous exams along with their dates, all neatly sorted and highlighted for your convenience.
• Timetable: Stay up-to-date with your daily schedule. You can view your timetable for each week, including all substitutions and cancelled classes.
• Attendance: Keep track of your attendance. You can view your attendance for each subject and see the number of absences and lates.
• Profile: Check your profile information, including your name and synergia email. You can also check your behavior grades and notes given by your teachers - both positive and negative.
• Messages: Read messages from your teachers and school administration regarding important information and events.

🌟 Unique App Features

Since Librusek is a fully custom application, it has some unique features that are not available in the original Librus Synergia.

• Multiple themes: Librusek supports multiple themes, including a dark mode and a light mode. You can choose the theme that suits you best.
• Grades simulator: With the grades simulator, you can calculate the grades you need to achieve a specific average. You can also see how your average will change if you get a specific grade.
• Responsive design: Thanks to the responsive design, Librusek looks great on various mobile devices like smartphones and tablets.
• Modern design: Librusek has a modern and clean design that is easy to use and looks great.
• Fast and reliable: Librusek is built with modern technologies. It's - in most cases - faster than the official Synergia.
• Optimized data fetching: Librusek uses optimized methods for fetching data from the Synergia API, which makes it faster and more reliable. It also uses caching to reduce the number of network requests.

📥 Get it here!

<a href="https://github.com/SimonB50/librusek/releases/latest"> <img src="https://user-images.githubusercontent.com/663460/26973090-f8fdc986-4d14-11e7-995a-e7c5e79ed925.png" alt="Download APK from GitHub" height="120"> </a>

📸 Check it out in action

<p float="left"> <img src="graphics/home.jpg" alt="Home Page" height="450" /> <img src="graphics/grades.jpg" alt="Grades Page Retracted" height="450" /> <img src="graphics/grades2.jpg" alt="Grades Page Full" height="450" /> <img src="graphics/grades3.jpg" alt="Points Based Grades Page" height="450" /> <img src="graphics/exams.jpg" alt="Exams Page" height="450" /> <img src="graphics/timetable.jpg" alt="Timetable Page" height="450" /> </p>

👥 This project was brought to you by our awesome contributors!

<a href="https://github.com/SimonB50/librusek/graphs/contributors"> <img src="https://contrib.rocks/image?repo=SimonB50/librusek" /> </a>

🏆 Credits

The idea for Librusek was born because of Librusik created by dani3l0. Some of the code (especially for authorization) was inspired by this project.

📬 Contact

If you have any questions or suggestions, feel free to contact me using the following methods:

• GitHub Issues: SimonB50/librusek
• Discord: simonb50
• Email: szymon.dawid@gmail.com

Feel free to adjust the content and images as needed.