English | 中文

A command-line tool for querying the balance of an ezCaptcha account.

• Query ezCaptcha account balance
• Automatic USD currency conversion
• Default China-optimized address
• Colorful output interface
• Support for Windows packaging
• Secure API key storage (using system credentials management)

pip install -r requirements.txt

1. Run the Python script directly:

python ezcaptcha_balance.py

2. Select an operation from the menu:
   • Query Account Balance: Check the balance for the currently set clientKey
   • Set New clientKey: Update your clientKey
   • Switch Storage Method: Toggle between system credentials storage and configuration file storage
   • Clear System Credentials/Reset Config File: Manage your stored credentials
   • Exit Program: Close the application

This tool supports two methods for storing the clientKey:

1. System Credentials Storage (default, recommended):

   • The clientKey is securely stored in the operating system's credentials manager
   • Windows uses Windows Credential Manager
   • macOS uses Keychain
   • Linux uses Secret Service API/KWallet/etc.
   • The actual clientKey is not saved in the configuration file

2. Configuration File Storage:

   • The clientKey is directly saved in the config.json file
   • Suitable for situations where system credentials management is unavailable
   • Not recommended for production environments

If you plan to modify or distribute this tool:

• config.json.template is a template for the configuration file and should not contain an actual clientKey
• The config.json file should be ignored in version control (e.g., add it to .gitignore)
• The keyring library ensures secure credential storage across platforms

Use the following command to package the program as an executable:

pyinstaller --onefile --icon=NONE ezcaptcha_balance.py

Do not use the --noconsole parameter as it will cause input(): lost sys.stdin errors since this program requires console input.

The compiled executable will be located in the dist directory.

• Ensure you have the correct clientKey
• Internet connection is required to query the balance
• If the China-optimized address connection fails, the program will automatically try using the backup address

This project is licensed under the MIT License - see the LICENSE file for details.