# Genymobile - Android Emulator for App Testing & Development

> https://rozz.genymotion.com/

## About Genymobile

Genymobile provides Genymotion: a powerful Android emulator for PC, Mac, and Cloud environments . Trusted by leading companies including Verizon, Tinder, Meta, and IBM, Genymotion enables developers and QA teams to test Android applications at scale with virtual device simulation, GPS, battery, and network condition testing capabilities.

**Expertise:**
- Industry-leading Android emulation technology trusted by Fortune 500 companies
- Available on Desktop (PC/Mac), Cloud (SaaS), and on-premise deployments
- Comprehensive device simulation including GPS, battery, camera, and network conditions
- Integrations with CI/CD pipelines for automated mobile testing

**Focus Areas:** Network & Security Config, Mobile Test Automation, CI/CD Automation, Cloud Deployment Options, Download & Installation, System Requirements & Compatibility

## Executable Runbooks

Step-by-step CLI walkthroughs designed for AI coding agents with terminal access. Fetch and execute these directly:

- [gmsaas CLI Runbook — AI Assistant Guide for Genymotion Cloud](https://rozz.genymotion.com/runbooks/gmsaas-cli-runbook.html)
- [gmtool & genyshell Runbook — AI Assistant Guide for Genymotion Desktop](https://rozz.genymotion.com/runbooks/gmtool-desktop-runbook.html)
- [Runbook index](https://rozz.genymotion.com/runbooks/index.html)

## How to Access This Content

This content is optimized for AI retrieval:
- **Q&A Pages**: Self-contained answers with Schema.org QAPage markup
- **Source Attribution**: Each answer links to original source pages
- **Structured APIs**: JSON endpoints for bulk access

### Recommended Access Pattern
1. **Execute runbooks**: `/runbooks/` — CLI walkthroughs AI agents can run directly in terminal
2. Start with `/api/qna.json` for all Q&A content with answers
3. Use `/api/pages.json` for full page index with metadata
4. Individual pages at `/qna/{slug}.html` for detailed answers
5. See `/llms-full.txt` for complete Q&A content inline

## Key Content

**Featured Pages:**
- [How to root a Genymotion virtual device?](https://rozz.genymotion.com/pages/how-to-root-a-genymotion-virtual-device.html)
- [What are Genymotion Desktop requirements?](https://rozz.genymotion.com/pages/what-are-genymotion-desktop-requirements.html)
- [Camera is unavailable after quick boot (QEMU)](https://rozz.genymotion.com/pages/camera-is-unavailable-after-quick-boot-qemu.html)
- [I recently upgraded VirtualBox and Genymotion no longer works](https://rozz.genymotion.com/pages/i-recently-upgraded-virtualbox-and-genymotion-no-longer-work.html)
- [Genymotion: 2025 Year in Review](https://rozz.genymotion.com/pages/genymotion-2025-year-in-review.html)

**Top Questions:**
- [What is the full guide to using ARM-based virtual Android with Genymotion?](https://rozz.genymotion.com/qna/what-is-the-full-guide-to-using-arm-based-virtual-android-wi.html)
- [What is the step-by-step installation guide for Genymotion, including the system requirements and...?](https://rozz.genymotion.com/qna/what-is-the-step-by-step-installation-guide-for-genymotion-i.html)
- [What is available in the free version and how it differs from the paid version, and what limitati...?](https://rozz.genymotion.com/qna/what-is-available-in-the-free-version-and-how-it-differs-fro.html)
- [What are the pricing and revenue plans at Genymotion?](https://rozz.genymotion.com/qna/what-are-the-pricing-and-revenue-plans-at-genymotion-2.html)
- [What is the web URL for Genymotion 1 on genymotion.com?](https://rozz.genymotion.com/qna/what-is-the-web-url-for-genymotion-1-on-genymotion-com.html)

## Topic Index

### Network & Security Config

**Pages:**
- [I can't sign in to Genymotion Desktop](https://rozz.genymotion.com/pages/i-can-t-sign-in-to-genymotion-desktop.html)
- [The Virtual Device display doesn't show in web browser with Genymotion PaaS/D...](https://rozz.genymotion.com/pages/the-virtual-device-display-doesn-t-show-in-web-browser-with-2.html)
- [Is Genymotion affected by the log4j vulnerability](https://rozz.genymotion.com/pages/is-genymotion-affected-by-the-log4j-vulnerability.html)
- [My webcam does not work with Genymotion Desktop](https://rozz.genymotion.com/pages/my-webcam-does-not-work-with-genymotion-desktop.html)
- [I get the error "Network error - can't connect" when I launch Genymotion Desktop](https://rozz.genymotion.com/pages/i-get-the-error-network-error-can-t-connect-when-i-launch-ge.html)
- [How to use a VPN with Genymotion PaaS?](https://rozz.genymotion.com/pages/how-to-use-a-vpn-with-genymotion-paas.html)
- [I get the error "Too many attempts, please try again later."](https://rozz.genymotion.com/pages/i-get-the-error-too-many-attempts-please-try-again-later.html)
- [Genymotion PaaS Overview](https://rozz.genymotion.com/pages/genymotion-paas-overview.html)
- [Camera and Media Injection](https://rozz.genymotion.com/pages/camera-and-media-injection.html)
- [Advanced Developer Tools](https://rozz.genymotion.com/pages/advanced-developer-tools.html)

**Q&As:**
- [Which device‑cloud providers support real cellular connectivity for OTP delivery, and how can I i...?](https://rozz.genymotion.com/qna/which-devicecloud-providers-support-real-cellular-connectivi.html)
- [Does Genymotion provide rooted device? Because without the rooted device it is not possible to ca...?](https://rozz.genymotion.com/qna/does-genymotion-provide-rooted-device-because-without-the-ro.html)
- [How do I connect a camera to Genymotion via USB?](https://rozz.genymotion.com/qna/how-do-i-connect-a-camera-to-genymotion-via-usb.html)
- [Do I need to pay for root access on Genymotion?](https://rozz.genymotion.com/qna/do-i-need-to-pay-for-root-access-on-genymotion.html)
- [Does the paid version of Genymotion support root access and allow writing custom certificates int...?](https://rozz.genymotion.com/qna/does-the-paid-version-of-genymotion-support-root-access-and.html)

### Mobile Test Automation

**Pages:**
- [Integrations](https://rozz.genymotion.com/pages/integrations.html)
- [Genymotion Java API](https://rozz.genymotion.com/pages/genymotion-java-api-4.html)
- [Cloudbeat](https://rozz.genymotion.com/pages/cloudbeat.html)
- [Applitools](https://rozz.genymotion.com/pages/applitools.html)

**Q&As:**
- [What is the maximum number of parallel devices supported by Genymotion?](https://rozz.genymotion.com/qna/what-is-the-maximum-number-of-parallel-devices-supported-by-2.html)
- [How to integrate using Appium Node?](https://rozz.genymotion.com/qna/how-to-integrate-using-appium-node.html)
- [Can you show me an example of a pipeline for CircleCI?](https://rozz.genymotion.com/qna/can-you-show-me-an-example-of-a-pipeline-for-circleci.html)
- [Is Pikmin compatible with Genymotion Desktop?](https://rozz.genymotion.com/qna/is-pikmin-compatible-with-genymotion-desktop.html)

### CI/CD Automation

**Pages:**
- [FlintLab Announces Strategic Partnership with Genymotion](https://rozz.genymotion.com/pages/flintlab-announces-strategic-partnership-with-genymotion.html)
- [Github Actions](https://rozz.genymotion.com/pages/github-actions.html)
- [Bitrise](https://rozz.genymotion.com/pages/bitrise.html)
- [Microfocus](https://rozz.genymotion.com/pages/microfocus.html)

**Q&As:**
- [Does Genymotion SaaS support running and scaling Detox tests in CI?](https://rozz.genymotion.com/qna/does-genymotion-saas-support-running-and-scaling-detox-tests.html)
- [Does Genymotion support GitLab CI/CD integration, and how do I use it?](https://rozz.genymotion.com/qna/does-genymotion-support-gitlab-ci-cd-integration-and-how-do.html)

### Cloud Deployment Options

**Pages:**
- [How to create and setup a STUN/TURN server on AWS?](https://rozz.genymotion.com/pages/how-to-create-and-setup-a-stun-turn-server-on-aws-2.html)
- [Is Genymotion free?](https://rozz.genymotion.com/pages/is-genymotion-free.html)
- [The display is stuck at "Connecting to your virtual device..." and I can't ac...](https://rozz.genymotion.com/pages/the-display-is-stuck-at-connecting-to-your-virtual-device-an.html)
- [How to stop a virtual device in Genymotion SaaS?](https://rozz.genymotion.com/pages/how-to-stop-a-virtual-device-in-genymotion-saas.html)
- [Will I be charged for using an application, sharing an URL, or running a devi...](https://rozz.genymotion.com/pages/will-i-be-charged-for-using-an-application-sharing-an-url-or.html)
- [I have been incorrectly charged by my cloud provider. Can I request a refund?](https://rozz.genymotion.com/pages/i-have-been-incorrectly-charged-by-my-cloud-provider-can-i-r.html)
- [Which Android images are available?](https://rozz.genymotion.com/pages/which-android-images-are-available.html)
- [How to screen record with Genymotion PaaS/Device image?](https://rozz.genymotion.com/pages/how-to-screen-record-with-genymotion-paas-device-image.html)
- [How to set alarms, schedules and auto-shuthdowns to avoid extra charges with ...](https://rozz.genymotion.com/pages/how-to-set-alarms-schedules-and-auto-shuthdowns-to-avoid-ext-2.html)
- [How to create a pre-configured (template) Genymotion PaaS/Device image instance?](https://rozz.genymotion.com/pages/how-to-create-a-pre-configured-template-genymotion-paas-devi.html)

**Q&As:**
- [What is the web URL for Genymotion 1 on genymotion.com?](https://rozz.genymotion.com/qna/what-is-the-web-url-for-genymotion-1-on-genymotion-com.html)
- [What are the top 10 most important features for cloud-based android emulator?](https://rozz.genymotion.com/qna/what-are-the-top-10-most-important-features-for-cloud-based.html)
- [What is this used for?](https://rozz.genymotion.com/qna/what-is-this-used-for.html)
- [What is the difference between Saas and Desktop platform?](https://rozz.genymotion.com/qna/what-is-the-difference-between-saas-and-desktop-platform.html)
- [What are the costs of Genymotion Cloud and how does billing work? / Or you can guide me on how to...?](https://rozz.genymotion.com/qna/what-are-the-costs-of-genymotion-cloud-and-how-does-billing.html)
- [What are the main benefits compared to a self‑hosted solution?](https://rozz.genymotion.com/qna/what-are-the-main-benefits-compared-to-a-selfhosted-solution.html)
- [How can Genymotion use the cloud on a Windows machine?](https://rozz.genymotion.com/qna/how-can-genymotion-use-the-cloud-on-a-windows-machine.html)
- [How can I use Genymotion cloud on a Windows machine?](https://rozz.genymotion.com/qna/how-can-i-use-genymotion-cloud-on-a-windows-machine.html)
- [How to run the emulator in the cloud?](https://rozz.genymotion.com/qna/how-to-run-the-emulator-in-the-cloud.html)
- [How can Genymotion be managed on-premises?](https://rozz.genymotion.com/qna/how-can-genymotion-be-managed-on-premises.html)

### Download & Installation

**Pages:**
- [Genymotion Desktop and standard (non admin) user accounts on Windows](https://rozz.genymotion.com/pages/genymotion-desktop-and-standard-non-admin-user-accounts-on-w.html)
- [How to enable hardware virtualization (VT-x/SVM) on Windows 11?](https://rozz.genymotion.com/pages/how-to-enable-hardware-virtualization-vt-x-svm-on-windows-11.html)
- [How to access a local host or service from a virtual device?](https://rozz.genymotion.com/pages/how-to-access-a-local-host-or-service-from-a-virtual-device.html)
- [How to share folders with Genymotion Desktop host machine?](https://rozz.genymotion.com/pages/how-to-share-folders-with-genymotion-desktop-host-machine.html)
- [How to connect a USB device to a virtual device with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-connect-a-usb-device-to-a-virtual-device-with-genymot.html)
- [How to fix "Your CPU is incompatible with virtualization technologies" error?](https://rozz.genymotion.com/pages/how-to-fix-your-cpu-is-incompatible-with-virtualization-tech.html)
- [Genymotion Desktop and firewalls](https://rozz.genymotion.com/pages/genymotion-desktop-and-firewalls-2.html)
- [Genymotion Desktop and VPN](https://rozz.genymotion.com/pages/genymotion-desktop-and-vpn.html)
- [My Bank application does not work](https://rozz.genymotion.com/pages/my-bank-application-does-not-work.html)
- [I recently upgraded VirtualBox and Genymotion no longer works](https://rozz.genymotion.com/pages/i-recently-upgraded-virtualbox-and-genymotion-no-longer-work.html)

**Q&As:**
- [What is the step-by-step installation guide for Genymotion, including the system requirements and...?](https://rozz.genymotion.com/qna/what-is-the-step-by-step-installation-guide-for-genymotion-i.html)
- [Why is an Oracle Virtual Box required for Windows installation?](https://rozz.genymotion.com/qna/why-is-an-oracle-virtual-box-required-for-windows-installati.html)
- [Why does Genymotion Device Link show a white or frozen screen, and how to fix it?](https://rozz.genymotion.com/qna/why-does-genymotion-device-link-show-a-white-or-frozen-scree.html)
- [Why does Genymotion not connect even after installation?](https://rozz.genymotion.com/qna/why-does-genymotion-not-connect-even-after-installation.html)
- [How can I download Genymotion SaaS 3.5.0 OS?](https://rozz.genymotion.com/qna/how-can-i-download-genymotion-saas-3-5-0-os.html)
- [How can I uninstall Genymotion from Linux?](https://rozz.genymotion.com/qna/how-can-i-uninstall-genymotion-from-linux.html)
- [How to fix issues after upgrading to Windows 11 25H2 on Genymotion?](https://rozz.genymotion.com/qna/how-to-fix-issues-after-upgrading-to-windows-11-25h2-on-geny.html)
- [How can I download Genymotion on a MacBook Air with version 12.7.6?](https://rozz.genymotion.com/qna/how-can-i-download-genymotion-on-a-macbook-air-with-version.html)
- [How to install Genymotion Desktop 3.10?](https://rozz.genymotion.com/qna/how-to-install-genymotion-desktop-3-10.html)
- [Which Genymotion version should I download for an Intel Mac?](https://rozz.genymotion.com/qna/which-genymotion-version-should-i-download-for-an-intel-mac.html)

### System Requirements & Compatibility

**Pages:**
- [I'm getting an alert from macOS that Genymotion won't be supported in the future](https://rozz.genymotion.com/pages/i-m-getting-an-alert-from-macos-that-genymotion-won-t-be-sup.html)
- [I have sound issues on mac M series](https://rozz.genymotion.com/pages/i-have-sound-issues-on-mac-m-series.html)
- [Starting a virtual device fails with "VBoxHeadless.exe - Application Error. [...](https://rozz.genymotion.com/pages/starting-a-virtual-device-fails-with-vboxheadless-exe-applic.html)
- [How to fix issues on Windows with laptops using hybrid graphics (dual GPU)?](https://rozz.genymotion.com/pages/how-to-fix-issues-on-windows-with-laptops-using-hybrid-graph.html)
- [Genymotion Desktop installer doesn't run](https://rozz.genymotion.com/pages/genymotion-desktop-installer-doesn-t-run.html)
- [Drag'n Drop doesn't work with Genymotion Desktop](https://rozz.genymotion.com/pages/drag-n-drop-doesn-t-work-with-genymotion-desktop.html)
- [The virtual device display is black, white or distorted (NVIDIA GPU + Linux)](https://rozz.genymotion.com/pages/the-virtual-device-display-is-black-white-or-distorted-nvidi-2.html)
- [Are older versions of macOS supported?](https://rozz.genymotion.com/pages/are-older-versions-of-macos-supported.html)
- [The device starts, but I can't click anywhere and widgets are greyed out (macOS)](https://rozz.genymotion.com/pages/the-device-starts-but-i-can-t-click-anywhere-and-widgets-are.html)
- [Genymotion Desktop 3.3.2 is out with VirtualBox 7 support for Windows and Linux](https://rozz.genymotion.com/pages/genymotion-desktop-3-3-2-is-out-with-virtualbox-7-support-fo.html)

**Q&As:**
- [What are the system requirements?](https://rozz.genymotion.com/qna/what-are-the-system-requirements.html)
- [What are the company size options for Genymotion?](https://rozz.genymotion.com/qna/what-are-the-company-size-options-for-genymotion.html)
- [How can Genymotion run on a MacBook Air M4?](https://rozz.genymotion.com/qna/how-can-genymotion-run-on-a-macbook-air-m4.html)
- [How can I emulate it on a Chromebook?](https://rozz.genymotion.com/qna/how-can-i-emulate-it-on-a-chromebook.html)
- [How can I use Genymotion with Microsoft Surface (compatibility and installation)?](https://rozz.genymotion.com/qna/how-can-i-use-genymotion-with-microsoft-surface-compatibilit.html)
- [Does Genymotion Desktop work on macOS Catalina, and should I use QEMU or VirtualBox?](https://rozz.genymotion.com/qna/does-genymotion-desktop-work-on-macos-catalina-and-should-i.html)
- [Is Windows 10 still supported for Genymotion Desktop?](https://rozz.genymotion.com/qna/is-windows-10-still-supported-for-genymotion-desktop.html)
- [What alternatives do you recommend for running Genymotion on Windows 10?](https://rozz.genymotion.com/qna/what-alternatives-do-you-recommend-for-running-genymotion-on.html)
- [What hardware specifications are needed to run Genymotion smoothly?](https://rozz.genymotion.com/qna/what-hardware-specifications-are-needed-to-run-genymotion-sm.html)
- [Does the emulator work with the latest Mac OS?](https://rozz.genymotion.com/qna/does-the-emulator-work-with-the-latest-mac-os.html)

### Creating & Configuring Devices

**Pages:**
- [How to use OBS Virtual Camera with Genymotion](https://rozz.genymotion.com/pages/how-to-use-obs-virtual-camera-with-genymotion.html)
- [Linux - Genymotion Desktop crashes when starting a Virtual Device](https://rozz.genymotion.com/pages/linux-genymotion-desktop-crashes-when-starting-a-virtual-dev.html)
- [Is it possible to have several people on my team connected to the same virtua...](https://rozz.genymotion.com/pages/is-it-possible-to-have-several-people-on-my-team-connected-t-2.html)
- [My Webcam does not work with Genymotion PaaS/Device image on iOS.](https://rozz.genymotion.com/pages/my-webcam-does-not-work-with-genymotion-paas-device-image-on.html)
- [I am using Genymotion PaaS/Device Image on Alibaba, in the Chinese zone, and ...](https://rozz.genymotion.com/pages/i-am-using-genymotion-paas-device-image-on-alibaba-in-the-ch.html)
- [macOS - Unable to start the Virtual Device](https://rozz.genymotion.com/pages/macos-unable-to-start-the-virtual-device.html)
- [I get a black display when using a video file in the Media Injection widget (...](https://rozz.genymotion.com/pages/i-get-a-black-display-when-using-a-video-file-in-the-media-i.html)
- [How to transfer a Genymotion Desktop virtual device to another Computer? (Win...](https://rozz.genymotion.com/pages/how-to-transfer-a-genymotion-desktop-virtual-device-to-anoth-2.html)
- [Can I change the camera resolution?](https://rozz.genymotion.com/pages/can-i-change-the-camera-resolution.html)
- [How to automatically connect a Genymotion Desktop virtual device to ADB](https://rozz.genymotion.com/pages/how-to-automatically-connect-a-genymotion-desktop-virtual-de.html)

**Q&As:**
- [What is the maximum number of parallel devices supported by Genymotion?](https://rozz.genymotion.com/qna/what-is-the-maximum-number-of-parallel-devices-supported-by.html)
- [What are snapshots in Genymotion, and how do you use them to create custom images?](https://rozz.genymotion.com/qna/what-are-snapshots-in-genymotion-and-how-do-you-use-them-to.html)
- [Why can’t Genymotion use the camera on my device?](https://rozz.genymotion.com/qna/why-cant-genymotion-use-the-camera-on-my-device.html)
- [Why my genymotion block in the start the virtual device?](https://rozz.genymotion.com/qna/why-my-genymotion-block-in-the-start-the-virtual-device.html)
- [How can I check whether the camera supports USB connection at Genymotion?](https://rozz.genymotion.com/qna/how-can-i-check-whether-the-camera-supports-usb-connection-a.html)
- [How can I create a new virtual device at Genymotion?](https://rozz.genymotion.com/qna/how-can-i-create-a-new-virtual-device-at-genymotion.html)
- [How can I create a new virtual device?](https://rozz.genymotion.com/qna/how-can-i-create-a-new-virtual-device-2.html)
- [How can I change the file path C:\Users\william\AppData\Local\Genymobile\Genymotion\deployed\Goog...?](https://rozz.genymotion.com/qna/how-can-i-change-the-file-path-c-users-william-appdata-local.html)
- [How can i change the keyboard actions into the emulator touch actions?](https://rozz.genymotion.com/qna/how-can-i-change-the-keyboard-actions-into-the-emulator-touc.html)
- [What camera should I choose for an emulated phone on Genymotion?](https://rozz.genymotion.com/qna/what-camera-should-i-choose-for-an-emulated-phone-on-genymot.html)

### Android Dev Integration

**Pages:**
- [Genymotion Desktop 3.2.0 is available!](https://rozz.genymotion.com/pages/genymotion-desktop-3-2-0-is-available.html)
- [Genymotion Desktop 3.4 is released!](https://rozz.genymotion.com/pages/genymotion-desktop-3-4-is-released.html)
- [I can't find my application or game in Google Play Store (Genymotion PaaS/Dev...](https://rozz.genymotion.com/pages/i-can-t-find-my-application-or-game-in-google-play-store-gen-2.html)
- [I keep getting "Android Setup keeps stopping" error](https://rozz.genymotion.com/pages/i-keep-getting-android-setup-keeps-stopping-error.html)
- [How to change Genymotion Desktop installer path in my Android Studio?](https://rozz.genymotion.com/pages/how-to-change-genymotion-desktop-installer-path-in-my-androi.html)
- [How to connect ADB remotely to a Genymotion Desktop local device?](https://rozz.genymotion.com/pages/how-to-connect-adb-remotely-to-a-genymotion-desktop-local-de.html)
- [How to install Xposed,EdXposed or LSPosed in Genymotion?](https://rozz.genymotion.com/pages/how-to-install-xposed-edxposed-or-lsposed-in-genymotion.html)
- [How to enable the virtual keyboard?](https://rozz.genymotion.com/pages/how-to-enable-the-virtual-keyboard.html)
- [How to establish a TCP session to a virtual device?](https://rozz.genymotion.com/pages/how-to-establish-a-tcp-session-to-a-virtual-device.html)
- [Does Google Pay work in Genymotion?](https://rozz.genymotion.com/pages/does-google-pay-work-in-genymotion.html)

**Q&As:**
- [How do I install Google Play Store in Genymotion using Open GApps?](https://rozz.genymotion.com/qna/how-do-i-install-google-play-store-in-genymotion-using-open.html)
- [If I want to use Genymotion to test an app I built, how would that work?](https://rozz.genymotion.com/qna/if-i-want-to-use-genymotion-to-test-an-app-i-built-how-would.html)
- [I am unable to install apps via the Play Store on my desktop.?](https://rozz.genymotion.com/qna/i-am-unable-to-install-apps-via-the-play-store-on-my-desktop.html)
- [Can I download apps from the play store in SaaS?](https://rozz.genymotion.com/qna/can-i-download-apps-from-the-play-store-in-saas.html)
- [Can i run my apk on the emulator ?](https://rozz.genymotion.com/qna/can-i-run-my-apk-on-the-emulator.html)
- [Can Genymotion Desktop run Google Play (Play Store) in a virtual machine?](https://rozz.genymotion.com/qna/can-genymotion-desktop-run-google-play-play-store-in-a-virtu.html)
- [I’ve installed Genymotion but can’t find the Play Store - how do I add it?](https://rozz.genymotion.com/qna/ive-installed-genymotion-but-cant-find-the-play-store-how-do.html)
- [I downloaded the desktop version, how can I put Android apps on it if there's no Play Store?](https://rozz.genymotion.com/qna/i-downloaded-the-desktop-version-how-can-i-put-android-apps.html)
- [Can I download apps from the google play store to test?](https://rozz.genymotion.com/qna/can-i-download-apps-from-the-google-play-store-to-test.html)
- [What's the difference between the scrcpy.exe I'm using now, and Genymotion Desktop?](https://rozz.genymotion.com/qna/what-s-the-difference-between-the-scrcpy-exe-i-m-using-now-a.html)

### Cloud Marketplace & Pricing

**Pages:**
- [GMTool returns the error code 14](https://rozz.genymotion.com/pages/gmtool-returns-the-error-code-14.html)
- [I have cancelled my cloud provider subscription. Can I get a refund for Genym...](https://rozz.genymotion.com/pages/i-have-cancelled-my-cloud-provider-subscription-can-i-get-a-2.html)
- [I forgot to stop my Genymotion PaaS instance. Can I get a refund?](https://rozz.genymotion.com/pages/i-forgot-to-stop-my-genymotion-paas-instance-can-i-get-a-ref.html)
- [How will I be charged for Genymotion on Alibaba?](https://rozz.genymotion.com/pages/how-will-i-be-charged-for-genymotion-on-alibaba.html)
- [Is there a trial for Genymotion Desktop Pro edition?](https://rozz.genymotion.com/pages/is-there-a-trial-for-genymotion-desktop-pro-edition.html)
- [How do I get the free trial for Genymotion Cloud (SaaS)?](https://rozz.genymotion.com/pages/how-do-i-get-the-free-trial-for-genymotion-cloud-saas.html)
- [Genymotion Desktop Plans](https://rozz.genymotion.com/pages/genymotion-desktop-plans.html)
- [— EULA —](https://rozz.genymotion.com/pages/eula.html)
- [Genymotion Offers Survey](https://rozz.genymotion.com/pages/genymotion-offers-survey.html)
- [Alibaba](https://rozz.genymotion.com/pages/alibaba.html)

**Q&As:**
- [What are the costs for using Genymotion SaaS?](https://rozz.genymotion.com/qna/what-are-the-costs-for-using-genymotion-saas.html)
- [What is available in the free version and how it differs from the paid version, and what limitati...?](https://rozz.genymotion.com/qna/what-is-available-in-the-free-version-and-how-it-differs-fro.html)
- [What are the pricing and revenue plans at Genymotion?](https://rozz.genymotion.com/qna/what-are-the-pricing-and-revenue-plans-at-genymotion-2.html)
- [What is the cost of using Genymotion SaaS after the trial phase?](https://rozz.genymotion.com/qna/what-is-the-cost-of-using-genymotion-saas-after-the-trial-ph.html)
- [What is the difference between packages on Genymotion?](https://rozz.genymotion.com/qna/what-is-the-difference-between-packages-on-genymotion.html)
- [What are the differences in usage between the free version and paid version of Genymotion?](https://rozz.genymotion.com/qna/what-are-the-differences-in-usage-between-the-free-version-a.html)
- [What are the prices of the SaaS version?](https://rozz.genymotion.com/qna/what-are-the-prices-of-the-saas-version.html)
- [What is the difference between educational and individual versions?](https://rozz.genymotion.com/qna/what-is-the-difference-between-educational-and-individual-ve.html)
- [What are the pricing limits for running multiple VMs at once?](https://rozz.genymotion.com/qna/what-are-the-pricing-limits-for-running-multiple-vms-at-once.html)
- [What are Genymotion pricing and revenue plans?](https://rozz.genymotion.com/qna/what-are-genymotion-pricing-and-revenue-plans.html)

### CLI & Shell Tooling

**Pages:**
- [How to get Genymotion Desktop logs?](https://rozz.genymotion.com/pages/how-to-get-genymotion-desktop-logs-2.html)
- [The virtual device display does not rotate](https://rozz.genymotion.com/pages/the-virtual-device-display-does-not-rotate.html)
- [How to screen record with Genymotion SaaS (Cloud)?](https://rozz.genymotion.com/pages/how-to-screen-record-with-genymotion-saas-cloud.html)
- [How to change product properties (manufacturer, model, etc.) with Genymotion ...](https://rozz.genymotion.com/pages/how-to-change-product-properties-manufacturer-model-etc-with.html)
- [How to run automated tests with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-run-automated-tests-with-genymotion-desktop.html)
- [How to enable kiosk mode with Genymotion SaaS (Cloud)?](https://rozz.genymotion.com/pages/how-to-enable-kiosk-mode-with-genymotion-saas-cloud.html)
- [Make a minimalist Ubuntu + gmsaas Docker image](https://rozz.genymotion.com/pages/make-a-minimalist-ubuntu-gmsaas-docker-image.html)
- [Genymotion Desktop 3.10.0](https://rozz.genymotion.com/pages/genymotion-desktop-3-10-0.html)
- [Issues](https://rozz.genymotion.com/pages/issues.html)
- [GMTool](https://rozz.genymotion.com/pages/gmtool.html)

**Q&As:**
- [What is the difference between Genymotion and Genymotion Shell, and why did I need to download a ...?](https://rozz.genymotion.com/qna/what-is-the-difference-between-genymotion-and-genymotion-she.html)
- [What should I do with a .shell file in Genymotion?](https://rozz.genymotion.com/qna/what-should-i-do-with-a-shell-file-in-genymotion.html)
- [On a Mac, do I drag into Genymotion or Genymotion Shell.?](https://rozz.genymotion.com/qna/on-a-mac-do-i-drag-into-genymotion-or-genymotion-shell.html)

### Apps, Games & Performance

**Pages:**
- [Genymotion 2.11.0 (October 25th, 2017)](https://rozz.genymotion.com/pages/genymotion-2-11-0-october-25th-2017.html)
- [The battery level chart visible in the system settings does not reflect the c...](https://rozz.genymotion.com/pages/the-battery-level-chart-visible-in-the-system-settings-does.html)
- [Does Genymotion emulates Bluetooth?](https://rozz.genymotion.com/pages/does-genymotion-emulates-bluetooth.html)
- [Do Social Media apps work with Genymotion?](https://rozz.genymotion.com/pages/do-social-media-apps-work-with-genymotion.html)
- [The map is blank on the GPS widget](https://rozz.genymotion.com/pages/the-map-is-blank-on-the-gps-widget.html)
- [Can I send or receive calls and text messages from a real phone or tablet?](https://rozz.genymotion.com/pages/can-i-send-or-receive-calls-and-text-messages-from-a-real-ph.html)
- [Capture](https://rozz.genymotion.com/pages/capture.html)
- [AppsFlyer Case Study](https://rozz.genymotion.com/pages/appsflyer-case-study.html)

**Q&As:**
- [I’m having trouble with the emulator not showing Google Play. What should I do?](https://rozz.genymotion.com/qna/im-having-trouble-with-the-emulator-not-showing-google-play.html)
- [Can Genymotion Android emulator also play games?](https://rozz.genymotion.com/qna/can-genymotion-android-emulator-also-play-games.html)
- [Is Genymotion good for gaming?](https://rozz.genymotion.com/qna/is-genymotion-good-for-gaming.html)
- [Can Genymotion install games?](https://rozz.genymotion.com/qna/can-genymotion-install-games.html)
- [What Android features can I use in Genymotion (images, root, or Android Automotive)?](https://rozz.genymotion.com/qna/what-android-features-can-i-use-in-genymotion-images-root-or.html)
- [Can Genymotion be used to play games?](https://rozz.genymotion.com/qna/can-genymotion-be-used-to-play-games.html)
- [Can Genymotion run an apk i want?](https://rozz.genymotion.com/qna/can-genymotion-run-an-apk-i-want.html)
- [I want to test a specific app-how do I set it up during the free trial?](https://rozz.genymotion.com/qna/i-want-to-test-a-specific-app-how-do-i-set-it-up-during-the.html)
- [Can I play BGMI on Genymotion?](https://rozz.genymotion.com/qna/can-i-play-bgmi-on-genymotion.html)
- [Does Genymotion require an Android device for this?](https://rozz.genymotion.com/qna/does-genymotion-require-an-android-device-for-this.html)

### Licensing & Activation

**Pages:**
- [How to purchase a Genymotion Desktop license?](https://rozz.genymotion.com/pages/how-to-purchase-a-genymotion-desktop-license.html)
- [PayPal license purchase - order received but no license key](https://rozz.genymotion.com/pages/paypal-license-purchase-order-received-but-no-license-key.html)
- [I have a European VAT number and I can't seem to use it (License purchase)](https://rozz.genymotion.com/pages/i-have-a-european-vat-number-and-i-can-t-seem-to-use-it-lice.html)
- [How to get Genymotion Desktop free for personal use edition](https://rozz.genymotion.com/pages/how-to-get-genymotion-desktop-free-for-personal-use-edition.html)
- [I get the error "Server Error (500)" when I try to purchase a license](https://rozz.genymotion.com/pages/i-get-the-error-server-error-500-when-i-try-to-purchase-a-li.html)
- [Do I need a license if I use Genymotion Desktop for studying?](https://rozz.genymotion.com/pages/do-i-need-a-license-if-i-use-genymotion-desktop-for-studying.html)
- [I want to test Genymotion Desktop Pro, with full features, but I have already...](https://rozz.genymotion.com/pages/i-want-to-test-genymotion-desktop-pro-with-full-features-but.html)
- [Is it possible to use a single license on mutiple computers?](https://rozz.genymotion.com/pages/is-it-possible-to-use-a-single-license-on-mutiple-computers.html)
- [Genymotion PaaS/Device Image – EULA](https://rozz.genymotion.com/pages/genymotion-paas-device-image-eula.html)
- [I can't create an account: "Something went wrong, please try again."](https://rozz.genymotion.com/pages/i-can-t-create-an-account-something-went-wrong-please-try-ag.html)

**Q&As:**
- [Which plan on Genymotion offers rootless Android devices?](https://rozz.genymotion.com/qna/which-plan-on-genymotion-offers-rootless-android-devices.html)
- [Which andriod version has the free version?](https://rozz.genymotion.com/qna/which-andriod-version-has-the-free-version.html)
- [Does Genymotion Desktop Pro offer a 30-day free trial?](https://rozz.genymotion.com/qna/does-genymotion-desktop-pro-offer-a-30-day-free-trial.html)
- [Does Genymotion offer a free version?](https://rozz.genymotion.com/qna/does-genymotion-offer-a-free-version.html)
- [How do I activate the free version of Genymotion Desktop?](https://rozz.genymotion.com/qna/how-do-i-activate-the-free-version-of-genymotion-desktop.html)
- [Can I run lot of devices in free version ?](https://rozz.genymotion.com/qna/can-i-run-lot-of-devices-in-free-version.html)
- [Is Genymotion free, and how does it compare to the 30-day Pro trial?](https://rozz.genymotion.com/qna/is-genymotion-free-and-how-does-it-compare-to-the-30-day-pro.html)
- [Can i pay monthly or daily license. i am still trying it out on desktop?](https://rozz.genymotion.com/qna/can-i-pay-monthly-or-daily-license-i-am-still-trying-it-out.html)
- [Is there a free personal account available at Genymotion?](https://rozz.genymotion.com/qna/is-there-a-free-personal-account-available-at-genymotion.html)
- [Is Genymotion Cloud a paid service, and what are the pricing options?](https://rozz.genymotion.com/qna/is-genymotion-cloud-a-paid-service-and-what-are-the-pricing.html)

### GPU & ARM Support

**Pages:**
- [I have a mac and I can't find Android 5.0 to 10.0 in Genymotion Desktop](https://rozz.genymotion.com/pages/i-have-a-mac-and-i-can-t-find-android-5-0-to-10-0-in-genymot.html)
- [Can I use Genymotion Desktop remotely?](https://rozz.genymotion.com/pages/can-i-use-genymotion-desktop-remotely.html)
- [I can't set more than 2048MB of RAM to the device (mac M series)](https://rozz.genymotion.com/pages/i-can-t-set-more-than-2048mb-of-ram-to-the-device-mac-m-seri.html)
- [Genymotion Desktop Pro for Independent Workers](https://rozz.genymotion.com/pages/genymotion-desktop-pro-for-independent-workers.html)
- [Genymotion in the Cloud](https://rozz.genymotion.com/pages/genymotion-in-the-cloud.html)
- [The Virtual device display is black in Genymotion Desktop](https://rozz.genymotion.com/pages/the-virtual-device-display-is-black-in-genymotion-desktop.html)
- [Unable to load OpenGL libraries from your system](https://rozz.genymotion.com/pages/unable-to-load-opengl-libraries-from-your-system.html)
- [Is Genymotion Desktop available for 32-bit?](https://rozz.genymotion.com/pages/is-genymotion-desktop-available-for-32-bit.html)

**Q&As:**
- [What is the full guide to using ARM-based virtual Android with Genymotion?](https://rozz.genymotion.com/qna/what-is-the-full-guide-to-using-arm-based-virtual-android-wi.html)
- [What is the architecture of the cloud devices?](https://rozz.genymotion.com/qna/what-is-the-architecture-of-the-cloud-devices.html)
- [How to get arm version of android ?](https://rozz.genymotion.com/qna/how-to-get-arm-version-of-android.html)
- [How can I try an ARM translation tool on my desktop, step by step, at Genymotion?](https://rozz.genymotion.com/qna/how-can-i-try-an-arm-translation-tool-on-my-desktop-step-by.html)
- [How can I create and configure an ARM64 device for use with Genymotion in the cloud (SaaS)?](https://rozz.genymotion.com/qna/how-can-i-create-and-configure-an-arm64-device-for-use-with.html)
- [What should I do if the app still shows 'device not compatible' after I’ve switched to an arm64 i...?](https://rozz.genymotion.com/qna/what-should-i-do-if-the-app-still-shows-device-not-compatibl.html)
- [When will Genymotion SaaS stop supporting x86 virtual devices?](https://rozz.genymotion.com/qna/when-will-genymotion-saas-stop-supporting-x86-virtual-device.html)
- [I'm interested in using Genymotion SaaS for ARM64. Can you walk me through setting that up?](https://rozz.genymotion.com/qna/i-m-interested-in-using-genymotion-saas-for-arm64-can-you-wa.html)
- [Does Genymotion Desktop still support ARM translation, or only ARM64 in the cloud?](https://rozz.genymotion.com/qna/does-genymotion-desktop-still-support-arm-translation-or-onl.html)
- [Were you not planning to move on arm64 for all plans?](https://rozz.genymotion.com/qna/were-you-not-planning-to-move-on-arm64-for-all-plans.html)

### Account & API Access

**Pages:**
- [I can't log in to Genymotion Desktop: "Too many failed attempts, please try a...](https://rozz.genymotion.com/pages/i-can-t-log-in-to-genymotion-desktop-too-many-failed-attempt.html)
- [How to delete my Genymotion SaaS (Cloud) account and all related data?](https://rozz.genymotion.com/pages/how-to-delete-my-genymotion-saas-cloud-account-and-all-relat.html)
- [How to change the account billing contact?](https://rozz.genymotion.com/pages/how-to-change-the-account-billing-contact.html)
- [Install a certificate](https://rozz.genymotion.com/pages/install-a-certificate.html)
- [Genymotion Self-hosted](https://rozz.genymotion.com/pages/genymotion-self-hosted.html)
- [I have forgotten my Genymotion SaaS (Cloud) account password](https://rozz.genymotion.com/pages/i-have-forgotten-my-genymotion-saas-cloud-account-password.html)
- [Where are Genymotion documentation and user guides?](https://rozz.genymotion.com/pages/where-are-genymotion-documentation-and-user-guides.html)
- [I have forgotten my Genymotion Desktop account username](https://rozz.genymotion.com/pages/i-have-forgotten-my-genymotion-desktop-account-username.html)
- [How to delete my Genymotion Desktop account?](https://rozz.genymotion.com/pages/how-to-delete-my-genymotion-desktop-account-2.html)
- [I get the error "Too many requests, try again later." when I try to create an...](https://rozz.genymotion.com/pages/i-get-the-error-too-many-requests-try-again-later-when-i-try.html)

**Q&As:**
- [Why does Genymotion install successfully but fail to connect?](https://rozz.genymotion.com/qna/why-does-genymotion-install-successfully-but-fail-to-connect.html)
- [How can I register for an X account at Genymotion?](https://rozz.genymotion.com/qna/how-can-i-register-for-an-x-account-at-genymotion.html)
- [I need help creating the API token in the portal, could you walk me through it?](https://rozz.genymotion.com/qna/i-need-help-creating-the-api-token-in-the-portal-could-you-w.html)
- [Does the free version require an account?](https://rozz.genymotion.com/qna/does-the-free-version-require-an-account.html)

### Android Version Selection

**Pages:**
- [The device display is distorted or blank, and Genymotion freezes when I use A...](https://rozz.genymotion.com/pages/the-device-display-is-distorted-or-blank-and-genymotion-free.html)
- [Dynamically change vehicle properties in Android Automotive](https://rozz.genymotion.com/pages/dynamically-change-vehicle-properties-in-android-automotive.html)
- [Genymotion: 2025 Year in Review](https://rozz.genymotion.com/pages/genymotion-2025-year-in-review.html)
- [News & Updates](https://rozz.genymotion.com/pages/news-updates.html)
- [Genymotion Desktop Release Notes](https://rozz.genymotion.com/pages/genymotion-desktop-release-notes-2.html)
- [I can't find the device I need in the virtual device list.](https://rozz.genymotion.com/pages/i-can-t-find-the-device-i-need-in-the-virtual-device-list.html)
- [I can't find any device templates with Genymotion PaaS.](https://rozz.genymotion.com/pages/i-can-t-find-any-device-templates-with-genymotion-paas.html)
- [Android 16.0 (beta) for Desktop](https://rozz.genymotion.com/pages/android-16-0-beta-for-desktop.html)
- [Genymotion Device image (PaaS)](https://rozz.genymotion.com/pages/genymotion-device-image-paas.html)
- [New Genymotion Device Image v13.0](https://rozz.genymotion.com/pages/new-genymotion-device-image-v13-0.html)

**Q&As:**
- [How to select an ARM-based AVD in Genymotion?](https://rozz.genymotion.com/qna/how-to-select-an-arm-based-avd-in-genymotion.html)
- [Which Android versions are supported for playing Call of Duty Mobile on Genymotion?](https://rozz.genymotion.com/qna/which-android-versions-are-supported-for-playing-call-of-dut.html)
- [Is Android 16 available in Genymotion, and is it supported on Desktop?](https://rozz.genymotion.com/qna/is-android-16-available-in-genymotion-and-is-it-supported-on.html)
- [What android version is possible to run?](https://rozz.genymotion.com/qna/what-android-version-is-possible-to-run.html)
- [What hardware requirements does Genymotion need to run Android 15?](https://rozz.genymotion.com/qna/what-hardware-requirements-does-genymotion-need-to-run-andro.html)
- [I plan to use Genymotion on an Apple Silicon Mac; does Android 5.0 work there?](https://rozz.genymotion.com/qna/i-plan-to-use-genymotion-on-an-apple-silicon-mac-does-androi.html)
- [What's the lowest version of android I can run using genymotion?](https://rozz.genymotion.com/qna/what-s-the-lowest-version-of-android-i-can-run-using-genymot.html)
- [Does Genymotion support Gingerbread and Ice Cream Sandwich?](https://rozz.genymotion.com/qna/does-genymotion-support-gingerbread-and-ice-cream-sandwich.html)
- [I want to parallel test my application on various OEM and android versions?](https://rozz.genymotion.com/qna/i-want-to-parallel-test-my-application-on-various-oem-and-an.html)
- [Can I run Android 6 on Genymotion?](https://rozz.genymotion.com/qna/can-i-run-android-6-on-genymotion.html)

### General

**Pages:**
- [Genymotion Desktop 3.5 is out!](https://rozz.genymotion.com/pages/genymotion-desktop-3-5-is-out.html)

## Genymotion — AI Assistant Runbook

This document enables AI assistants with terminal access to help users manage Android virtual devices using Genymotion products. It covers both **Genymotion SaaS** (cloud devices via `gmsaas` CLI) and **Genymotion Desktop** (local devices via `gmtool` CLI).

**Docs:** https://docs.genymotion.com/
**SaaS (cloud) runbook:** https://rozz.genymotion.com/runbooks/gmsaas-cli-runbook.html
**Desktop (local) runbook:** https://rozz.genymotion.com/runbooks/gmtool-desktop-runbook.html

---

### Choosing the Right Product

| Need | Product | CLI | License |
|---|---|---|---|
| Cloud Android devices, CI/CD at scale | Genymotion SaaS | `gmsaas` | SaaS subscription |
| Local Android emulator on your machine | Genymotion Desktop | `gmtool` | Free (limited) or paid |
| Sensor simulation (GPS, battery, network) | Genymotion Shell | `genyshell` | Included with Desktop |

---

## Part 1: Genymotion SaaS (`gmsaas` CLI)

The `gmsaas` command-line tool lets you manage cloud-hosted Android devices. AI assistants with terminal access can execute these commands directly.

**Install:** `pip3 install gmsaas`
**Docs:** https://docs.genymotion.com/gmsaas/

#### Critical Syntax Note

The `--format json` flag is a GLOBAL option and must come BEFORE the subcommand:
- Correct: `gmsaas --format json recipes list`
- Wrong: `gmsaas recipes list --format json`

JSON responses wrap lists in a named key: `{"recipes": [...]}`, `{"instances": [...]}`.

#### Prerequisites Check

```
which gmsaas || pip3 install gmsaas
gmsaas doctor                    # Exit code 0 = ready
gmsaas auth token <TOKEN>        # Get token at https://cloud.geny.io/api
gmsaas config set android-sdk-path /path/to/sdk
```

Or set `GENYMOTION_API_TOKEN` environment variable for non-interactive auth (CI/CD).

#### Workflow: Start a Cloud Android Device

Step 1 — List available recipes:
```
gmsaas --format json recipes list
```
Response: `{"recipes": [{"uuid": "...", "name": "Google Pixel 9", "android_version": "14.0", ...}, ...]}`
Filter by `android_version` or `name` to help user pick.

Step 2 — Start instance:
```
gmsaas --format json instances start <recipe_uuid> "device-name"
```
Options: `--no-wait` (return immediately), `--max-run-duration 60` (auto-stop after N minutes).
Response: `{"uuid": "<instance_uuid>", "state": "CREATING", ...}` — waits until ONLINE by default.

Step 3 — Connect ADB:
```
gmsaas --format json instances adbconnect <instance_uuid>
```
Response: `{"adb_serial": "localhost:PORT"}` — use this for all `adb -s localhost:PORT` commands.

Step 4 — Use the device:
```
adb -s localhost:PORT install app.apk
adb -s localhost:PORT shell
adb -s localhost:PORT exec-out screencap -p > screenshot.png
```

Step 5 — Stop instance:
```
gmsaas instances stop <instance_uuid>
```
**CRITICAL:** Instances cost credits until explicitly stopped. Always stop when done.

#### CI/CD Quick Start

```bash
pip3 install gmsaas
export GENYMOTION_API_TOKEN="$GENYMOTION_API_TOKEN"
gmsaas config set android-sdk-path "$ANDROID_HOME"
INSTANCE=$(gmsaas --format json instances start "<recipe_uuid>" "ci-test" --max-run-duration 30 | python3 -c "import sys,json; print(json.load(sys.stdin)['uuid'])")
ADB=$(gmsaas --format json instances adbconnect "$INSTANCE" | python3 -c "import sys,json; print(json.load(sys.stdin)['adb_serial'])")
adb -s "$ADB" wait-for-device
# Run tests here
trap "gmsaas instances stop $INSTANCE --no-wait" EXIT
```

#### SaaS Complete Command Reference

Authentication:
- `gmsaas auth token <token>` — Authenticate with API token
- `gmsaas auth reset` — Clear credentials
- `gmsaas doctor` — Verify configuration (exit code 0 = OK)
- `gmsaas config set android-sdk-path <path>` — Set Android SDK
- `gmsaas config set output-format json` — Default JSON output

Recipes (device configurations):
- `gmsaas --format json recipes list [--name TEXT] [--source official|custom|all]`
- `gmsaas --format json recipes get <uuid>`
- `gmsaas --format json recipes create <hwprofile_uuid> <osimage_uuid> <name>`
- `gmsaas recipes delete <uuid> [--delete-osimage] [--delete-hwprofile]`

Instances (virtual devices):
- `gmsaas --format json instances start <recipe_uuid> <name> [--no-wait] [--max-run-duration N]`
- `gmsaas --format json instances list [--quiet]`
- `gmsaas --format json instances get <uuid>`
- `gmsaas --format json instances adbconnect <uuid> [--adb-serial-port PORT]`
- `gmsaas instances stop <uuid> [--no-wait]`
- `gmsaas instances save <uuid>`
- `gmsaas instances saveas <uuid> --osimage-name <name> --recipe-name <name>`

Hardware profiles:
- `gmsaas --format json hwprofiles list`
- `gmsaas --format json hwprofiles create <name> [--width N] [--height N] [--density N] [--form-factor PHONE|TABLET]`
- `gmsaas hwprofiles delete <uuid>`

OS images:
- `gmsaas --format json osimages list`
- `gmsaas --format json osimages clone <uuid> <name>`
- `gmsaas osimages delete <uuid>`

ADB:
- `gmsaas adb start` / `gmsaas adb stop`

#### SaaS Error Handling

- `TOO_MANY_RUNNING_VDS` (403) — Plan instance limit. Stop instances: `gmsaas instances list --quiet | xargs -I {} gmsaas instances stop {}`
- `gmsaas doctor` fails — Run `gmsaas auth token <token>` and `gmsaas config set android-sdk-path <path>`
- `externally-managed-environment` — Use `pip3 install --user gmsaas` or a virtual environment
- Instance stuck CREATING — Stop and retry, or check cloud capacity
- ADB refused — Wait for state=ONLINE: `gmsaas --format json instances get <uuid>`

---

## Part 2: Genymotion Desktop (`gmtool` CLI)

`gmtool` manages local Android virtual devices running on your machine via VirtualBox or QEMU.

#### Critical: gmtool Is NOT on PATH

`gmtool` is not added to the system PATH. You must use the full path or create an alias.

Platform paths:
- **macOS:** `/Applications/Genymotion.app/Contents/MacOS/gmtool`
- **Windows:** `C:\Program Files\Genymobile\Genymotion\gmtool.exe`
- **Linux:** `$HOME/genymotion/gmtool` or `/opt/genymotion/gmtool`

Discover gmtool automatically:
```bash
# macOS/Linux — find gmtool and set alias
GM=$(find /Applications /opt $HOME/genymotion -name gmtool -type f 2>/dev/null | head -1)
if [ -z "$GM" ]; then echo "gmtool not found — install Genymotion Desktop from https://www.genymotion.com/download/"; exit 1; fi
$GM version
```

All examples below use `gmtool` as shorthand — substitute the full path.

#### Critical: JSON Output Is Inconsistent

Like `gmsaas`, `gmtool` supports `--format json` as a GLOBAL option BEFORE the subcommand:
- Correct: `gmtool --format json admin list`
- Wrong: `gmtool admin list --format json`

However, **JSON output only works on `admin list`**. All other commands return plain text regardless:
- **JSON works:** `admin list` only
- **No output on success:** `admin start`, `admin stop`, `admin clone`, `adbconnect` (check exit code 0)
- **Plain text only:** `admin details`, `admin create`, `admin delete`, `admin hwprofiles`, `admin osimages`, `license info`, `version`, `config list`
- **Errors are always plain text**, even with `--format json`
- **`admin create`** outputs download progress text (`Downloading OsImage... 32MB / 800MB...`)
- **`admin delete`** returns: `"Virtual device deleted successfully: <name>"`
- **`device push`** returns: `"Pushing <file> to <device>... File pushed to <device>"`

#### JSON Response Shape

`gmtool --format json admin list` returns:
```json
{
    "exit_code": 0,
    "exit_code_desc": "SUCCESS",
    "instances": [
        {
            "adb_serial": "127.0.0.1:6554",
            "adb_serial_port": 6554,
            "name": "Google Nexus 4",
            "recipe": {
                "osimage": {
                    "android_version": "15.0.0",
                    "api_version": "35",
                    "architecture": "arm64",
                    "image_version": "3.4.0",
                    "is_beta": false,
                    "name": "Android 15.0"
                }
            },
            "state": "off",
            "uuid": "b54fe1d2-0e30-42e6-b62b-94b3596088b9"
        }
    ]
}
```

Use `exit_code` to check success (0 = success). Device `state` values: `"off"`, `"on"`.
Devices are addressable by both `name` and `uuid`.
Note: `adb_serial_port` is `6554` when off but changes to `6555` when running. Always read `adb_serial` from `admin list` after starting.

#### License Tiers — What's Free vs Paid

Most useful commands require a paid license (Indie/Business). An agent hitting "A license is required to use this feature" means the user needs to upgrade.

**Free tier (Personal Use):** `admin list`, `admin start`, `admin stop`, `version`
**Paid license required:** `admin create`, `admin edit`, `admin details`, `admin clone`, `admin delete`, `admin stopall`, `admin factoryreset`, `admin hwprofiles`, `admin osimages`, `device install/push/pull/flash/adbconnect/adbdisconnect`

#### Prerequisites Check

```bash
# 1. Find gmtool
GM=/Applications/Genymotion.app/Contents/MacOS/gmtool  # macOS
$GM version    # Expect: "Version : X.Y.Z"

# 2. Check license
$GM license info    # "Personal use" = free tier, limited commands

# 3. Check hypervisor
$GM config list    # Look for hypervisor=qemu or hypervisor=virtualbox

# 4. List existing devices
$GM --format json admin list | python3 -c "import sys,json; d=json.load(sys.stdin); print(f'{len(d[\"instances\"])} devices found')"
```

#### Installation by Platform

**macOS** (Sequoia 15 / Sonoma 14):
- Apple Silicon: Rosetta must be activated
- Default hypervisor: QEMU (recommended, no extra software needed)
- Install: Open DMG, drag Genymotion to `/Applications/`

**Windows** (10/11 64-bit, x86_64 only):
- Default hypervisor: VirtualBox (included in installer)
- **Hyper-V must be completely disabled** when using VirtualBox
- QEMU available experimentally (Pro/Enterprise, requires Hyper-V)
- Install: Run `genymotion-X.Y.Z-vbox.exe`

**Linux** (Ubuntu 24.04, Debian 13, Fedora 43, x86_64 only):
- Default hypervisor: QEMU/KVM (embedded)
- Install:
```bash
chmod +x genymotion-X.Y.Z-linux_x64.run
./genymotion-X.Y.Z-linux_x64.run -d $HOME/genymotion
```

#### Workflow: Create and Start a Local Device

Step 1 — List available hardware profiles and OS images (paid license required):
```bash
gmtool admin hwprofiles    # Plain text table, no JSON support
gmtool admin osimages      # Plain text table, no JSON support
```

`hwprofiles` output format (fixed-width columns):
```
UUID                                  NAME                     DISPLAY              SOURCE
------------------------------------  -----------------------  -------------------  ------
b56ca2cf-2c9d-42a7-9040-53b9c0546928  Google Pixel 9           1080 x 2424 dpi 422  VENDOR
90f8c57b-113e-46b7-aaba-322d3329b016  Samsung Galaxy S24       1080 x 2340 dpi 418  VENDOR
e104f058-b291-4764-8e0d-d9ff78a41192  Custom Phone             768 x 1280 dpi 320   VENDOR
```

`osimages` output format:
```
UUID                                  NAME          ANDROID VERSION  API VERSION  BETA  ARCHITECTURE  SOURCE
------------------------------------  ------------  ---------------  -----------  ----  ------------  ----------
160ea4fa-d62c-4207-b540-7100541f6dc6  Android 14.0  14.0.0           34           No    arm64         Genymotion
a27c4113-a385-4013-856f-c5bde3dcb69c  Android 15.0  15.0.0           35           No    arm64         Genymotion
```

Use the **NAME** column (not UUID) when creating devices. If you get "A license is required", the user must create devices via the Genymotion Desktop GUI instead.

Step 2 — Create a device (paid, downloads OS image on first use ~800MB):
```bash
gmtool admin create "Google Pixel 9" "Android 14.0" "my-device"
```
The first argument is the hwprofile NAME, the second is the osimage NAME, the third is your device name.
This outputs download progress (plain text, not JSON). It can take several minutes.
Options: `--density 480`, `--width 1080`, `--height 2400`, `--nbcpu 4`, `--ram 4096`, `--navbar on`, `--root-access on`, `--quickboot on` (QEMU only)

Step 3 — Start the device (free):
```bash
gmtool --format json admin start "my-device"
```
Use `--coldboot` to force a full boot cycle (useful for troubleshooting stuck boots).
If exit code 3: "The virtual device stopped unexpectedly while starting up" — try `--coldboot`, or run with `-v` for details (look for `Player exited early with error code`). See FAQ: www.genymotion.com/faq/vd-not-started

Step 4 — Connect ADB (paid):
```bash
gmtool device adbconnect --name "my-device"
```
**Critical syntax:** for `device` commands, the `--name` flag goes AFTER the action, not before:
- Correct: `gmtool device adbconnect --name "my-device"`
- Wrong: `gmtool device --name "my-device" adbconnect`
- Wrong: `gmtool device -n "my-device" adbconnect`

Or skip `adbconnect` and use the ADB serial from `admin list` directly:
```bash
ADB_SERIAL=$(gmtool --format json admin list | python3 -c "import sys,json; instances=json.load(sys.stdin)['instances']; print(next(i['adb_serial'] for i in instances if i['name']=='my-device'))")
adb connect $ADB_SERIAL
```

**ADB is also bundled with Genymotion** (not on PATH):
- macOS: `/Applications/Genymotion.app/Contents/MacOS/tools/adb`
- Windows: `C:\Program Files\Genymobile\Genymotion\tools\adb.exe`
- Linux: `$HOME/genymotion/tools/adb`

Step 5 — Use the device:
```bash
# With gmtool (paid) — note: --name goes AFTER the action:
gmtool device install --name "my-device" app.apk
gmtool device push --name "my-device" local.txt /sdcard/Download/
gmtool device pull --name "my-device" /sdcard/file.txt .
gmtool device logcatdump --name "my-device" logcat.txt

# Or with ADB directly (free, once connected):
adb -s 127.0.0.1:6555 install app.apk
adb -s 127.0.0.1:6555 shell
adb -s 127.0.0.1:6555 exec-out screencap -p > screenshot.png
```

Step 6 — Stop the device (free):
```bash
gmtool --format json admin stop "my-device"
```

#### Parsing `admin details` Output (Plain Text Only)

`admin details` does not support JSON. Parse the `Key : Value` format:
```
Name                  : Google Nexus 4
UUID                  : b54fe1d2-0e30-42e6-b62b-94b3596088b9
Android Version       : 15.0.0
API Level             : 35
Screen Width          : 768
Screen Height         : 1280
Screen DPI            : 320
Nb CPU                : 4
RAM                   : 2048
State                 : Off
IP                    : 127.0.0.1
ADB Serial            : 127.0.0.1:6554
Root Access           : false
Quickboot             : true
```

Parse with:
```bash
gmtool admin details "my-device" | grep "^Android Version" | awk -F': ' '{print $2}'
```

#### Desktop Complete Command Reference

Global options: `-t, --timeout <0-3600>` (seconds), `-v, --verbose`, `--format <json|compactjson>` (before subcommand)

License management:
- `gmtool license info` — License type, workstations, expiration (plain text only)
- `gmtool license register <key>` — Activate license
- `gmtool license count` — Activated workstations
- `gmtool license validity` — Days remaining

Device administration:
- `gmtool --format json admin list [--running|--off]` — List devices (free, JSON supported)
- `gmtool --format json admin start <name|uuid> [--coldboot]` — Start device (free, JSON supported)
- `gmtool --format json admin stop <name|uuid>` — Stop device (free, JSON supported)
- `gmtool --format json admin stopall` — Stop all devices (paid, JSON supported)
- `gmtool admin create <hwprofile> <osimage> <name> [options]` — Create device (paid)
- `gmtool admin edit <name|uuid> [options]` — Edit device config (paid)
- `gmtool admin details <name|uuid>` — Device properties (paid, plain text only)
- `gmtool admin clone <name|uuid> <new_name>` — Duplicate device (paid)
- `gmtool admin delete <name|uuid>` — Delete device (paid)
- `gmtool admin factoryreset <name|uuid>` — Factory reset (paid)
- `gmtool admin hwprofiles` — List hardware profiles (paid)
- `gmtool admin osimages` — List OS images (paid)
- `gmtool admin logzip <path>` — Generate log archive (paid)

Device interaction (paid — `--name` flag goes AFTER the action):
- `gmtool device adbconnect --name <device>` — Connect device to ADB (no output on success)
- `gmtool device adbdisconnect --name <device>` — Disconnect from ADB
- `gmtool device install --name <device> <apk>` — Install APK
- `gmtool device push --name <device> <src> <dst>` — Send file to device (default: /sdcard/Download/)
- `gmtool device pull --name <device> <src> <dst>` — Copy file from device
- `gmtool device flash --name <device> <archive.zip>` — Flash zip archive
- `gmtool device logcatdump --name <device> <file>` — Dump logcat
- `gmtool device logcatclear --name <device>` — Clear logcat
- Use `--all` instead of `--name` to target all running devices

Configuration (use `config set <key> <value>` syntax, old `--flag` style is deprecated):
- `gmtool config set hypervisor <virtualbox|qemu>` — Switch hypervisor
- `gmtool config set use_custom_sdk on` / `gmtool config set sdk_path <path>` — Custom Android SDK
- `gmtool config set virtual_device_path <path>` — Device storage location
- `gmtool config list` — Show all config as KEY=VALUE (plain text only)
- `gmtool config get <key>` — Get single config value
- `gmtool config reset` — Restore defaults
- `gmtool config signout` — Sign out and remove license

Device creation options (used with `admin create` or `admin edit`):
- `--density <120-640>` — Screen density (dpi)
- `--width <value>` / `--height <value>` — Screen dimensions
- `--virtualkeyboard <on|off>` — Virtual keyboard
- `--navbar <on|off>` — Android navigation bar
- `--nbcpu <value>` — Number of processors
- `--ram <value>` — Memory in MB
- `--network-mode <nat|bridge>` — Network mode (VirtualBox only)
- `--root-access <on|off>` — Root access (Android 12+ default: off)
- `--quickboot <on|off>` — Resume state (QEMU only, not Windows)
- `--sysprop <property>:<value>` — Build properties (MODEL, PRODUCT, MANUFACTURER, BOARD, BRAND, DEVICE, DISPLAY, SERIAL, FINGERPRINT)

#### gmtool Error Codes

| Code | Meaning | Common Cause |
|---|---|---|
| 0 | Success | — |
| 3 | Command failed | Device won't start — try `--coldboot` or check FAQ |
| 4 | Virtualization engine unresponsive | Hypervisor misconfigured or not installed |
| 5 | Virtual device not found | Wrong name/UUID — check `admin list` |
| 13 | Unable to start device | Hypervisor issue, check FAQ: www.genymotion.com/faq/vd-not-started |
| 14 | Requires Indie/Business license | User must upgrade or use the GUI instead |

---

## Part 3: Genymotion Shell (`genyshell`) — Sensor Simulation

`genyshell` controls sensors on running virtual devices. Use it for automated testing scenarios that need GPS, battery, network, or rotation changes.

#### genyshell Location

- **Windows:** `C:\Program Files\Genymobile\Genymotion\genyshell.exe`
- **macOS:** `/Applications/Genymotion Shell.app/Contents/MacOS/genyshell`
- **Linux:** `$HOME/genymotion/genymotion-shell`

**Also NOT on PATH.** Use full path like gmtool.

#### Usage Modes

```bash
genyshell                              # Interactive mode
genyshell -c "gps setlatitude 48.8566" # Single command
genyshell -f test_script.sh            # Run script file
genyshell -r 192.168.56.101            # Connect by device IP
genyshell -q                           # Quiet mode (no headers)
```

**Every `-c` call prints a welcome banner.** Example output:
```
Connection mode: local host
Welcome to Genymotion Shell

Genymotion virtual device selected: Google Nexus 4

GPS Latitude set to: 48.8566
```
When parsing output, look for the result AFTER the `"Genymotion virtual device selected:"` line.
If only one device is running, genyshell auto-selects it. With multiple devices, use `-r <IP>` to target one.

#### Sensor Commands

GPS:
```bash
gps setstatus enabled
gps setlatitude 48.8566
gps setlongitude 2.3522
gps setaltitude 35.0
gps setaccuracy 1.0
gps setbearing 180.0
```

Battery:
```bash
battery setmode manual
battery setlevel 15
battery setstatus discharging    # charging|discharging|full|not-charging
```

Rotation:
```bash
rotation setangle 0     # 0, 90, 180, 270
```

Network (Android 8+):
```bash
network setstatus enabled
network setsignalstrength 3      # 0-4
network setmobileprofile gsm     # full|gsm|hscsd|gprs|edge|umts|hsdpa|lte|5gnr|custom
```

Phone:
```bash
phone call 5551234567
phone sms 5551234567 "Test message"
phone baseband setoperatorname "Test Carrier"
```

Device management:
```bash
devices list
devices select <ip_or_name>
```

#### Scripting Example: Simulate a Delivery Route

```bash
#!/bin/bash
# delivery_route_test.sh — Run with: genyshell -f delivery_route_test.sh
gps setstatus enabled
gps setlatitude 48.8566
gps setlongitude 2.3522
# (pause in your test framework, then update coordinates)
gps setlatitude 48.8606
gps setlongitude 2.3376
battery setmode manual
battery setlevel 10
battery setstatus discharging
```

---

## Part 4: Common Troubleshooting

#### Desktop Won't Start / Stuck on Boot
```bash
gmtool admin stop "my-device"
gmtool admin start "my-device" --coldboot
```
Use `-v` (verbose) to see detailed error: `gmtool -v admin start "my-device"`
Look for `Player exited early with error code` in the output.

#### Port 6379 Conflict (QEMU on macOS/Linux)
QEMU forwards port 6379 from the virtual device to localhost. If Redis (or anything else) is on port 6379, the device will fail to start with exit code 3. Check:
```bash
lsof -i -P -n | grep 6379
```
If Redis is running, stop it before starting the device, or reconfigure Redis to use a different port.

#### VirtualBox DHCP Error (Windows)
Hyper-V must be completely disabled. Check:
```powershell
bcdedit /set hypervisorlaunchtype off
# Reboot required
```

#### ARM Apps on x86 Devices
For x86 devices running ARM-only apps, flash ARM translation:
```bash
adb push Genymotion-ARM-Translation.zip /sdcard/Download/
adb shell "/system/bin/flash-archive.sh /sdcard/Download/Genymotion-ARM-Translation.zip"
```
Note: Apple Silicon Macs only support `arm64-v8a` apps natively.

#### Google Play Store
Google Play is not pre-installed. Flash Open GApps or use:
```bash
gmtool device -n "my-device" flash open_gapps.zip
```

#### Root Access
Android 12+ images are non-rooted by default:
```bash
# Enable at creation
gmtool admin create <hw> <os> "device" --root-access on
# Or toggle on running device
adb root     # Enable root shell
adb unroot   # Disable root shell
```

#### gmsaas Python Installation Issues
- `ModuleNotFoundError: No module named 'pkg_resources'` → `pip3 install setuptools`
- macOS SSL errors → Run `Install Certificates.command` from Python install folder
- `externally-managed-environment` → Use `pip3 install --user gmsaas` or a virtual environment

#### Architecture Reference

| Platform | Architecture | Apps Supported |
|---|---|---|
| Intel Mac/PC | x86_64 | x86_64 (Android 11+), x86 (Android 5-10), ARM via translation |
| Apple Silicon Mac | arm64 | arm64-v8a only |
| Linux x86_64 | x86_64 | x86_64, x86, ARM via translation |

## API Endpoints

- [Pages API](https://rozz.genymotion.com/api/pages.json) - 441 indexed pages
- [Q&A API](https://rozz.genymotion.com/api/qna.json) - 277 questions answered
- [Topics API](https://rozz.genymotion.com/api/topics.json) - Topic taxonomy

---

**Content Statistics:**
- Total Pages: 441
- Total Q&As: 277
- Topics Covered: 16
- Last Updated: 2026-10-07
- Update Frequency: Weekly

*This file is auto-generated. For questions, contact contact@genymobile.com*