GPA Calculator

WHAT IT DOES

GPA Calculator is a floating panel that helps students track their academic standing across multiple courses. Enter your course names, credit hours, and letter grades (A, A-, B+, B, B-, C+, C, C-, D+, D, F)—the panel instantly calculates your cumulative GPA on a standard 4.0 scale, total credit hours completed, and total grade points earned. You can add or remove course rows dynamically as your transcript grows, and optionally set a target overall GPA to see what grades you need in future courses to achieve your goal. The panel includes a complete grade point scale reference that is fully customizable, so you can adjust it to match your institution's specific grading policies. You can insert your current cumulative GPA or total credit hours directly into any editable field on the page (input, textarea, or contenteditable) with one click, or copy all results to your clipboard. Perfect for college students tracking semester progress, advisors counseling students, or anyone needing quick GPA projections.

WHERE IT RUNS

The panel overlays any website that loads the BotGentz extension—whether you're on a university portal, a gradebook, a spreadsheet, a note-taking app, or any other web page. It works on all modern Chromium‑based browsers (Chrome, Edge, Brave, Arc) and Firefox. The script injects a self‑contained UI element that does not interfere with the host page's layout, styles, or JavaScript execution. It runs client‑side only, with no external API calls or cloud dependencies.

HOW TO USE

After installing the free BotGentz extension, visit any page and click the extension icon to activate the panel. The first time you use GPA Calculator, it will appear as a draggable widget near the bottom‑right corner of your viewport, with three default course rows pre‑filled. To calculate your GPA:

- In each row, enter a course name (optional), credit hours (e.g., 3 or 4), and select the letter grade from the dropdown menu.

- Add more courses by clicking the "Add Course" button. Remove a course by clicking the "✕" button on its row (minimum one course required).

- The panel updates all calculations live—cumulative GPA, total credits, and grade points.

To plan ahead:

- Enter a target overall GPA in the "Target overall GPA" field.

- The panel estimates the GPA you need on future courses (assuming additional credits equal to your current total) to reach that target, or tells you if you're already on track or if the target is unreachable.

To use the results:

- Click "Insert GPA" to paste the current cumulative GPA into the focused editable field.

- Click "Insert Total Credits" to paste the total credit hours into the focused field.

- Click "Copy All Results" to copy the GPA, credits, grade points, and target planning line to your clipboard.

The panel remembers your course list, target GPA, and all entries across sessions.

STATE‑DRIVEN CREDIT‑WEIGHTED AGGREGATION ENGINE WITH TARGET PROJECTION

Unlike simple GPA calculators that just average grade values, this panel uses a state‑driven aggregation engine that applies credit‑weighted averaging with precision anchoring. Each course row maintains independent state for name, credits, and grade. The engine aggregates total credits and total grade points (credits × grade value) using a reducer that accumulates both sums while tracking which rows are valid (positive numeric credits). The GPA is computed as grade points divided by credits, with special handling for edge cases (zero credits, missing data). The target planning module extends this with a projection model: given current credits and grade points, and a target GPA, it solves for the required grade point average on future courses using a linear equation. The engine assumes future courses will have the same average credit load as current courses (a configurable parameter), and computes the needed future GPA. If the required GPA exceeds 4.0, the target is flagged as unreachable. The grade scale itself is stored as a mutable array of {grade, value} pairs, and the dropdown options rebuild automatically whenever the scale changes—ensuring that any grading policy (including plus/minus or non‑standard scales) is fully supported without code changes.

THE PANEL

- Drag: Click and hold the panel's header bar to move it anywhere on the screen.

- Per‑site position: The panel stores its last position separately for each domain (e.g., different positions for Blackboard vs. Google Sheets) using the browser's localStorage, keyed by hostname.

- Snap: When dragged near any edge of the viewport, the panel snaps to that edge with a 16px margin for a clean, docked feel.

- Collapse: Click the "−" button in the header to collapse the panel to a compact title bar, preserving all current values. Click "+" to expand it back.

- Resize: Drag the bottom‑right corner handle to resize the panel from 280px to 600px wide and 200px to 500px tall; the layout adapts responsively.

- Escape: Press the Escape key while the panel is focused to close it entirely (you can reopen it from the extension toolbar).

PLEASE NOTE

This script requires the free BotGentz extension to run—it is not a standalone bookmarklet or user script. Websites frequently update their DOM structures and security policies; while we strive to keep the panel functional across thousands of sites, occasional updates may be needed. The calculator performs all operations entirely in your browser—no data is sent to any server, and no cookies or tracking identifiers are used. Your course data, grades, and targets remain private to your local session and are persisted only via GM_setValue (the extension's local storage) for convenience, not shared across devices or sessions. Always verify GPA calculations with your institution's official transcript, as rounding conventions and grade point policies may vary. The default grade scale follows the standard 4.0 system; customize it to match your school's specific grade equivalencies if needed.