EC2Control

A convenient tool for managing EC2 instance start/stop/restart operations

English | 简体中文

Features

• View EC2 instances across all AWS regions
• One-click start, stop, and reboot instances
• Filter by region
• Pin instances to top
• Dark/Light theme toggle
• English/Chinese interface switch

User Guide

1. Download the Application

Go to the Releases page and download the latest EC2Control-vx.x-Windows.exe file.

2. Install AWS CLI

Visit the AWS CLI Official Installation Guide and follow the instructions.

Verify installation:

aws --version

3. Create IAM User and Configure Permissions

1. Log in to the AWS IAM Console
2. Go to Policies panel, click "Create policy", select "Policy editor - JSON", and paste the following policy:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EC2ReadPermissions",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeInstances",
                "ec2:DescribeInstanceStatus",
                "ec2:DescribeRegions",
                "ec2:DescribeTags",
                "ec2:GetConsoleScreenshot",
                "ec2:GetConsoleOutput"
            ],
            "Resource": "*"
        },
        {
            "Sid": "EC2WritePermissions",
            "Effect": "Allow",
            "Action": [
                "ec2:StartInstances",
                "ec2:StopInstances",
                "ec2:RebootInstances"
            ],
            "Resource": "*"
        }
    ]
}

3. Go to Users panel, click "Create user", then in "Set permissions" page, click "Attach policies directly" and select the policy you just created
4. In the user details page, click "Security credentials", create an access key, select "Command Line Interface (CLI)" use case, and save the Access Key ID and Secret Access Key

4. Configure AWS Credentials

Use the aws configure command to set up credentials:

aws configure

Enter the following when prompted:

AWS Access Key ID [None]: Your Access Key ID
AWS Secret Access Key [None]: Your Secret Access Key
Default region name [None]: Default region (e.g., us-east-1, enter your most frequently used region)
Default output format [None]: json

5. Launch the Application

Double-click EC2Control-vx.x-Windows.exe to start using the application.

Development Guide

Install Dependencies

Main project dependencies:

• boto3 (>=1.26.0) - AWS SDK for Python
• flet (>=0.23.0) - Cross-platform GUI framework
• pyinstaller (>=5.13.0) - Packaging tool

Install all dependencies:

pip install -r requirements.txt

Code Quality Tools (Optional)

The project uses the following tools for code checking and formatting (development environment only):

pip install ruff black isort

Run the Application

python main.py

Build Executable

flet pack main.py --name "EC2Control" --icon "assets/icon.ico" --product-name "EC2Control"

The executable will be generated in the dist directory.

Code Quality: This project uses Ruff, Black, and isort for code quality checks. See pyproject.toml for configuration. CI runs checks automatically.

Project Structure

aws_ec2_gui/
│
├── .github/                     # GitHub configuration
│   └── workflows/               # GitHub Actions workflows
│       ├── build.yml            # Build and code quality checks
│       └── release.yml          # Auto release
│
├── assets/                      # Static resources
│   ├── logo.png                 # Logo
│   └── icon.ico                 # Icon
│
├── src/                         # Source code
│   ├── config/                  # Configuration module
│   │   ├── __init__.py
│   │   ├── constants.py         # Constants
│   │   └── settings.py          # Settings management
│   │
│   ├── core/                    # Core business logic
│   │   ├── __init__.py
│   │   ├── ec2_service.py       # EC2 service wrapper
│   │   └── cache_manager.py     # Cache management
│   │
│   ├── ui/                      # User interface
│   │   ├── __init__.py
│   │   ├── app.py               # Main application UI
│   │   ├── components/          # UI components
│   │   │   ├── __init__.py
│   │   │   ├── toolbar.py       # Toolbar
│   │   │   ├── instance_table.py # Instance table
│   │   │   └── console.py       # Console output
│   │   └── themes/              # Theme system
│   │       ├── __init__.py
│   │       ├── i18n.py          # Internationalization
│   │       └── font_scale.py    # Font scaling
│   │
│   ├── utils/                   # Utility functions
│   │   ├── __init__.py
│   │   └── screen_utils.py      # Screen utilities
│   │
│   └── main.py                  # Application entry
│
├── main.py                      # Launch script
├── requirements.txt             # Project dependencies
├── pyproject.toml               # Code quality configuration
├── README_CN.md                 # Chinese documentation
└── README.md                    # English documentation

Contributing

Feel free to send issue reports and submit pull requests — all contributions are appreciated.

License

This project is open-sourced under the MIT License.