xmu-rollcall-cli

A command-line tool for monitoring and auto-answering Tronclass rollcalls at Xiamen University.

This project is intended for personal learning and automation convenience. Use it at your own risk and comply with your school's rules.

Features

• Login with XMU unified authentication through xmulogin
• Continuous rollcall polling (1-second interval)
• Automatic handling for:
  • Number rollcalls (fetch number code and answer directly)
  • Radar rollcalls (location solving)
• Multi-account management in one local config
• Session cookie cache and refresh support

Installation

Install from PyPI:

pip install xmu-rollcall-cli

After installation, these command aliases are available:

• xmu
• xmu-rollcall-cli
• XMUrollcall-cli

Quick Start

1. Configure at least one account:

xmu config

2. (Optional) Switch active account:

xmu switch

3. Start monitoring:

xmu start

4. If session becomes invalid, refresh cookies:

xmu refresh

Commands

• xmu config - Add/delete accounts and set current account
• xmu switch - Switch the current account
• xmu start - Start rollcall monitoring loop
• xmu refresh - Remove cached cookies for current account
• xmu --help - Show help

Configuration

The package stores local data in a .xmu_rollcall directory:

1. XMU_ROLLCALL_CONFIG_DIR (if set)
2. ~/.xmu_rollcall (default)
3. ./.xmu_rollcall (fallback when home is not writable)

Main files:

• config.json: account list and selected account
• <account_id>.json: cached cookies per account

Example (custom config directory):

export XMU_ROLLCALL_CONFIG_DIR="$HOME/Documents/.xmu_rollcall"

Limitations

• QR code rollcalls are currently not supported.
• This tool depends on Tronclass/XMU API behavior and may break if upstream endpoints change.

Supported Python Versions

• Python 3.7+

Project Links

• Homepage: https://github.com/KrsMt-0113/XMU-Rollcall-Bot
• Issues: https://github.com/KrsMt-0113/XMU-Rollcall-Bot/issues

License

MIT License