HITSZ Connect Verge

English | 中文

Introduction

HITSZ Connect Verge is a GUI of ZJU Connect. It helps you connect to the campus network of HITSZ remotely.

Features

• Fast and green compared to EasyConnect.
• Simplified UI and Fluent UI (Windows only).
• Built with PySide6 and Python, making it beginner-friendly to contribute and maintain.
• Multi-platform support, providing out-of-box experience without executing additional scripts.
• Advanced settings (coming soon).

Installation

You can install HITSZ Connect Verge in two ways: downloading pre-built binaries or building from source.

Note

1. Username and password are the same as the ones you use to log in to the Unified Identity Authentic Platform
2. If the download speed is slow, you can try using gh-proxy to download.

Method 1: Downloading pre-built binaries

HITSZ Connect Verge provides out-of-the-box experience. You can download the latest version from the release page.

Important

For macOS version, you need to grant access to the application by running:

sudo xattr -rd com.apple.quarantine hitsz-connect-verge.app

In some case, you need to go to macOS Settings -> System Preferences -> Security & Privacy -> Open Anyway.

Method 2: Building from source

1. Clone the repository:

   git clone https://github.com/kowyo/hitsz-connect-verge.git
   cd hitsz-connect-verge

2. Install dependencies:

   It is strongly recommended to use a virtual environment. You can create a virtual environment by running:

   python -m venv venv
   source venv/bin/activate # activate the virtual environment

   Then, install the dependencies:

   pip install -r requirements.txt

3. Run the application:

   python main.py

4. (Optional) Build the binaries:

   You can build the binaries for Windows by running:

   pyinstaller --clean --onefile --noconsole `
   --icon assets/icon.ico `
   --add-data "assets;assets" `
   --add-data "core/zju-connect;core" `
   -n hitsz-connect-verge main.py

   For macOS/Linux, you can run the following commands:

   pyinstaller --clean --onefile --noconsole --windowed \
   --icon assets/icon.icns \
   --add-data "assets:assets" \
   --add-data "core/zju-connect:core" \
   -n hitsz-connect-verge main.py

Screenshots

Windows	Mac	Linux

As of now, Linux version only supports building from source.

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request. For major changes, please open an issue first to discuss what you would like to change.

Also, any typo is welcome to be fixed.

Related Projects

• chenx-dust/HITsz-Connect-for-Windows: HITsz Edition of ZJU-Connect-for-Windows. Support advanced settings and multi-platform.
• Co-ding-Man/hitsz-connect-for-windows: Out-of-the-box zju-connect simple GUI for Windows, suitable for HITSZ.