# 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, Virtual Device Management, Hypervisor & VM Setup

## 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. Start with `/api/qna.json` for all Q&A content with answers
2. Use `/api/pages.json` for full page index with metadata
3. Individual pages at `/qna/{slug}.html` for detailed answers
4. 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)
- [Genymotion in the Cloud with a user-friendly interface](https://rozz.genymotion.com/pages/genymotion-in-the-cloud-with-a-user-friendly-interface.html)
- [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.html)
- [Is Genymotion free?](https://rozz.genymotion.com/pages/is-genymotion-free.html)
- [I can't install or run an application/game in Genymotion SaaS](https://rozz.genymotion.com/pages/i-can-t-install-or-run-an-application-game-in-genymotion-saa.html)

**Top Questions:**
- [Is Genymotion free to use?](https://rozz.genymotion.com/qna/is-genymotion-free-to-use.html)
- [What is Genymotion's cloud phone service and its pricing?](https://rozz.genymotion.com/qna/what-is-genymotion-s-cloud-phone-service-and-its-pricing.html)
- [What are the step-by-step Genymotion installation instructions, including how to verify your syst...?](https://rozz.genymotion.com/qna/what-are-the-step-by-step-genymotion-installation-instructio.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 is Genymotion's monthly quote for a single upfront payment?](https://rozz.genymotion.com/qna/what-is-genymotion-s-monthly-quote-for-a-single-upfront-paym.html)

## Topic Index

### Network & Security Config

**Pages:**
- [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)
- [I can't sign in to Genymotion Desktop](https://rozz.genymotion.com/pages/i-can-t-sign-in-to-genymotion-desktop.html)
- [I can't log in to Genymotion Desktop: "Invalid reply from server" / "Somethin...](https://rozz.genymotion.com/pages/i-can-t-log-in-to-genymotion-desktop-invalid-reply-from-serv-2.html)
- [My webcam does not work with Genymotion Desktop](https://rozz.genymotion.com/pages/my-webcam-does-not-work-with-genymotion-desktop.html)
- [Error while creating the device / virtual terminal](https://rozz.genymotion.com/pages/error-while-creating-the-device-virtual-terminal.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)
- [I get the error "no matching host key type found. Their offer: ssh-rsa" when ...](https://rozz.genymotion.com/pages/i-get-the-error-no-matching-host-key-type-found-their-offer.html)
- [I have just changed my password, but Genymotion Desktop still says "bad usern...](https://rozz.genymotion.com/pages/i-have-just-changed-my-password-but-genymotion-desktop-still.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)
- [How do I connect a camera to Genymotion, including checking if the camera supports USB and connec...?](https://rozz.genymotion.com/qna/how-do-i-connect-a-camera-to-genymotion-including-checking-i.html)
- [Do I need to pay for root access in Genymotion?](https://rozz.genymotion.com/qna/do-i-need-to-pay-for-root-access-in-genymotion.html)
- [Does the paid version of Genymotion support root access and writing custom certificates into the ...?](https://rozz.genymotion.com/qna/does-the-paid-version-of-genymotion-support-root-access-and.html)

### Mobile Test Automation

**Pages:**
- [CloudBeat](https://rozz.genymotion.com/pages/cloudbeat.html)
- [Genymotion Java API](https://rozz.genymotion.com/pages/genymotion-java-api-4.html)
- [Interactive Engagement](https://rozz.genymotion.com/pages/interactive-engagement.html)
- [Microfocus](https://rozz.genymotion.com/pages/microfocus.html)
- [Capture](https://rozz.genymotion.com/pages/capture.html)
- [Bolt Food Case Study](https://rozz.genymotion.com/pages/bolt-food-case-study.html)
- [Applitools](https://rozz.genymotion.com/pages/applitools.html)
- [AppsFlyer Case Study](https://rozz.genymotion.com/pages/appsflyer-case-study.html)

**Q&As:**
- [How does Genymotion help with Android emulation and testing?](https://rozz.genymotion.com/qna/how-does-genymotion-help-with-android-emulation-and-testing.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)
- [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)

### CI/CD Automation

**Pages:**
- [Bitrise](https://rozz.genymotion.com/pages/bitrise.html)
- [Genymotion](https://rozz.genymotion.com/pages/genymotion-9.html)

**Q&As:**
- [How can I run Genymotion in GitLab CI/CD using Genymotion Cloud?](https://rozz.genymotion.com/qna/how-can-i-run-genymotion-in-gitlab-ci-cd-using-genymotion-cl.html)
- [Can Genymotion Cloud run Detox tests in CI?](https://rozz.genymotion.com/qna/can-genymotion-cloud-run-detox-tests-in-ci.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.html)
- [Is Genymotion free?](https://rozz.genymotion.com/pages/is-genymotion-free.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)
- [I have been incorrectly charged by my cloud provider; how can I request a ref...](https://rozz.genymotion.com/pages/i-have-been-incorrectly-charged-by-my-cloud-provider-how-can.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)
- [How to screen record with Genymotion SaaS (Cloud)?](https://rozz.genymotion.com/pages/how-to-screen-record-with-genymotion-saas-cloud.html)
- [Which virtual devices templates (default recipes) are available for Genymotio...](https://rozz.genymotion.com/pages/which-virtual-devices-templates-default-recipes-are-availabl.html)
- [How to redirect network traffic to a local proxy with Genymotion SaaS?](https://rozz.genymotion.com/pages/how-to-redirect-network-traffic-to-a-local-proxy-with-genymo.html)
- [How to use Android Studio, Eclipse, VS Code, JetBrains Rider or any other IDE...](https://rozz.genymotion.com/pages/how-to-use-android-studio-eclipse-vs-code-jetbrains-rider-or.html)
- [How to change a device product properties (manufacturer, model, etc.) with Ge...](https://rozz.genymotion.com/pages/how-to-change-a-device-product-properties-manufacturer-model.html)

**Q&As:**
- [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 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 does Genymotion Cloud enable online automated testing?](https://rozz.genymotion.com/qna/how-does-genymotion-cloud-enable-online-automated-testing.html)
- [How can Genymotion Cloud be used on a Windows machine?](https://rozz.genymotion.com/qna/how-can-genymotion-cloud-be-used-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)
- [How can Genymotion be used without downloading or installing?](https://rozz.genymotion.com/qna/how-can-genymotion-be-used-without-downloading-or-installing.html)
- [How can Genymotion be used directly in the web emulator?](https://rozz.genymotion.com/qna/how-can-genymotion-be-used-directly-in-the-web-emulator.html)

### Virtual Device Management

**Pages:**
- [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)
- [How to screen record with Genymotion PaaS/Device image?](https://rozz.genymotion.com/pages/how-to-screen-record-with-genymotion-paas-device-image.html)
- [The virtual device display does not rotate](https://rozz.genymotion.com/pages/the-virtual-device-display-does-not-rotate.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)
- [The Wifi is disabled (no network) when I boot the device](https://rozz.genymotion.com/pages/the-wifi-is-disabled-no-network-when-i-boot-the-device-2.html)
- [ADB connection is lost after a while with my Genymotion PaaS/Device image ins...](https://rozz.genymotion.com/pages/adb-connection-is-lost-after-a-while-with-my-genymotion-paas.html)
- [How to use a VPN with Genymotion PaaS/Device Image?](https://rozz.genymotion.com/pages/how-to-use-a-vpn-with-genymotion-paas-device-image.html)
- [How to connect a Genymotion PaaS/Device Image instance to any IDE?](https://rozz.genymotion.com/pages/how-to-connect-a-genymotion-paas-device-image-instance-to-an.html)
- [I forgot to stop my Genymotion PaaS/Device Image instance; can I get a refund?](https://rozz.genymotion.com/pages/i-forgot-to-stop-my-genymotion-paas-device-image-instance-ca.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)

**Q&As:**
- [What is Genymotion Android Emulator and how can I use it for Android testing?](https://rozz.genymotion.com/qna/what-is-genymotion-android-emulator-and-how-can-i-use-it-for.html)
- [What are Genymotion snapshots and how do they work?](https://rozz.genymotion.com/qna/what-are-genymotion-snapshots-and-how-do-they-work.html)
- [How to select an ARM-based Android Virtual Device (AVD) in Genymotion?](https://rozz.genymotion.com/qna/how-to-select-an-arm-based-android-virtual-device-avd-in-gen.html)
- [How can I create a new virtual device?](https://rozz.genymotion.com/qna/how-can-i-create-a-new-virtual-device-2.html)
- [Which Genymotion plan includes a rootless device?](https://rozz.genymotion.com/qna/which-genymotion-plan-includes-a-rootless-device.html)
- [If i want to play arknights endfield, which device should i create?](https://rozz.genymotion.com/qna/if-i-want-to-play-arknights-endfield-which-device-should-i-c.html)
- [How do I use it on Ubuntu?](https://rozz.genymotion.com/qna/how-do-i-use-it-on-ubuntu.html)
- [How do I create a new virtual device in Genymotion?](https://rozz.genymotion.com/qna/how-do-i-create-a-new-virtual-device-in-genymotion.html)
- [Can you walk me through downloading and installing the Genymotion Desktop app?](https://rozz.genymotion.com/qna/can-you-walk-me-through-downloading-and-installing-the-genym.html)
- [I have mobsf in kali linux in vmware workstation 17 I want to run Genymotion with mobsf ?](https://rozz.genymotion.com/qna/i-have-mobsf-in-kali-linux-in-vmware-workstation-17-i-want-t.html)

### Hypervisor & VM Setup

**Pages:**
- [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-2.html)
- [Can I use OBS virtual camera with Genymotion Desktop?](https://rozz.genymotion.com/pages/can-i-use-obs-virtual-camera-with-genymotion-desktop-2.html)
- [macOS - Unable to start the Virtual Device](https://rozz.genymotion.com/pages/macos-unable-to-start-the-virtual-device.html)
- [macOS - An error has occurred while trying to create a virtualbox host-only n...](https://rozz.genymotion.com/pages/macos-an-error-has-occurred-while-trying-to-create-a-virtual.html)
- [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)
- [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-2.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 transfer a Genymotion Desktop virtual device to another Computer? (Vir...](https://rozz.genymotion.com/pages/how-to-transfer-a-genymotion-desktop-virtual-device-to-anoth.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)
- [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)

**Q&As:**
- [What are the system requirements?](https://rozz.genymotion.com/qna/what-are-the-system-requirements.html)
- [What are the step-by-step Genymotion installation instructions, including how to verify your syst...?](https://rozz.genymotion.com/qna/what-are-the-step-by-step-genymotion-installation-instructio.html)
- [What are Genymotion Desktop's system requirements for macOS Catalina?](https://rozz.genymotion.com/qna/what-are-genymotion-desktop-s-system-requirements-for-macos.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)
- [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 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 Genymotion be uninstalled on Linux?](https://rozz.genymotion.com/qna/how-can-genymotion-be-uninstalled-on-linux.html)
- [Which Genymotion versions are available for download on an Intel Mac?](https://rozz.genymotion.com/qna/which-genymotion-versions-are-available-for-download-on-an-i.html)
- [To use genymotion emulator, which should i download genimotion, with virtualbox or without virtua...?](https://rozz.genymotion.com/qna/to-use-genymotion-emulator-which-should-i-download-genimotio.html)
- [I am using Windows 10, can you provide a detailed step-by-step guide on how to install Genymotion?](https://rozz.genymotion.com/qna/i-am-using-windows-10-can-you-provide-a-detailed-step-by-ste.html)

### Android Dev Integration

**Pages:**
- [How to install Magisk on Genymotion?](https://rozz.genymotion.com/pages/how-to-install-magisk-on-genymotion-2.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)
- [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 Android work profiles?](https://rozz.genymotion.com/pages/how-to-enable-android-work-profiles.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 to a Genymotion Desktop virtual device remotely with ADB?](https://rozz.genymotion.com/pages/how-to-connect-to-a-genymotion-desktop-virtual-device-remote.html)
- [I can't find Google Play Store. Where is it?](https://rozz.genymotion.com/pages/i-can-t-find-google-play-store-where-is-it.html)
- [I can't find Google Play Store. Where is it?](https://rozz.genymotion.com/pages/i-can-t-find-google-play-store-where-is-it-2.html)
- [How to play games with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-play-games-with-genymotion-desktop-2.html)
- [How to install and setup Aurora Store on Genymotion?](https://rozz.genymotion.com/pages/how-to-install-and-setup-aurora-store-on-genymotion.html)

**Q&As:**
- [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)
- [How do I install Google Play Store on Genymotion Desktop?](https://rozz.genymotion.com/qna/how-do-i-install-google-play-store-on-genymotion-desktop.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)

### Cloud Marketplace & Pricing

**Pages:**
- [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)
- [How will I be charged for Genymotion on Alibaba?](https://rozz.genymotion.com/pages/how-will-i-be-charged-for-genymotion-on-alibaba.html)
- [How will I be charged for Genymotion on Google Cloud Platform (GCP)?](https://rozz.genymotion.com/pages/how-will-i-be-charged-for-genymotion-on-google-cloud-platfor.html)
- [Contact Us](https://rozz.genymotion.com/pages/contact-us.html)
- [— EULA —](https://rozz.genymotion.com/pages/eula.html)
- [How will I be charged for Genymotion on Amazon Web Service (AWS)?](https://rozz.genymotion.com/pages/how-will-i-be-charged-for-genymotion-on-amazon-web-service-a.html)
- [Shrink Your Costs: The Genymotion Desktop Winter Sale is Here!](https://rozz.genymotion.com/pages/shrink-your-costs-the-genymotion-desktop-winter-sale-is-here.html)
- [French Days 2026: Get 20% off Genymotion Desktop!](https://rozz.genymotion.com/pages/french-days-2026-get-20-off-genymotion-desktop.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 Genymotion's cloud phone service and its pricing?](https://rozz.genymotion.com/qna/what-is-genymotion-s-cloud-phone-service-and-its-pricing.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 is Genymotion's monthly quote for a single upfront payment?](https://rozz.genymotion.com/qna/what-is-genymotion-s-monthly-quote-for-a-single-upfront-paym.html)
- [What are Genymotion's pricing plans and revenue models?](https://rozz.genymotion.com/qna/what-are-genymotion-s-pricing-plans-and-revenue-models.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 are Genymotion's pricing options for SaaS and Desktop licenses?](https://rozz.genymotion.com/qna/what-are-genymotion-s-pricing-options-for-saas-and-desktop-l.html)
- [What is the difference between Genymotion packages?](https://rozz.genymotion.com/qna/what-is-the-difference-between-genymotion-packages.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)

### Performance & Compatibility

**Pages:**
- [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)
- [Genymotion Desktop starts but the main window does not show or is white](https://rozz.genymotion.com/pages/genymotion-desktop-starts-but-the-main-window-does-not-show.html)
- [How to set a custom DPI with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-set-a-custom-dpi-with-genymotion-desktop.html)
- [Genymotion Desktop becomes unstable and slow after a while.](https://rozz.genymotion.com/pages/genymotion-desktop-becomes-unstable-and-slow-after-a-while.html)
- [I have a 4K monitor and some icons are blurry, and/or some parts of the UI ar...](https://rozz.genymotion.com/pages/i-have-a-4k-monitor-and-some-icons-are-blurry-and-or-some-pa.html)
- [Genymotion Desktop Release Notes](https://rozz.genymotion.com/pages/genymotion-desktop-release-notes-4.html)
- [Genymotion 2.11.0 (October 25th, 2017)](https://rozz.genymotion.com/pages/genymotion-2-11-0-october-25th-2017.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)
- [Why won't Genymotion connect after installation?](https://rozz.genymotion.com/qna/why-won-t-genymotion-connect-after-installation.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)
- [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)
- [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)
- [Can I install games on Genymotion?](https://rozz.genymotion.com/qna/can-i-install-games-on-genymotion.html)
- [Does Genymotion provide real devices for testing?](https://rozz.genymotion.com/qna/genymotion-provide-real-device-for-testing.html)
- [Is Bluetooth supported?](https://rozz.genymotion.com/qna/is-bluetooth-supported.html)
- [Can games also be played on Genymotion?](https://rozz.genymotion.com/qna/can-games-also-be-played-on-genymotion.html)
- [Can Genymotion run an apk i want?](https://rozz.genymotion.com/qna/can-genymotion-run-an-apk-i-want.html)

### Licensing & Activation

**Pages:**
- [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)
- [License Guide](https://rozz.genymotion.com/pages/license-guide-2.html)
- [How to renew Genymotion Desktop licenses?](https://rozz.genymotion.com/pages/how-to-renew-genymotion-desktop-licenses.html)
- [Is it possible to use Genymotion Desktop offline?](https://rozz.genymotion.com/pages/is-it-possible-to-use-genymotion-desktop-offline-2.html)
- [I get the error: "You have activated the maximum number of workstations allow...](https://rozz.genymotion.com/pages/i-get-the-error-you-have-activated-the-maximum-number-of-wor-2.html)
- [I get the error: "You have activated the maximum number of workstations allow...](https://rozz.genymotion.com/pages/i-get-the-error-you-have-activated-the-maximum-number-of-wor.html)
- [I can't activate my Dektop account: "Invalid or expired activation link"](https://rozz.genymotion.com/pages/i-can-t-activate-my-dektop-account-invalid-or-expired-activa-2.html)
- [I have just created a Genymotion Cloud SaaS account. How do I activate my fre...](https://rozz.genymotion.com/pages/i-have-just-created-a-genymotion-cloud-saas-account-how-do-i-2.html)
- [Can I transfer a license to another computer?](https://rozz.genymotion.com/pages/can-i-transfer-a-license-to-another-computer.html)

**Q&As:**
- [Does Genymotion offer a free version?](https://rozz.genymotion.com/qna/does-genymotion-offer-a-free-version.html)
- [How do I activate the free Genymotion Desktop personal edition?](https://rozz.genymotion.com/qna/how-do-i-activate-the-free-genymotion-desktop-personal-editi.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)
- [Does Genymotion offer a free Personal Use edition and a 30-day Pro trial?](https://rozz.genymotion.com/qna/does-genymotion-offer-a-free-personal-use-edition-and-a-30-d.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)
- [Does Genymotion offer a free personal account?](https://rozz.genymotion.com/qna/does-genymotion-offer-a-free-personal-account.html)
- [Is Genymotion free or paid?](https://rozz.genymotion.com/qna/is-genymotion-free-or-paid.html)
- [Is Genymotion free to use?](https://rozz.genymotion.com/qna/is-genymotion-free-to-use.html)
- [How many concurrent device instances can I have with the free desktop license?](https://rozz.genymotion.com/qna/how-many-concurrent-device-instances-can-i-have-with-the-fre.html)
- [What stage is the license is bound to the customer’s Genymotion account?](https://rozz.genymotion.com/qna/what-stage-is-the-license-is-bound-to-the-customers-genymoti.html)

### GPU & ARM Support

**Pages:**
- [I can't find TikTok in Google Play Store](https://rozz.genymotion.com/pages/i-can-t-find-tiktok-in-google-play-store.html)
- [ARM64 virtual devices in Southeast Asia (Singapore) region](https://rozz.genymotion.com/pages/arm64-virtual-devices-in-southeast-asia-singapore-region.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)
- [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)
- [Is Genymotion Desktop available for 32-bit?](https://rozz.genymotion.com/pages/is-genymotion-desktop-available-for-32-bit.html)
- [Download Genymotion Desktop](https://rozz.genymotion.com/pages/download-genymotion-desktop.html)
- [Which Linux distributions are officially supported?](https://rozz.genymotion.com/pages/which-linux-distributions-are-officially-supported.html)

**Q&As:**
- [What is the architecture of the cloud devices?](https://rozz.genymotion.com/qna/what-is-the-architecture-of-the-cloud-devices.html)
- [What are the exact steps to use Genymotion's ARM translation tool on the desktop?](https://rozz.genymotion.com/qna/what-are-the-exact-steps-to-use-genymotion-s-arm-translation.html)
- [What is Genymotion's current ARM translation support and how should I test ARM apps now?](https://rozz.genymotion.com/qna/what-is-genymotion-s-current-arm-translation-support-and-how.html)
- [How to get arm version of android ?](https://rozz.genymotion.com/qna/how-to-get-arm-version-of-android.html)
- [Which graphics-intensive apps can benefit from Genymotion's cloud GPU acceleration?](https://rozz.genymotion.com/qna/which-graphics-intensive-apps-can-benefit-from-genymotion-s.html)
- [What changes does Genymotion SaaS make to arm64 and restrict x86 after March 30 2026?](https://rozz.genymotion.com/qna/what-changes-does-genymotion-saas-make-to-arm64-and-restrict.html)
- [Where can I find a complete ARM-based Android guide for Genymotion?](https://rozz.genymotion.com/qna/where-can-i-find-a-complete-arm-based-android-guide-for-geny.html)
- [Is Genymotion good for gaming?](https://rozz.genymotion.com/qna/is-genymotion-good-for-gaming.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)
- [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)

### CLI & Shell Tooling

**Pages:**
- [gmsaas 1.15.0: Now with Native arm64 Support! 🚀](https://rozz.genymotion.com/pages/gmsaas-1-15-0-now-with-native-arm64-support.html)
- [How to get Genymotion Desktop logs?](https://rozz.genymotion.com/pages/how-to-get-genymotion-desktop-logs.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)
- [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)
- [Issues](https://rozz.genymotion.com/pages/issues.html)
- [Tools and Plugins](https://rozz.genymotion.com/pages/tools-and-plugins.html)
- [Release notes for gmsaas](https://rozz.genymotion.com/pages/release-notes-for-gmsaas.html)
- [Genymotion Desktop installer doesn’t run](https://rozz.genymotion.com/pages/genymotion-desktop-installer-doesn-t-run.html)

**Q&As:**
- [What is the difference between Genymotion and Genymotion Shell? Why did I download the Mac versio...?](https://rozz.genymotion.com/qna/what-is-the-difference-between-genymotion-and-genymotion-she.html)
- [What should I do with the .shell file in Genymotion?](https://rozz.genymotion.com/qna/what-should-i-do-with-the-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)

### 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)
- [Install a certificate](https://rozz.genymotion.com/pages/install-a-certificate.html)
- [Genymotion PaaS Overview](https://rozz.genymotion.com/pages/genymotion-paas-overview.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)
- [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)
- [Share or Embed an instance](https://rozz.genymotion.com/pages/share-or-embed-an-instance.html)
- [Device HTTP API](https://rozz.genymotion.com/pages/device-http-api.html)
- [Genymotion Help Center](https://rozz.genymotion.com/pages/genymotion-help-center.html)

**Q&As:**
- [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 PaaS v14.2](https://rozz.genymotion.com/pages/genymotion-paas-v14-2.html)
- [Genymotion Desktop Release Notes](https://rozz.genymotion.com/pages/genymotion-desktop-release-notes-2.html)

**Q&As:**
- [Is Android 16 available in Genymotion SaaS and Device Image, and when will it be on Desktop?](https://rozz.genymotion.com/qna/is-android-16-available-in-genymotion-saas-and-device-image.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)
- [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)
- [Can I run Android 6 on Genymotion?](https://rozz.genymotion.com/qna/can-i-run-android-6-on-genymotion.html)

### General

**Pages:**
- [Is it possible to use Genymotion Desktop offline?](https://rozz.genymotion.com/pages/is-it-possible-to-use-genymotion-desktop-offline.html)
- [Genymotion Device Image (PaaS) - Refund & Cancel Policy](https://rozz.genymotion.com/pages/genymotion-device-image-paas-refund-cancel-policy.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) - 303 indexed pages
- [Q&A API](https://rozz.genymotion.com/api/qna.json) - 201 questions answered
- [Topics API](https://rozz.genymotion.com/api/topics.json) - Topic taxonomy

---

**Content Statistics:**
- Total Pages: 303
- Total Q&As: 201
- Topics Covered: 15
- Last Updated: 2026-07-02
- Update Frequency: Weekly

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