gitwtfhub

wtf is sztu-grade-monitor?

para-lyze/sztu-grade-monitor — explained in plain English

Analysis updated 2026-05-18

14PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TL;DR

Automatically checks a Shenzhen Technology University student's grades and emails them when something changes.

Mindmap

mindmap
  root((repo))
    What it does
      Monitors university grades
      Emails on changes only
    Tech stack
      Python
      Selenium
      GitHub Actions
    Use cases
      Automatic grade alerts
      Skip manual checking
      Scheduled cloud runs
    Audience
      Students
      SZTU users
    Setup
      Needs private repo
      Needs QQ SMTP code

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Get an automatic email when your GPA, ranking, or course count changes.

REASON 2

Avoid manually logging into the academic system to check for grade updates.

REASON 3

Run the checker on a schedule using GitHub Actions instead of your own computer.

What's in the stack?

PythonSeleniumGitHub Actions

How it stacks up

para-lyze/sztu-grade-monitor0c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a private GitHub repo, several account secrets, and a QQ Mail SMTP authorization code, not your QQ password.

Wtf does this do

SZTU Grade Monitor is a tool built for students at Shenzhen Technology University to automatically watch their grades so they do not have to keep checking the school's academic system by hand. It logs into the university's system on your behalf, checks whether your grade summary has changed, and sends you an email through QQ Mail when it has. The tool is not affiliated with the university itself, and the README is explicit that anyone deploying it must set their copy up as a private repository, since it will hold personal login credentials. After the first successful run, it sends a confirmation email so you know monitoring has started correctly. After that, it only sends another email when your number of courses, total credits, cumulative GPA, or major ranking actually changes, so you are not spammed with repeated messages when nothing is new. Any newly calculated course grade point is only an estimate based on rounded totals, not an exact figure from the school's own system. Setting it up involves downloading a ready made deployment package, uploading it into your own private GitHub repository, and adding several secret values through GitHub's repository settings, including your student ID, academic system password, sending email address, an app specific mail authorization code, and the address that should receive alerts. Once those are configured, GitHub's own automation feature runs the check automatically roughly once an hour during a set daytime window each day, without needing your computer to be turned on. For anyone who prefers running it locally instead of through GitHub's automation, the project also works as a plain Python script, requiring Python 3.11 or newer along with a Firefox or Chrome browser installed, with credentials read from environment variables rather than written into the code. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Walk me through setting up the required GitHub repository secrets for this grade monitor.
Prompt 2
Help me get a QQ Mail SMTP authorization code so I can send alerts from this tool.
Prompt 3
Explain how to deploy this project's ready made package into a private GitHub repository.
Prompt 4
Show me how to run get_grades.py locally instead of through GitHub Actions.

Frequently asked questions

wtf is sztu-grade-monitor?

Automatically checks a Shenzhen Technology University student's grades and emails them when something changes.

What language is sztu-grade-monitor written in?

Mainly Python. The stack also includes Python, Selenium, GitHub Actions.

How hard is sztu-grade-monitor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sztu-grade-monitor for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.