iiumschedule / iium_schedule

Make/Generate IIUM timetable with ease. Integration with IIUM database. App available on Android, MacOS & Windows.

IIUM Schedule App

Generate a beautiful & clean IIUM Schedule quickly with automatic subject data fetching. View what courses are available to register at your fingertips.

Load timetable I-Ma'luum and your schedule is ready. As easy as that 😉

Contributions

Feel free to open up issues and/or submit pull requests.

Refer Wiki/Contributing for more info.

[July 2023] Now that I'm graduated from IIUM, your contributions are very much needed since I'm no longrt have access to I-Ma'luum etc. I'll do my best to maintain the project. InshaAllah.

Getting started

See Wiki/Build

Features

• Generate schedule (ClassUp style)
• Fetch timetable from I-Ma'luum (Android only)
• Save schedule in-app.
• Export as an image (so you can set it as lockscreen)
• Customize schedule (ie: Change colours etc.)
• Browse for subjects.
• Add final exam (and can be added to your favourite calendar)

Releases

App is available for Android, Windows, MacOS, iOS* and Web**. Check it out here!

[!NOTE] > *You'll need to build it yourself

[!NOTE] > **Web support is discontinued (Issue #60). See alternatives projects. Web version branch is 1.0.3-web.

Devlog

Motivation

• To contribute something to the university and its people. [خير الناس أنفعهم للناس]
• To make a tool that can generate a beautiful, lockscreen-worthy schedule for IIUM students that require minimal effort.
• and maybe others, read more here.

_{Actually, I'm pretty lazy to make my schedule manually for every semester. So, as a wise developer, we always do this.}

Website

For guides extracting subjects, release notes, privacy policy etc. Go to the website at:

https://iiumschedule.iqfareez.com

Similar project like this one

• https://github.com/asdacap/iiumschedule
• https://github.com/PlashSpeed-Aiman/IIUMCourseScheduleApp
• https://proreg.vercel.app
• https://github.com/qryskalyst20/simplified-imaluum

Open PR to add your project here

Contributors

PlashSpeed-Aiman 💻

Elyas Asmad 💻 🎨

Related repositories

• Website: https://github.com/iqfareez/iiumscwebsite
• Firebase Function: https://github.com/iqfareez/iiumschedule-functions
• recase: https://github.com/iqfareez/recase
• flutter_timetable_view: https://github.com/iqfareez/flutter_timetable_view

Mentions

• IIUM Today: https://news.iium.edu.my/?p=168911
• IIUM Online Fb: https://www.facebook.com/groups/iiumonline/posts/5394953453874491
• Twitter: https://twitter.com/iqfareez/status/1578755220674613250

Acknowledgment

• Conditional importing that allows compilation to all platforms - https://gpalma.pt/blog/conditional-importing/
• Inno installer setup - https://retroportalstudio.medium.com/creating-exe-executable-file-for-flutter-desktop-apps-windows-ea7c338465e
• Build release Android app on GitHub Action (CI/CD) - https://gist.github.com/vinicioslc/b9bd073c8013a726033a999db68a45be

Attributions

• 3DICons by @realvjy - https://3dicons.co/

iium_schedule's Issues

Exclude acronyms and roman number from being ReCase

Example:

System's navigation bar icon colour not visible

I want to say it regressed but it is not. This changes: 003c22e is to address the wrong navbar theme of the app and the system.

v1.1.0	v1.1.1

Note: This problem does not occur while using Gesture navigation.

exe installer compiled by Inno detected contain virus

The issue

Microsoft Defender detect the installer files contain Wacatac.B!ml.

It may be false positive? But it block the download using MS Edge.

After forcing download, when try to install. A dialog pop up and says it has virus error too.

Tested tested your manifest locally (winget) also fails. The output is something like: Anti virus program reported the program may contain virus.

Tested the file on virustotal, all green.

For context, the exe is compiled using Inno 6.2.1 on windows runner (Github action), downloaded and uploaded to assets.

Resolution:

Rebuid app for Windows and compile using Inno (same version, 6.2.1) locally.
Installation attempt : success

Recalculate hash and update the winget manifest.
Install attemp: Also success

The question is

Is there a problem with building the app & compiling the installers on GitHub runners?

Other peoples having the same issues:

• https://stackoverflow.com/questions/24864545/inno-setup-executable-seen-as-a-virus
• https://stackoverflow.com/questions/68834409/program-installed-with-inno-setup-seen-as-trojan-wacatac-bml

CERTIFICATE_VERIFY_FAILED: unable to get local issuer certificate(handshake.cc:363))

Happen out of sudden, maybe IIUM has changed configuration or anything to their servers? 🤷🏼‍♂️

Android (Tested on Android 10, Android 11, three different devices) ❌

Web ✅

For web, we are using proxy, remember?

Windows ✅

Incorrect casing after opening parenthesis `(`

Scope; https://github.com/iqfareez/recase

💡 Add venue to the schedule card

Without the need to open the dialog

:bug: Cannot fetch `TQTD2002` subject section `501` in schedule maker

Cannot fetch subject in Schedule Maker, but can fetch in course browser. Indicated that the problem is within the app and not albiruni.

After triaging, looks like for the subject alone, consuming for more than one page in albiruni.

Initially, I'm assuming the the filtered subject should exists in first page only:

https://github.com/iqfareez/iium_schedule/blob/8fb093891528f86ebe9886f01f9c7801d6e32722/lib/views/scheduler/course_validator.dart#L132-L138

Working on quic fix!

From twitter: https://twitter.com/ammarputeraa/status/1578780255833423872?s=20&t=IUCXf0DhgstoWb2jiZED-w

Final exam schedule

Add ability to add final exam schedule

Schedule Generator Implementation

Could you explain in short how did you implement the schedule maker? What libraries did you used to draw the schedule etc? I'm trying to do my own implementation in Java/Kotlin

💡 User's schedule data is not updated whenever data from i-Maluum is updated

Description

Whenever new data from i-Maluum emerges, user need to remove all the relative subjects and re-add it again to see the changes.

Steps to Reproduce

1. Create a new schedule by adding subjects or courses.
2. (At this particular time, there are some unassigned lecturers / lecture rooms for some courses).
3. Changes from i-Maluum didn't reflect on the current version of the app.
4. Users need to remove all subjects and re-add it again to see new data emerges.

More Information

Device: OnePlus 9 (LE2115)
OS: OxygenOS 12 (Android 12)
App Version: 1.0.3

Reported by @HaikalAkif

Attachments

💡 Add aspect ratio option in schedule screenshot page

By default, the schedule will render according to the device's screen size, but to offer more flexibility, aspect ratio options can be used to alter the output image.

Some insights

• Wrap with AspectRatio widget.
• Options: default, 16:9. 21:9. 4:3, potrait/landscape etc.

:zap: Prompt to update schedule or add auto update option

Problem

On our way to class, we refer to this app to locate the venue. The venue in the schedule is E1-5-4.3. But, when we arrive, there is notice on the door that the venue has been changed.

In the class, the lecturer mentioned that the venue is changed that morning. So, I refresh the schedule (using pull-to-refresh feature) and as expected, the venue in the app update to the current latest venue.

Proposal

I think it would be better that the app support auto-updating the schedule (especially venue), or at least, the app will scan for changes in the background, and inform the user if they want to apply those changes. So that, problem like above can be prevented.

Day row not aligned with subject columns

As mentioned in #4 (comment)

very funny

Finish adding @fire-bot to your repo

Greetings, fire here!

@iqfareez recently invited @fire-bot to this repository. Before fire is enabled, @iqfareez needs to complete a few steps:

Complete fire setup now

Only @iqfareez will be able to enable fire using the above link. If someone added fire by mistake, feel free to remove @fire-bot from your repo's collaborators.

Fork Scraper

If you want a working scraper, you can port my Java code to dart. It can collect the course data correctly

✨ Sharing/copy schedule link to others

Able to create a link to access a read only schedule. Useful when to share schedule to other/view schedule to other devices while keeping in sync its origin.

Use pubspec_overrides.yaml to improve dev productivity

Currently using dependency_overrides in pubspec.yaml file to improve local development experience. However, it become hassle to comment it so it can be run in CI.

Waiting for this feature to land on stable.

Flutter Web Renderer issues

According to https://docs.flutter.dev/development/platform-integration/web/renderers

auto (default) - automatically chooses which renderer to use. This option chooses the HTML renderer when the app is running in a mobile browser, and CanvasKit renderer when the app is running in a desktop browser.

So,

• on mobile -> HTML
• on desktop -> CanvasKit

From my testing with the latest release, there are issues with:

• Saving screenshot
• Overflow text

Saving screenshot

Web desktop (CanvasKit)	Web mobile (HTML)
✅	❌

TextOverflow

Web desktop (CanvasKit)	Web mobile (HTML)

I will do further testing and verification

💄 Material You redesign

Migrate to Material 3 when Flutter components migration finishes
flutter/flutter#91605

Wrong lecturer name

From Yusoff

Hi, I'm a big fan of you, really mesmerised by how you built this app. Always support you 💪.There's a problem where name of lecturer and venue is not automatically extracted in the schedule. Dunno if this is a bug or anything but this issue needs your attention tqq.

Hmm. Perhaps there are some difference in data betweem albiruni & Ima'luum??

💡Custom schedule background

Handle lower case in manual add new subject

When lower case, it won't work.

When uppercase, it works, probably something to do with the formatting

winget submission for Windows installation

Currently have issue with virus error?

PR: microsoft/winget-pkgs#68784

:bug: Cannot copy text when selection handler changed

Issue description

When resizes selection, the option Copy and Select All are missing.

Screenrecorder-2023-02-28-09-55-25-987.mp4

Resolution

This is known issue from Flutter framework: flutter/flutter#119314

💡 Homescreen widget

From feedback iP9QLRvAA9MYoyFwpHAy:

• easy access for the app
• recommended widget:
  • reminder for next class
  • schedule timetable

💡 Enable 12h time settings

Add option to toggle time 12hr/24 hr in timetable. Currently it shows 24h.

Ref: 8FAHP0zQnepwullUkgqk

🐛 Schedule edit/delete feature is reset to original state after leaving the app

The modified schedule data is not retained in the db.

Example situation to reproduce this:

• Edit venue of saved schedule
• Delete a subject
• Change colour
• etc.

When the app reopened, the data back to its original state.

app version in Windows is not updated

This is known issue with the Flutter framework, and fixes is coming soon: https://github.com/flutter/flutter/wiki/Updating-Windows-project-to-flow-version-information

Alternative solution: Change manually in Runner.rc file.

Related discussion:
flutter/flutter#73652
fluttercommunity/plus_plugins#343
fluttercommunity/plus_plugins#929

:alien: Drop Web Support

The Problem

The web can't be deployed because Isar 3.0.0+ still doesn't have web support. Refer: isar/isar#686

In addition, I've created ci-config.yml file to define which flutter version and build targets when build_all.yml is triggered.

# Flutter channel: `stable` or `beta` or `master`
flutter_channel: stable

# build target. Set `true` or `false`
build_for:
  windows: true
  android: true
  web: false

Will re-enable the web target once Isar issue is fixed.

Action

To experience the new features and improvements, consider using IIUM Schedule app on different platforms - Android/Windows/MacOS. Download them here: https://iiumschedule.iqfareez.com/downloads

reimplement web app using web frameworks (ie. vue-js,reactjs )

Application takes a while to download, and consumes a lot of space.

🐛 ListView grey bug in course browser

Steps to reproduce

1. Open Course Browser
2. Choose KICT, year 21/22, sem 3.

2022-10-11.19-03-42.mp4

Missing Documentation

Course Browser navigation to next page

🚸 Course browser stop navigating where it ends

Current behavior:

Screen_Recording_20221012_043844.mp4

Inifinite page to load data as there is no way to get the length of the item beforehand

Proposed changes: Stop page at the first 'Oopps, you may want to go back'

💡 Manual adding subject after saving

Use case: prereg add/drop

💡 Editable schedule

This is most requested feature since the first release. I'm going to implement the following gradually.

• Edit venue
• Edit time
• Delete/hide subject (use case: tutorial hour)
• etc. (Suggestion please)

Print schedule to PDF or PNG Feature

print to pdf feature on browser is not suitable. User was unable to print PDF after making schedule.

Dart PDF

https://pub.dev/packages/pdf

Printing current screen

https://stackoverflow.com/questions/51117958/how-to-take-a-screenshot-of-the-current-widget-flutter
https://pub.dev/packages/screenshot

Downloading Schedule directly from iMaalum using student credentials

I've been trying to figure out how to download the confirmation slip directly from iMaalum's website using POST requests. It seems I need to find out how to do GET request with cookies.

Play Store screenshot

• Redesign
• Use latest screenshot with modern phone

Info banner cannot be dismissed

The info banner on i-Ma'luum importer (sometimes) can't be dismissed/not dismissed automatically.

Steps to reproduce

1. Open Imaluum importer
2. Try to login with wrong credential (I think this triggers the page refresh and hence the banner is retriggered)
3. Exit the imaaluum importer (either by using back button or arrow)

Video

Screen_Recording_20230302_071837.mp4

Crash when pressing Next button on keyboard

Reproduce steps

Screenrecorder-2022-03-14-07-56-48-913.mp4

Workaround

Avoid pressing the next action on keyboard.

Use temporary directory to store image when sharing on Windows

Currently, the getTemporaryDirectory() method from path_provider is not supported on Windows. Issue flutter/flutter#105386

So, as for now we will use Document directory (same directory to store Hive data)

💡 Add schedule shortcut widget

Use case: A launcher icon to launch a specific schedule

Kinda like this feature:

Screen_Recording_20221012_043736_One.UI.Home.mp4

Can use the following package
https://pub.dev/packages/home_widget

Highlight current day

Lane, or day name for the current day can be highlighted for easy for users to click on subject on that day.

Implement subject picker in schedule maker

Enable user to either store subjects (like add to cart) from the browser and reference it when inside the schedule maker.

Add to Calendar feature

Add to Calendar feature for

• Class timetable
• #66

reduce flutter web bundle size

pretty like what is said in #12

Combine concurrent and similar subject

Example;

💡 Add send email to myself

On Windows & Web, there shareFiles() method is not implemented (yet, at least for Windows). Therefore, sending schedule file to the email might be a suitable substitute.

🚸 UX: Add subject from another schedule

From "Zainab":

I think it will be better if there is an option to "Add course" from another kuliyyah after the schedule is complete. Because some students take courses from multiple kuliyyah like kirkhs, celpad, cocu. I was wondering just now how to add my cocu class bcoz we only have an option to choose from one kuliyyah at the start. But i discovered that i just can add course code from another kuliyah but i have to select the kuliyah at the third stage. Maybe you can add note or something to tell that.Nevertheless the overall experience is great! Keep it up! Thank you👍