bitsrun

🌐 A headless login and logout CLI app for 10.0.0.55 at BIT, now in Rust.

Install

One-line install (Linux / macOS, recommended)

• curl -fsSL https://cdn.jsdelivr.net/gh/spencerwooo/bitsrun-rs@main/install.sh | sh -

Ubuntu / Debian

• Download the latest .deb package from Releases.
• sudo dpkg -i <file>.deb

Cargo

• cargo install bitsrun

Download binary

• Download the latest binary from Releases.
• Uncompress file: tar -xvf <file>.tar.gz
• Move binary to $PATH, such as: mv <file>/bitsrun ~/.local/bin/

Usage

To log into or out of the campus network, simply:

$ bitsrun login -u <username> -p <password>
bitsrun: <ip> (<username>) logged in

$ bitsrun logout -u <username>
bitsrun: <ip> logged out

To check device login status:

$ bitsrun status
bitsrun: <ip> (<username>) is online
┌────────────────┬───────────────┬───────────────┬─────────┐
│ Traffic Used   │ Online Time   │ User Balance  │ Wallet  │
├────────────────┼───────────────┼───────────────┼─────────┤
│ 188.10 GiB     │ 2 months      │ 10.00         │ 0.00    │
└────────────────┴───────────────┴───────────────┴─────────┘

Available commands

$ bitsrun --help
A headless login and logout CLI app for 10.0.0.55 at BIT

Usage: bitsrun [OPTIONS] [COMMAND]

Commands:
  login         Login to the campus network
  logout        Logout from the campus network
  status        Check device login status
  config-paths  List all possible config file paths
  help          Print this message or the help of the given subcommand(s)

Options:
  -v, --verbose  Verbose output
  -h, --help     Print help
  -V, --version  Print version

[!TIP] Use environment variable NO_COLOR=true to disable colored output.

Credentials

To save your credentials, create config file bit-user.json under an available config path as:

{
  "username": "<username>",
  "password": "<password>"
}

Available config file paths can be listed with:

$ bitsrun config-paths
bitsrun: list of possible config paths
┌──────────┬─────────────────────────────────────────────────────────────┐
│ Priority │ Possible Config Path                                        │
├──────────┼─────────────────────────────────────────────────────────────┤
│ 1        │ /Users/spencerwoo/.config/bit-user.json                     │
│ 2        │ /Users/spencerwoo/.config/bitsrun/bit-user.json             │
│ 3        │ /Users/spencerwoo/Library/Preferences/bitsrun/bit-user.json │
│ 4        │ bit-user.json                                               │
└──────────┴─────────────────────────────────────────────────────────────┘

[!NOTE] The config file location is OS-dependent. Run the command to check the accepted locations on your system.

Set permissions of this file to 600 on Linux and macOS, or bitsrun will refuse to read it.

$ chmod 600 <path/to/bit-user.json>

Related

• zu1k/srun - Srun authentication system login tools. (Rust)
• Mmx233/BitSrunLoginGo - 深澜校园网登录脚本 Go 语言版 (Go)
• vouv/srun - An efficient client for BIT campus network. (Go)
• BITNP/bitsrun - A headless login / logout script for 10.0.0.55 at BIT. (Python)

License

MIT