https://github.com/lates-codrin/myscheduler
Kotlin-made mobile app for a better university experience.
https://github.com/lates-codrin/myscheduler
kotlin mobile-app
Last synced: 10 months ago
JSON representation
Kotlin-made mobile app for a better university experience.
- Host: GitHub
- URL: https://github.com/lates-codrin/myscheduler
- Owner: lates-codrin
- Created: 2025-04-05T04:39:55.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-26T19:23:14.000Z (about 1 year ago)
- Last Synced: 2025-04-26T19:39:09.243Z (about 1 year ago)
- Topics: kotlin, mobile-app
- Language: Kotlin
- Homepage:
- Size: 689 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### [!] Notice
- If you want to contribute, please read below. As of **26 April 2025**, anyone is free to open any issue. 👍
# 📱 MyScheduler
**MyScheduler** is a sleek, Kotlin-based Android app designed to enhance university life. It fetches real-time academic information like schedules, campus room locations, news, and more — all powered by a robust FastAPI backend.
---
## ✨ Features
- 📅 **Current Schedule**
Instantly access your university schedule using your group number.
- 📰 **News Feed**
Stay informed with the latest university updates.
- 🏫 **Room Locator**
Search for room names and navigate directly using Google Maps.
- 📊 **Grades** (coming soon!)
Track academic performance — currently in development.
- 🔒 **Privacy Policy**
Built with user privacy in mind.
---
## 🔌 API Integration
This app communicates with a FastAPI-based backend. Here are some of the main endpoints used:
| Endpoint | Purpose |
|---------------------|------------------------|
| `/rescan` | Rescan the schedule |
| `/orar/{grupa}` | Fetch schedule by group |
| `/news` | Get university news |
| `/rooms` | Get room information |
| `/` | General info/home |
---
## 🛠️ Tech Stack
### 📱 Android App
- **Language:** Kotlin
- **IDE:** Android Studio (Latest version)
- **UI:** Material Design 3 + ConstraintLayout
- **Networking:** OkHttp + Gson
- **Architecture:** MVVM + Jetpack Components
- **Image Loading:** Glide
- **Background Work:** WorkManager
### 🧰 Dependencies
```toml
# Versions
kotlin = "2.0.21"
appcompat = "1.7.0"
navigation = "2.8.9"
glide = "4.12.0"
workmanager = "2.10.0"
```
## 🚀 Permissions
```xml
```
## 🧭 Getting Started
### 🔨 Prerequisites
- Android Studio Meerkat
- Android SDK 33+
- Kotlin 2.0.21
## 📦 Installation
Clone the repo:
```bash
git clone https://github.com/lates-codrin/MyScheduler.git
```
Open in Android Studio
Sync Gradle and run the app!
# 🧑💻 Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you’d like to change.