GWA Calculator — User Guide

A lightweight Windows app that eliminates manual grade computation. This guide covers download, installation, troubleshooting, and the changelog.


.

Overview

GWA Calculator is a small Windows application for students to compute their General Weighted Average (GWA) quickly and accurately. It minimizes manual calculation and helps avoid mistakes when computing grades.

Features

  • Scrollable Subject List — All added subjects are displayed in a neat, monospaced, aligned list.
  • Instant GWA Calculation — Automatically computes your weighted average based on your input.
  • Clear All Button — Removes all subjects and resets the results.
  • Modern Dark UI — Built using CustomTkinter for a clean, modern interface.
  • NEW FEATURES (v1.7.0)
    • Upload Excel — Import subject, units, and grades directly from an Excel file.
    • Export to Excel — Save your computed results in a clean Excel file for record-keeping.
    • Info Guide Popup — Shows a quick guide on how to format your Excel file before uploading.
    • Right-Click Delete — Delete individual entries directly from the subject list using a right-click context menu.
    Installer

    Inno Setup installer that provides:

    • Start Menu and Desktop shortcuts
    • Program Files installation
    • Automatic uninstaller
    • A professional installation experience

GWA Formula

The General Weighted Average (GWA) is calculated using this formula:

GWA = (Σ (Grade × Units)) ÷ (Σ Units)

This means you multiply each subject’s grade by its corresponding number of units, add all those results, then divide by the total number of units.

System requirements

  • Windows 10 or newer
  • 50 MB free disk space
  • No additional runtime required (bundled)

Download & Installation

  1. Download GWA-Calculator v1.7.0 setup.zip.
  2. Right-click the ZIP → Extract All.
  3. Go to → Download folder.
  4. Run GWA-Calculator v1.7.0 setup.exe from the extracted folder.
  5. If Windows SmartScreen appears, click More info → Run anyway.
Note: The SmartScreen warning appears because the app is not code-signed. This is normal for new software.

How to use

Follow these steps to compute your GWA:

  1. Launch the app. You will see fields for subject name, units, and grade.
  2. Add subjects manually Type the subject name, units, and grade then click Add.
  3. Or import an Excel file Click Upload Excel and select your spreadsheet. Use the Info Guide button to see required formatting.
  4. Right-click entries to delete You can now remove individual subjects by right-clicking an item in the list.
  5. Click “Calculate GWA”. The weighted average will instantly appear on screen.
  6. Optional: Export results Save your GWA and subject list by clicking Export to Excel.
  7. Clear All to reset everything.

Troubleshooting

SmartScreen / "Isn't commonly downloaded" warning

This is a Windows SmartScreen message. It does not necessarily mean the file is malicious — it means Windows doesn't recognize the app. If you're the developer (or you trust the source), click More info » Run anyway.

App doesn't start
  • Make sure you extracted the ZIP first.
  • Try "Unblock" in file Properties.
  • Run as administrator if you suspect permissions issues.

FAQ

Is this app safe?
Yes. It does not contact external servers. The SmartScreen warning is because of the lack of code signing. Due to the budget constraints code signing in windows is not possible
Can I use it offline?
Yes, it’s safe. The app runs locally and never sends any data online. Windows may show a SmartScreen warning because the app isn’t code-signed yet. Code-signing certificates are paid and not currently included in the project budget.
Will you add save/load features?
Planned — CSV import/export is on the roadmap.

Changelog

  • v1.7.0 — New Features
    • Added Excel Upload
    • Added Export to Excel
    • Added Info Guide popup
    • Added right-click delete in subject list
  • v1.6.1.1 — Added “Update Data” feature for editing existing entries.

Support

For bug reports and feature requests, please open an issue on the GitHub repository or contact kevinbueno360@gmail.com.