{"id":27326603,"url":"https://github.com/lates-codrin/myscheduler","last_synced_at":"2025-08-10T13:20:33.607Z","repository":{"id":287315899,"uuid":"960793429","full_name":"lates-codrin/MyScheduler","owner":"lates-codrin","description":"Kotlin-made mobile app for a better university experience.","archived":false,"fork":false,"pushed_at":"2025-04-26T19:23:14.000Z","size":706,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-26T19:39:09.243Z","etag":null,"topics":["kotlin","mobile-app"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lates-codrin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-05T04:39:55.000Z","updated_at":"2025-04-26T19:23:17.000Z","dependencies_parsed_at":"2025-04-12T11:59:03.714Z","dependency_job_id":null,"html_url":"https://github.com/lates-codrin/MyScheduler","commit_stats":null,"previous_names":["lates-codrin/myscheduler"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lates-codrin/MyScheduler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FMyScheduler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FMyScheduler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FMyScheduler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FMyScheduler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lates-codrin","download_url":"https://codeload.github.com/lates-codrin/MyScheduler/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FMyScheduler/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260046688,"owners_count":22950896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kotlin","mobile-app"],"created_at":"2025-04-12T11:59:02.265Z","updated_at":"2025-06-15T20:42:10.753Z","avatar_url":"https://github.com/lates-codrin.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/w0GCwPS.png\" width=\"300\" height=\"500\" alt=\"MyScheduler Mockup Image\"/\u003e\n\u003c/p\u003e\n\n\n### [!] Notice\n- If you want to contribute, please read below. As of **26 April 2025**, anyone is free to open any issue. 👍\n# 📱 MyScheduler\n\n**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.\n\n---\n\n## ✨ Features\n\n- 📅 **Current Schedule**  \n  Instantly access your university schedule using your group number.\n\n- 📰 **News Feed**  \n  Stay informed with the latest university updates.\n\n- 🏫 **Room Locator**  \n  Search for room names and navigate directly using Google Maps.\n\n- 📊 **Grades** (coming soon!)  \n  Track academic performance — currently in development.\n\n- 🔒 **Privacy Policy**  \n  Built with user privacy in mind.\n\n---\n\n## 🔌 API Integration\n\nThis app communicates with a FastAPI-based backend. Here are some of the main endpoints used:\n\n| Endpoint            | Purpose                |\n|---------------------|------------------------|\n| `/rescan`           | Rescan the schedule    |\n| `/orar/{grupa}`     | Fetch schedule by group |\n| `/news`             | Get university news    |\n| `/rooms`            | Get room information   |\n| `/`                 | General info/home      |\n\n---\n\n## 🛠️ Tech Stack\n\n### 📱 Android App\n- **Language:** Kotlin\n- **IDE:** Android Studio (Latest version)\n- **UI:** Material Design 3 + ConstraintLayout\n- **Networking:** OkHttp + Gson\n- **Architecture:** MVVM + Jetpack Components\n- **Image Loading:** Glide\n- **Background Work:** WorkManager\n\n### 🧰 Dependencies\n\n```toml\n# Versions\nkotlin = \"2.0.21\"\nappcompat = \"1.7.0\"\nnavigation = \"2.8.9\"\nglide = \"4.12.0\"\nworkmanager = \"2.10.0\"\n```\n\n## 🚀 Permissions\n```xml\n\u003cuses-permission android:name=\"android.permission.INTERNET\" /\u003e\n\u003cuses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\" /\u003e\n\u003cuses-permission android:name=\"android.permission.POST_NOTIFICATIONS\" /\u003e\n\u003cuses-permission android:name=\"android.permission.FOREGROUND_SERVICE\" /\u003e\n\u003cuses-permission android:name=\"android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS\" /\u003e\n```\n\n\n## 🧭 Getting Started\n### 🔨 Prerequisites\n- Android Studio Meerkat\n- Android SDK 33+\n- Kotlin 2.0.21\n\n## 📦 Installation\nClone the repo:\n```bash\ngit clone https://github.com/lates-codrin/MyScheduler.git\n```\nOpen in Android Studio\n\nSync Gradle and run the app!\n\n# 🧑‍💻 Contributing\nPull requests are welcome! For major changes, please open an issue first to discuss what you’d like to change.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flates-codrin%2Fmyscheduler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flates-codrin%2Fmyscheduler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flates-codrin%2Fmyscheduler/lists"}