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

## 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:**
- [What are Genymotion Desktop requirements?](https://rozz.genymotion.com/pages/what-are-genymotion-desktop-requirements.html)
- [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)
- [I recently upgraded VirtualBox and Genymotion no longer works](https://rozz.genymotion.com/pages/i-recently-upgraded-virtualbox-and-genymotion-no-longer-work.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)

**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:**
- [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)
- [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)
- [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 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)
- [Can I use Genymotion Desktop remotely?](https://rozz.genymotion.com/pages/can-i-use-genymotion-desktop-remotely.html)
- [How to access a Genymotion PaaS/Device image instance from secured networks?](https://rozz.genymotion.com/pages/how-to-access-a-genymotion-paas-device-image-instance-from-s.html)
- [How to report Genymotion website security vulnerability and bugs?](https://rozz.genymotion.com/pages/how-to-report-genymotion-website-security-vulnerability-and.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)
- [Why use Genymotion?](https://rozz.genymotion.com/pages/why-use-genymotion.html)
- [Genymotion Java API](https://rozz.genymotion.com/pages/genymotion-java-api-4.html)
- [Microfocus](https://rozz.genymotion.com/pages/microfocus.html)
- [Applitools](https://rozz.genymotion.com/pages/applitools.html)
- [Bolt Food Case Study](https://rozz.genymotion.com/pages/bolt-food-case-study.html)
- [AppsFlyer Case Study](https://rozz.genymotion.com/pages/appsflyer-case-study.html)
- [File Upload](https://rozz.genymotion.com/pages/file-upload.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)

**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:**
- [Can I play games with Genymotion?](https://rozz.genymotion.com/pages/can-i-play-games-with-genymotion.html)
- [Can I use OBS Studio Virtual Camera with Genymotion SaaS?](https://rozz.genymotion.com/pages/can-i-use-obs-studio-virtual-camera-with-genymotion-saas.html)
- [– EULA –](https://rozz.genymotion.com/pages/eula.html)
- [Can Genymotion Desktop run in a Cloud service (AWS, Google Cloud, MS Azure, A...](https://rozz.genymotion.com/pages/can-genymotion-desktop-run-in-a-cloud-service-aws-google-clo.html)
- [How to embed a Genymotion SaaS (Cloud) device in your website?](https://rozz.genymotion.com/pages/how-to-embed-a-genymotion-saas-cloud-device-in-your-website.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)
- [I can't sign in to my Genymotion Cloud account: "Fail to login"](https://rozz.genymotion.com/pages/i-can-t-sign-in-to-my-genymotion-cloud-account-fail-to-login.html)
- [The virtual device display is black](https://rozz.genymotion.com/pages/the-virtual-device-display-is-black.html)
- [As a reseller, my client is interested in an AWS EC2 instance. How can I requ...](https://rozz.genymotion.com/pages/as-a-reseller-my-client-is-interested-in-an-aws-ec2-instance.html)
- [How many Genymotion Virtual Devices can I launch per AWS EC2 instance?](https://rozz.genymotion.com/pages/how-many-genymotion-virtual-devices-can-i-launch-per-aws-ec2.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)

### Hypervisor & VM Setup

**Pages:**
- [Linux - Unable to start the Virtual Device](https://rozz.genymotion.com/pages/linux-unable-to-start-the-virtual-device.html)
- [Windows - Unable to start the Virtual Device](https://rozz.genymotion.com/pages/windows-unable-to-start-the-virtual-device.html)
- [An error has occurred while trying to create a virtualbox host-only network i...](https://rozz.genymotion.com/pages/an-error-has-occurred-while-trying-to-create-a-virtualbox-ho.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)
- [Apple Mac M series support](https://rozz.genymotion.com/pages/apple-mac-m-series-support.html)
- [How to disable Hyper-V in Windows?](https://rozz.genymotion.com/pages/how-to-disable-hyper-v-in-windows.html)
- [Genymotion Desktop and VPN](https://rozz.genymotion.com/pages/genymotion-desktop-and-vpn.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)
- [I recently upgraded VirtualBox and Genymotion no longer works](https://rozz.genymotion.com/pages/i-recently-upgraded-virtualbox-and-genymotion-no-longer-work.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)

**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)

### Virtual Device Management

**Pages:**
- [Unable to start the Virtual Device](https://rozz.genymotion.com/pages/unable-to-start-the-virtual-device.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)
- [Can I use my host microphone with Genymotion PaaS/Device image?](https://rozz.genymotion.com/pages/can-i-use-my-host-microphone-with-genymotion-paas-device-ima.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 have generated and setup a certificate but I still get a security warning w...](https://rozz.genymotion.com/pages/i-have-generated-and-setup-a-certificate-but-i-still-get-a-s.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)
- [Can I change the camera resolution?](https://rozz.genymotion.com/pages/can-i-change-the-camera-resolution.html)
- [I cannot run more than 2 virtual devices at the same time. Is it possible to ...](https://rozz.genymotion.com/pages/i-cannot-run-more-than-2-virtual-devices-at-the-same-time-is.html)
- [The virtual device display does not rotate](https://rozz.genymotion.com/pages/the-virtual-device-display-does-not-rotate.html)
- [How to connect a virtual device to a proxy?](https://rozz.genymotion.com/pages/how-to-connect-a-virtual-device-to-a-proxy.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 create a new virtual device in Genymotion?](https://rozz.genymotion.com/qna/how-do-i-create-a-new-virtual-device-in-genymotion.html)
- [How many device templates does Genymotion offer?](https://rozz.genymotion.com/qna/how-many-device-templates-does-genymotion-offer.html)
- [Is it can open the camera to scan qr code ?](https://rozz.genymotion.com/qna/is-it-can-open-the-camera-to-scan-qr-code.html)
- [I won't use a physical webcam! Tell me alternatives so I can use an emulated device!?](https://rozz.genymotion.com/qna/i-won-t-use-a-physical-webcam-tell-me-alternatives-so-i-can.html)

### Android Dev Integration

**Pages:**
- [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 establish a TCP session to a virtual device?](https://rozz.genymotion.com/pages/how-to-establish-a-tcp-session-to-a-virtual-device.html)
- [I keep getting "Android Setup keeps stopping" error](https://rozz.genymotion.com/pages/i-keep-getting-android-setup-keeps-stopping-error.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)
- [How to install and setup Aurora Store on Genymotion?](https://rozz.genymotion.com/pages/how-to-install-and-setup-aurora-store-on-genymotion.html)
- [How to play games with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-play-games-with-genymotion-desktop-2.html)
- [I can't install or run an application/game in Genymotion Desktop](https://rozz.genymotion.com/pages/i-can-t-install-or-run-an-application-game-in-genymotion-des.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 enable kiosk mode with Genymotion SaaS (Cloud)?](https://rozz.genymotion.com/pages/how-to-enable-kiosk-mode-with-genymotion-saas-cloud.html)
- [I can't find TikTok in Google Play Store](https://rozz.genymotion.com/pages/i-can-t-find-tiktok-in-google-play-store.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 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/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)
- [GMTool returns the error code 14](https://rozz.genymotion.com/pages/gmtool-returns-the-error-code-14.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)
- [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)
- [Is there a trial for Genymotion Desktop Pro edition?](https://rozz.genymotion.com/pages/is-there-a-trial-for-genymotion-desktop-pro-edition-2.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)
- [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)
- [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)
- [Educational Offer Application Form](https://rozz.genymotion.com/pages/educational-offer-application-form.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:**
- [How to create your own skin in Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-create-your-own-skin-in-genymotion-desktop.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)
- [Is Genymotion Desktop available for 32-bit?](https://rozz.genymotion.com/pages/is-genymotion-desktop-available-for-32-bit.html)
- [Does Genymotion emulate Bluetooth?](https://rozz.genymotion.com/pages/does-genymotion-emulate-bluetooth.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)
- [Do Social Media apps work with Genymotion?](https://rozz.genymotion.com/pages/do-social-media-apps-work-with-genymotion.html)
- [How can I get old versions of Genymotion Desktop?](https://rozz.genymotion.com/pages/how-can-i-get-old-versions-of-genymotion-desktop.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 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:**
- [How to purchase a Genymotion Desktop license?](https://rozz.genymotion.com/pages/how-to-purchase-a-genymotion-desktop-license.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)
- [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)
- [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)
- [Is it possible to use Genymotion Desktop offline?](https://rozz.genymotion.com/pages/is-it-possible-to-use-genymotion-desktop-offline.html)
- [How to release or re-assign a BUSINESS License?](https://rozz.genymotion.com/pages/how-to-release-or-re-assign-a-business-license.html)
- [How to renew Genymotion Desktop licenses?](https://rozz.genymotion.com/pages/how-to-renew-genymotion-desktop-licenses.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:**
- [Unable to load OpenGL libraries from your system](https://rozz.genymotion.com/pages/unable-to-load-opengl-libraries-from-your-system.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)
- [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 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)
- [ARM64 virtual devices in Southeast Asia (Singapore) region](https://rozz.genymotion.com/pages/arm64-virtual-devices-in-southeast-asia-singapore-region.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)

### Account & API Access

**Pages:**
- [How to screen record with Genymotion PaaS/Device image?](https://rozz.genymotion.com/pages/how-to-screen-record-with-genymotion-paas-device-image.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)
- [I have forgotten my Genymotion (Desktop) account password](https://rozz.genymotion.com/pages/i-have-forgotten-my-genymotion-desktop-account-password.html)
- [Genymotion on your own servers](https://rozz.genymotion.com/pages/genymotion-on-your-own-servers.html)
- [Install a certificate](https://rozz.genymotion.com/pages/install-a-certificate.html)
- [How to embed a Genymotion Device image instance in a website?](https://rozz.genymotion.com/pages/how-to-embed-a-genymotion-device-image-instance-in-a-website.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 don't receive the activation mail](https://rozz.genymotion.com/pages/i-don-t-receive-the-activation-mail.html)
- [The account confirmation e-mail doesn’t have a link](https://rozz.genymotion.com/pages/the-account-confirmation-e-mail-doesn-t-have-a-link.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)

### CLI & Shell Tooling

**Pages:**
- [How to get Genymotion Desktop logs?](https://rozz.genymotion.com/pages/how-to-get-genymotion-desktop-logs-2.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)
- [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 run automated tests with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-run-automated-tests-with-genymotion-desktop.html)
- [Make a minimalist Ubuntu + gmsaas Docker image](https://rozz.genymotion.com/pages/make-a-minimalist-ubuntu-gmsaas-docker-image.html)
- [gmsaas release notes (tag: gmsaas)](https://rozz.genymotion.com/pages/gmsaas-release-notes-tag-gmsaas.html)
- [Genymotion Device image (PaaS)](https://rozz.genymotion.com/pages/genymotion-device-image-paas.html)
- [gmsaas 1.15.0: Now with Native arm64 Support! 🚀](https://rozz.genymotion.com/pages/gmsaas-1-15-0-now-with-native-arm64-support.html)
- [Issues](https://rozz.genymotion.com/pages/issues.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)

### Android Version Selection

**Pages:**
- [Is Android 16 available?](https://rozz.genymotion.com/pages/is-android-16-available.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 PaaS Release Notes](https://rozz.genymotion.com/pages/genymotion-paas-release-notes.html)
- [Is it possible to use a custom ROM?](https://rozz.genymotion.com/pages/is-it-possible-to-use-a-custom-rom.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:**
- [How to uninstall Genymotion Desktop completely (purge)?](https://rozz.genymotion.com/pages/how-to-uninstall-genymotion-desktop-completely-purge-2.html)
- [How to delete my Genymotion Desktop account?](https://rozz.genymotion.com/pages/how-to-delete-my-genymotion-desktop-account-2.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.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) - 347 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: 347
- Total Q&As: 201
- Topics Covered: 15
- Last Updated: 2026-06-16
- Update Frequency: Weekly

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