SpeedLoop

SpeedLoop is a Windows-based Android x86/x64 emulator that enables Android system boot and application execution through QEMU-based CPU emulation and Windows API integration.

Features

• Android x86/x64 system boot
• Simple application execution
• Windows native window and input integration
• Keyboard and mouse input mapping
• Real-time display rendering

System Requirements

• Windows 10 or later
• Visual Studio 2019+ or MinGW-w64 GCC
• CMake 3.15 or later
• 2GB RAM minimum (4GB recommended)

Build Instructions

Using Visual Studio (MSVC)

cmake -B build -G "Visual Studio 17 2022"
cmake --build build --config Release

Using MinGW-w64

cmake -B build -G "MinGW Makefiles"
cmake --build build

The executable will be created at:

• MSVC: build/Release/SpeedLoop.exe
• MinGW: build/SpeedLoop.exe

Usage

Basic Usage

SpeedLoop.exe --boot-image assets\android_x86.img

Command Line Options

• --boot-image PATH - Path to Android boot image (default: assets/android_x86.img)
• --ram SIZE - RAM size in MB (default: 512)
• --resolution WxH - Window resolution (default: 1280x720)
• --test-mode - Enable test mode
• --timeout SECONDS - Timeout for test mode
• --help, -h - Show help message

Examples

# Run with custom RAM size
SpeedLoop.exe --boot-image assets\android_x86.img --ram 1024

# Run with custom resolution
SpeedLoop.exe --boot-image assets\android_x86.img --resolution 1920x1080

# Run in test mode with timeout
SpeedLoop.exe --test-mode --boot-image tests\test_boot.img --timeout 10

Project Structure

SpeedLoop/
├── src/
│   ├── cpu/          # CPU emulation core
│   ├── memory/       # Memory management
│   ├── gui/          # Windows GUI and rendering
│   ├── input/        # Input mapping
│   ├── main.c        # Entry point
│   └── logger.c      # Logging system
├── assets/           # Boot images and ROMs
├── tests/            # Test ROMs and scripts
├── logs/             # Log files
├── CMakeLists.txt    # Build configuration
└── README.md         # This file

Development

Adding New Features

1. Create feature branch from main
2. Implement changes following the design document
3. Test thoroughly
4. Submit pull request

Running Tests

cd tests
run_tests.bat

Troubleshooting

Build Issues

• Ensure CMake 3.15+ is installed
• Verify Visual Studio or MinGW-w64 is properly configured
• Check that Windows SDK is installed

Runtime Issues

• Verify boot image path is correct
• Check that sufficient RAM is available
• Review log files in logs/ directory

Documentation

• Requirements - Detailed requirements specification
• Design - Architecture and design documentation
• Tasks - Implementation task list

License

This project is for educational and development purposes.

Contributing

Contributions are welcome! Please follow the coding standards and submit pull requests for review.

Contact

For issues and questions, please use the project issue tracker.