Skip to content

AMRYB/GPA-Calculator

GPA Calculator Logo

Chrome Extension that improves the HNU MyU dashboard UI and calculates GPA/CGPA correctly.
Open MyU Dashboard · Report bug · Request feature


Table of contents


Quick start

1) Download / Clone

  • Download the ZIP or clone the repo.

2) Load the extension in Chrome

  1. Open chrome://extensions
  2. Enable Developer mode
  3. Click Load unpacked
  4. Select the project folder

3) Use it

  1. Go to:
    • https://myu.hnu.edu.eg/dashboard
  2. Open the extension popup
  3. Click Run

If you run it on another website, the extension will show a warning and a button that takes you to the dashboard.


Features

UI Improvements

  • Clean GPA/Grades summary layout:
    • Left: GPA + Term Marks
    • Right: CGPA + Cumulative Marks
  • Terms are automatically sorted:
    • By year (2023, 2024, 2025…)
    • Inside each year: FALL → SPRING → SUMMER

Accurate Calculations

  • UN31-Math0 is ignored completely:
    • Not included in GPA / CGPA
    • Not included in marks
    • Not included in credit hours
  • GPA (Term) is calculated from the current term only.
  • CGPA (Cumulative) handles repeated courses correctly:
    • If a course was taken multiple times, CGPA counts only the highest attempt
    • Older attempts are treated as if they don’t exist in CGPA

Progress Tracking

  • Registered Hours (Term)
  • Passed Hours (Term)
  • Completed Hours (Cumulative)
  • Remaining Hours out of 138

How it works

  • The extension injects a content script into the MyU dashboard page.
  • It reads the grades/subjects table(s), normalizes the data, and:
    • Builds a clean summary UI
    • Calculates GPA for the selected term
    • Calculates CGPA cumulatively using the “best attempt” rule for repeated courses
    • Excludes UN31-Math0 everywhere
  • It does not modify your grades or the backend — it’s UI + calculations only.

What's included

.
├── assets/
│   ├── css/
│   │   └── style.css
│   ├── img/
│   │   ├── Big_logo.png
│   │   ├── favicon.png
│   │   └── logo.png
│   ├── instructions/
│   │   ├── Page_1.png
│   │   └── Page_2.png
│   └── js/
│       └── popup.js
├── MyriadArabic.woff2
├── warning.png
├── content.js
├── manifest.json
├── popup.html
└── README.md


Notes

  • Total required hours are set to 138 in the code.
  • This project is intended for HNU MyU Dashboard only.

Bugs and feature requests

If you found a bug or want a new feature:

  • Search existing issues first

  • Then open a new one:

    • Bug: ../../issues/new?template=bug.md
    • Feature: ../../issues/new?template=feature.md&labels=feature

Notes

Important Notes

  • HCBA faculty support is still experimental.
    I currently do not have an HCBA account to fully test all scenarios, so some edge cases may exist. There is also a possibility that some courses are not included correctly in the calculations.

  • If you see a message indicating that you cannot use the tool, don’t worry.
    I will personally guide you on how to use it correctly, or explain alternative ways to calculate your GPA.

  • In some cases, there may be workarounds or known calculation gaps that can still allow you to get accurate results. If you encounter any issues, feel free to reach out or open an issue.

About

GPA Calculator for HNU students

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages