tls-xb

tls-xb is a cli tool that fetches scores and GPA from Tsinglan Xiaobao.

Features

• Access weighted and unweighted GPA, even when hidden.
• View detailed subject scores for all subjects.
• View scores from previous semesters.
• Color coded scores depending on performance.
• Tabled output.

Prerequisites

• tls-xb uses viuer to display the captcha, so a terminal supporting one of the supported graphics protocols is needed. Terminals supporting sixel be can found here.

  Recommended terminals:

  • Windows: Windows Terminal
  • macOS: iTerm 2
  • Linux: Kitty or WezTerm

Install

From binaries

The release page contains precompiled binaries for:

• Windows
  • Installer
  • Executable
• macOS
  • Apple Silicon
  • Intel
• Linux

From source

tls-xb is written in Rust, so the Rust toolchain will be needed to compile it.

cargo install tls-xb

# Git version
cargo install --git https://github.com/hey2022/tls-xb.git

Update

To update tls-xb simply reinstall a newer version.

Development

git clone https://github.com/hey2022/tls-xb.git
cd tls-xb

# Build
cargo build

# Run
cargo run

# Install
cargo install --path .

Usage

1. In your terminal, run tls-xb login to save your login details on your computer.
2. Run tls-xb to run the program.

FAQ

Can this change my GPA?

No tls-xb only fetches data from https://tsinglanstudent.schoolis.cn/api to calculate your GPA, which does not expose an api to change your GPA.

What is GPA Delta?

GPA Delta is the change in GPA when the grade of a subject increases or drops (when not changing to or from F). For example, if English increases from A to A+, GPA Delta would be the resulting change in GPA.