wzj-signin 0.1.0

Auto sign-in tool for TeacherMate (WeZhiJiao)

wzj-signin

Auto sign-in tool for TeacherMate (微助教)

English | 中文

---

Features

• Normal sign-in — fully automatic
• GPS sign-in — auto sign-in with configured coordinates, with random jitter to avoid detection
• QR sign-in — displays QR code in terminal for scanning
• Email notification — sends alerts on sign-in success/failure

Installation

pip install wzj-signin

Or run directly without installing:

uvx wzj-signin

Quick Start

Environment Variables (Recommended)

OPEN_ID=xxx COURSE_ID=123 STUDENT_ID=456 wzj-signin

You can also pass the full TeacherMate URL as OPEN_ID:

OPEN_ID="https://v18.teachermate.cn/wechat-pro-ssr/?openid=xxx&from=wzj" COURSE_ID=123 uvx wzj-signin

Config File

Place a config.toml in the working directory (see config.toml.example):

[default]
openId = "xxx"
courseId = "123"
studentId = "456"
pollInterval = 10

# GPS coordinates (optional)
gps_lon = 113.999877
gps_lat = 22.595876

# Email notification (optional)
[email]
enable_send_email = false
smtp_server = "smtp.qq.com"
sender = "[e-mail]"
password = "your_smtp_password"
receiver = "[e-mail]"

Environment variables take priority over config file values.

Environment Variables

Variable	Description	Required
OPEN_ID	TeacherMate openId or full URL	✅
COURSE_ID	Course ID	✅
STUDENT_ID	Student ID (required for QR sign-in)	—
POLL_INTERVAL	Polling interval in seconds (default: 10)	—
GPS_LON	GPS longitude	—
GPS_LAT	GPS latitude	—
ENABLE_SEND_EMAIL	Enable email notification (true / 1)	—
SMTP_SERVER	SMTP server (default: smtp.qq.com)	—
EMAIL_SENDER	Sender email address	—
EMAIL_PASSWORD	SMTP authorization code	—
EMAIL_RECEIVER	Receiver email address	—

Tutorial

Get OpenId

1. Tap "All (A)" in the TeacherMate WeChat service account

   

2. Copy the URL from the browser address bar

   

   

3. The part after openid= in the URL is your OpenId:

   https://v18.teachermate.cn/wechat-pro-ssr/?openid=52279xxxxxxxxx81803b6cc9bb1cd24f&from=wzj
   

   You can also use the full URL as OPEN_ID directly — the program will extract it automatically.

Get Course ID

1. Open the TeacherMate course page and launch browser DevTools (F12)

   

   

2. Find the course-related API request in the Network tab to get the courseId

   

   

   

   

Configure config.toml

1. Copy the example config to your working directory:

   cp config.toml.example config.toml
   

2. Edit config.toml with your information:

   [default]
   openId = "your OpenId"
   courseId = "your Course ID"
   studentId = "your Student ID"  # required for QR sign-in
   pollInterval = 10               # polling interval (seconds)
   
   # GPS coordinates (optional, remove if not needed)
   gps_lon = 113.999877
   gps_lat = 22.595876
   

3. To enable email notifications, configure the [email] section:

   [email]
   enable_send_email = true
   smtp_server = "smtp.qq.com"
   sender = "[e-mail]"
   password = "your SMTP authorization code"
   receiver = "[e-mail]"
   

4. Run:

   wzj-signin
   

Demo

After starting, the program polls for active sign-ins and handles normal, GPS, and QR sign-ins automatically:

Email notification:

License

MIT