Grade Calculator

WHAT IT DOES

Grade Calculator is a floating panel that helps students, teachers, and professionals track academic performance across multiple assignments and exams. Enter your scores (points earned and total points possible) for each assignment or exam—the panel instantly calculates your current grade percentage, letter grade (A-F), and GPA equivalent based on a customizable grading scale. You can add or remove assignment rows dynamically as your semester progresses, assign weight percentages to individual assignments for weighted grading, and set a target grade to see exactly what score you need on remaining work to achieve your goal. The panel handles both weighted and unweighted grading automatically, adapting to whatever data you provide. You can insert your current grade percentage or letter grade directly into any editable field on the page (input, textarea, or contenteditable) with one click, or copy all results to your clipboard. Perfect for students tracking semester progress, teachers calculating final grades, or anyone needing quick grade projections.

WHERE IT RUNS

The panel overlays any website that loads the BotGentz extension—whether you're on a learning management system, 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 Grade Calculator, it will appear as a draggable widget near the bottom‑right corner of your viewport, with three default assignment rows pre‑filled. To calculate your grade:

- In each row, enter an assignment name (optional), earned points, total points possible, and optionally a weight percentage (leave empty for unweighted averaging).

- Add more assignments by clicking the "Add Assignment" button. Remove an assignment by clicking the "✕" button on its row (minimum one assignment required).

- The panel updates all calculations live—grade percentage, letter grade, and GPA.

To plan ahead:

- Enter a target grade percentage in the "Target grade (%)" field.

- The panel shows the score needed on remaining assignments to achieve that target, or tells you if it's already reached or impossible.

To use the results:

- Click "Insert Grade Percentage" to paste the current percentage into the focused editable field.

- Click "Insert Letter Grade" to paste the letter grade into the focused field.

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

The panel remembers your assignment list, target grade, and all entries across sessions.

BIDIRECTIONAL WEIGHTED/UNWEIGHTED ROUTING ENGINE

Unlike simple grade calculators that force either weighted or unweighted mode, this panel uses a bidirectional routing engine that detects which grading mode is active based on the data you enter. Each assignment row independently tracks whether a weight is provided. The engine builds two parallel computation paths: a weighted path that sums (earned/total)*weight for rows with weights, and an unweighted path that averages earned/total for rows without weights. A routing node then selects which path to display based on a simple rule: if any weight is present and the sum of weights is positive, use weighted; otherwise fall back to unweighted. This selection is deterministic and recalculated on every keystroke. The target planning module extends this by computing the remaining percentage needed using the same routing logic—if weighted mode is active, it calculates the weighted average of completed work and projects the required score on the remaining weight; if unweighted, it projects based on remaining point totals. The engine also includes a stateful scale resolver that maps percentages to letter grades and GPAs using a user‑configurable threshold array, with linear interpolation for GPAs when percentages fall between thresholds.

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 Canvas 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 assignment scores, weights, 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 grade calculations with your institution's official grading policies, as rounding conventions and weighting rules may vary.