GAutomator
github.com
What it is
GAutomator is a free, open-source framework for automating tests of mobile games on Android and iOS. It interacts with game-engine elements such as Unity GameObjects, allowing one script to operate across devices with different screen resolutions. Listed actions include locating objects, reading text and bounds, clicking, pressing, swiping and entering text. GAutomatorViewer inspects an application’s UI hierarchy and control properties, including GameObject names and attributes. Setup requires integrating the SDK into a game and writing Android or iOS test scripts. Android support covers Unity and UE4 games; the iOS Python library supports Unity, while other engines need separate environment configuration. Android requirements include Python 2.7 or 3.4+, Android SDK or adb, USB-connected device access and Android 4.3 (API 18) or later. Android scripts run on Windows or Linux. Some reporting functions are cloud-only, and scene tags work only in WeTest cloud reports.
Spec sheet
- Product
- GAutomator is an open source test automation framework for mobile games.Read 4 Oct 2026 · github.com
- Support
- The project README directs users to GitHub issues for bugs, requests, and usage questions, and lists QQ contact 800024531.Read 4 Oct 2026 · github.com
- Android engines
- The Android project supports Unity and UE4 games.Read 4 Oct 2026 · github.com
- Android requirements
- The Android project lists Python 2.7 or 3.4+, Android SDK or adb, USB-connected device access, and Android 4.3 (API 18) or later as requirements.Read 4 Oct 2026 · github.com
- Automation actions
- Its listed engine APIs include finding GameObjects, reading text and bounds, clicking, pressing, swiping, and entering text.Read 4 Oct 2026 · github.com
- Cloud reporting limit
- The README says scene tags are supported only in WeTest cloud reports and notes that some reporting functions are cloud-only.Read 4 Oct 2026 · github.com
- Desktop environments
- The Android project README says its scripts can run on Windows or Linux.Read 4 Oct 2026 · github.com
- Device controls
- Its device APIs include pressing Back, reading the current package and display rotation and size, and waiting for QQ or WeChat login.Read 4 Oct 2026 · github.com
- Game object testing
- It interacts with game engine elements such as Unity GameObjects, allowing one testing script to run on devices with different screen resolutions.Read 4 Oct 2026 · github.com
- Inspection tool
- GAutomatorViewer can inspect an application's UI hierarchy and control properties, including GameObject names and attributes.Read 4 Oct 2026 · github.com
- iOS engine support
- The iOS Python library supports Unity interaction; other engines require separate environment configuration.Read 4 Oct 2026 · github.com
- Setup
- Using GAutomator involves integrating its SDK into the game and writing iOS or Android testing scripts.Read 4 Oct 2026 · github.com
Strong points and limits
Strong points
- Open-source framework for mobile-game test automation
- Scripts can span different screen resolutions
- Supports Unity and UE4 Android projects
- Viewer inspects UI hierarchy and properties
- Runs Android scripts on Windows or Linux
Limits
- Requires SDK integration and custom test scripts
- Android setup requires older Python options or newer
- Some reporting functions are cloud-only
- Other iOS engines need separate configuration
Who it suits
GAutomator suits developers and testers automating mobile-game checks across Android and iOS. It is aimed at projects using Unity or UE4, with additional setup for other engines.
Verdict
GAutomator provides game-object-aware automation rather than only coordinate-based actions. Its engine coverage, setup requirements and cloud-report limitations should be checked before adoption.
Where Specifiction places it
- Study Timer Apps#32 of 436.8
- Game Testing Software#17 of 186.8