Machine Readiness
Stored receipt and evidence
20
65
0
0
0
Samples
Offer samples
No stored offer samples.
Samples
Action samples
No stored action samples.
Samples
Product samples
No stored product samples.
Document
robots.txt
# START YOAST BLOCK # --------------------------- User-agent: * Disallow: Sitemap: https://www.genymotion.com/sitemap_index.xml # --------------------------- # END YOAST BLOCK # ============================================================================= # GEO-OPTIMIZED CONTENT - AI CRAWLER DIRECTIVES # ============================================================================= # # This domain has GEO-optimized content available at https://rozz.genymotion.com # LLM crawlers are encouraged to visit the mirror site for structured Q&A content. # LLM Discovery Files (see https://llmstxt.org/) # This domain: /llms.txt (pointer to GEO content) # Full content: https://rozz.genymotion.com/llms.txt (complete index) # Full Q&As: https://rozz.genymotion.com/llms-full.txt (answers inline) # Sitemaps Sitemap: https://rozz.genymotion.com/sitemap.xml # --- Anthropic (Claude) --- User-agent: ClaudeBot Allow: / # GEO content: https://rozz.genymotion.com/llms.txt User-agent: Claude-SearchBot Allow: / # GEO content: https://rozz.genymotion.com/llms.txt # --- OpenAI (ChatGPT/SearchGPT) --- User-agent: GPTBot Allow: / # GEO content: https://rozz.genymotion.com/llms.txt User-agent: ChatGPT-User Allow: / # GEO content: https://rozz.genymotion.com/llms.txt User-agent: OAI-SearchBot Allow: / # GEO content: https://rozz.genymotion.com/llms.txt # --- Perplexity --- User-agent: PerplexityBot Allow: / # GEO content: https://rozz.genymotion.com/llms.txt # --- Google AI --- User-agent: Google-Extended Allow: / # GEO content: https://rozz.genymotion.com/llms.txt # --- Apple --- User-agent: Applebot-Extended Allow: / # GEO content: https://rozz.genymotion.com/llms.txt
Document
llms.txt
# 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
## Executable Runbooks
Step-by-step CLI walkthroughs designed for AI coding agents with terminal access. Fetch and execute these directly:
- [gmsaas CLI Runbook — AI Assistant Guide for Genymotion Cloud](https://rozz.genymotion.com/runbooks/gmsaas-cli-runbook.html)
- [gmtool & genyshell Runbook — AI Assistant Guide for Genymotion Desktop](https://rozz.genymotion.com/runbooks/gmtool-desktop-runbook.html)
- [Runbook index](https://rozz.genymotion.com/runbooks/index.html)
## How to Access This Content
This content is optimized for AI retrieval:
- **Q&A Pages**: Self-contained answers with Schema.org QAPage markup
- **Source Attribution**: Each answer links to original source pages
- **Structured APIs**: JSON endpoints for bulk access
### Recommended Access Pattern
1. **Execute runbooks**: `/runbooks/` — CLI walkthroughs AI agents can run directly in terminal
2. Start with `/api/qna.json` for all Q&A content with answers
3. Use `/api/pages.json` for full page index with metadata
4. Individual pages at `/qna/{slug}.html` for detailed answers
5. See `/llms-full.txt` for complete Q&A content inline
## Key Content
**Featured Pages:**
- [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)
- [The Wait is Over: Android 16 beta is Now Available for Genymotion Desktop!](https://rozz.genymotion.com/pages/the-wait-is-over-android-16-beta-is-now-available-for-genymo.html)
- [Genymotion Desktop Pro Plans](https://rozz.genymotion.com/pages/genymotion-desktop-pro-plans.html)
- [Genymotion Desktop Release Notes](https://rozz.genymotion.com/pages/genymotion-desktop-release-notes.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:**
- [Is Genymotion affected by the log4j vulnerability](https://rozz.genymotion.com/pages/is-genymotion-affected-by-the-log4j-vulnerability.html)
- [The device starts, but I can't click anywhere and widgets are greyed out (macOS)](https://rozz.genymotion.com/pages/the-device-starts-but-i-can-t-click-anywhere-and-widgets-are.html)
- [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)
- [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 Burp suite with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-use-burp-suite-with-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.html)
- [I can't sign in to Genymotion Desktop](https://rozz.genymotion.com/pages/i-can-t-sign-in-to-genymotion-desktop.html)
- [Vulnerability Disclosure Policy / Special Thanks](https://rozz.genymotion.com/pages/vulnerability-disclosure-policy-special-thanks.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)
- [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:**
- [Why won't Genymotion connect after installation?](https://rozz.genymotion.com/qna/why-won-t-genymotion-connect-after-installation.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)
- [Is it used to make spam?](https://rozz.genymotion.com/qna/is-it-used-to-make-spam.html)
### Mobile Test Automation
**Pages:**
- [CloudBeat](https://rozz.genymotion.com/pages/cloudbeat.html)
- [Bolt Food Case Study](https://rozz.genymotion.com/pages/bolt-food-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)
- [I'm talking about the test required to publish on Google Play.?](https://rozz.genymotion.com/qna/i-m-talking-about-the-test-required-to-publish-on-google-pla.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)
### CI/CD Automation
**Pages:**
- [Genymotion Desktop and Jenkins integration](https://rozz.genymotion.com/pages/genymotion-desktop-and-jenkins-integration.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:**
- [I will need a huge volume of usage, is it possible to have a discount on AWS?](https://rozz.genymotion.com/pages/i-will-need-a-huge-volume-of-usage-is-it-possible-to-have-a.html)
- [How many devices can I run simultaneously?](https://rozz.genymotion.com/pages/how-many-devices-can-i-run-simultaneously.html)
- [How to use a VPN with Genymotion SaaS](https://rozz.genymotion.com/pages/how-to-use-a-vpn-with-genymotion-saas.html)
- [How to install and use Xposed/EdXposed/LSPosed with Genymotion SaaS?](https://rozz.genymotion.com/pages/how-to-install-and-use-xposed-edxposed-lsposed-with-genymoti.html)
- [SaaS User Guide](https://rozz.genymotion.com/pages/saas-user-guide.html)
- [How to subscribe to a plan for Genymotion SaaS?](https://rozz.genymotion.com/pages/how-to-subscribe-to-a-plan-for-genymotion-saas.html)
- [How to connect Genymotion SaaS virtual devices to ADB?](https://rozz.genymotion.com/pages/how-to-connect-genymotion-saas-virtual-devices-to-adb-2.html)
- [How to run automated tests with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-run-automated-tests-with-genymotion-desktop.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)
- [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)
**Q&As:**
- [What is this site for, with a short and clear answer?](https://rozz.genymotion.com/qna/what-is-this-site-for-with-a-short-and-clear-answer.html)
- [What are the requirements for a private developer to access?](https://rozz.genymotion.com/qna/what-are-the-requirements-for-a-private-developer-to-access.html)
- [What are the top 10 most important features for cloud-based android emulator?](https://rozz.genymotion.com/qna/what-are-the-top-10-most-important-features-for-cloud-based.html)
- [What is the difference between Saas and Desktop platform?](https://rozz.genymotion.com/qna/what-is-the-difference-between-saas-and-desktop-platform.html)
- [What is the maximum number of parallel devices supported by Genymotion?](https://rozz.genymotion.com/qna/what-is-the-maximum-number-of-parallel-devices-supported-by.html)
- [What are 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 does Genymotion prove information on the web?](https://rozz.genymotion.com/qna/how-does-genymotion-prove-information-on-the-web.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)
### Virtual Device Management
**Pages:**
- [Genymotion Shell](https://rozz.genymotion.com/pages/genymotion-shell.html)
- [How to automatically connect a Genymotion Desktop virtual device to ADB](https://rozz.genymotion.com/pages/how-to-automatically-connect-a-genymotion-desktop-virtual-de.html)
- [I have forgotten my Genymotion Desktop account password](https://rozz.genymotion.com/pages/i-have-forgotten-my-genymotion-desktop-account-password.html)
- [Windows - Unable to start the Virtual Device](https://rozz.genymotion.com/pages/windows-unable-to-start-the-virtual-device.html)
- [Limit on concurrent Genymotion virtual devices](https://rozz.genymotion.com/pages/limit-on-concurrent-genymotion-virtual-devices.html)
- [Unable to start the Virtual Device](https://rozz.genymotion.com/pages/unable-to-start-the-virtual-device.html)
- [Desktop User Guide](https://rozz.genymotion.com/pages/desktop-user-guide-2.html)
- [Features and Emulated Sensors](https://rozz.genymotion.com/pages/features-and-emulated-sensors.html)
- [gmsaas User Guide: Commands](https://rozz.genymotion.com/pages/gmsaas-user-guide-commands.html)
- [Device image User Guide](https://rozz.genymotion.com/pages/device-image-user-guide-8.html)
**Q&As:**
- [What are pro widgets?](https://rozz.genymotion.com/qna/what-are-pro-widgets.html)
- [What is this used for?](https://rozz.genymotion.com/qna/what-is-this-used-for.html)
- [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 is this website and what is it for? Does it have a geolocation simulator?](https://rozz.genymotion.com/qna/what-is-this-website-and-what-is-it-for-does-it-have-a-geolo.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)
- [How can I run Genymotion locally?](https://rozz.genymotion.com/qna/how-can-i-run-genymotion-locally.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)
- [Which Genymotion plan includes a rootless device?](https://rozz.genymotion.com/qna/which-genymotion-plan-includes-a-rootless-device.html)
### Hypervisor & VM Setup
**Pages:**
- [Genymotion Desktop is very slow and unstable](https://rozz.genymotion.com/pages/genymotion-desktop-is-very-slow-and-unstable.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)
- [The virtual device crashes, freezes or fails to boot on Windows](https://rozz.genymotion.com/pages/the-virtual-device-crashes-freezes-or-fails-to-boot-on-windo.html)
- [Apple Mac M series support](https://rozz.genymotion.com/pages/apple-mac-m-series-support.html)
- [The VirtualBox DHCP server has not assigned an IP address to the virtual device](https://rozz.genymotion.com/pages/the-virtualbox-dhcp-server-has-not-assigned-an-ip-address-to.html)
- [What are Genymotion Desktop requirements](https://rozz.genymotion.com/pages/what-are-genymotion-desktop-requirements.html)
- [How to disable Hyper-V in Windows](https://rozz.genymotion.com/pages/how-to-disable-hyper-v-in-windows.html)
- [Does Genymotion Desktop support Apple Mac M4 models?](https://rozz.genymotion.com/pages/does-genymotion-desktop-support-apple-mac-m4-models.html)
- [VirtualBox recommended versions](https://rozz.genymotion.com/pages/virtualbox-recommended-versions.html)
**Q&As:**
- [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)
- [How will we download it?](https://rozz.genymotion.com/qna/how-will-we-download-it.html)
### Cloud Marketplace & Pricing
**Pages:**
- [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 will I be charged for Genymotion on Alibaba?](https://rozz.genymotion.com/pages/how-will-i-be-charged-for-genymotion-on-alibaba.html)
- [How to purchase a Genymotion Desktop license](https://rozz.genymotion.com/pages/how-to-purchase-a-genymotion-desktop-license.html)
- [Genymotion Desktop Pro Plans](https://rozz.genymotion.com/pages/genymotion-desktop-pro-plans.html)
- [Contact Us - Genymotion](https://rozz.genymotion.com/pages/contact-us-genymotion.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)
- [Do I need a license if I use Genymotion Desktop for teaching?](https://rozz.genymotion.com/pages/do-i-need-a-license-if-i-use-genymotion-desktop-for-teaching.html)
- [GMTool returns the error code 14](https://rozz.genymotion.com/pages/gmtool-returns-the-error-code-14.html)
- [How to get a license server for Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-get-a-license-server-for-genymotion-desktop.html)
- [Genymotion Offers Survey](https://rozz.genymotion.com/pages/genymotion-offers-survey.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)
### Android Dev Integration
**Pages:**
- [The virtual device display does not rotate](https://rozz.genymotion.com/pages/the-virtual-device-display-does-not-rotate.html)
- [How to install Xposed/EdXposed/LSPosed with Genymotion Device image (PaaS)](https://rozz.genymotion.com/pages/how-to-install-xposed-edxposed-lsposed-with-genymotion-devic.html)
- [How to install Xposed/EdXposed/LSPosed with Genymotion Desktop](https://rozz.genymotion.com/pages/how-to-install-xposed-edxposed-lsposed-with-genymotion-deskt.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 share folders with Genymotion Desktop host machine?](https://rozz.genymotion.com/pages/how-to-share-folders-with-genymotion-desktop-host-machine.html)
- [How to connect 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)
- [Is it possible to un-root or hide root?](https://rozz.genymotion.com/pages/is-it-possible-to-un-root-or-hide-root.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)
- [Get Started with gmsaas](https://rozz.genymotion.com/pages/get-started-with-gmsaas.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)
- [Can I download an SDK from Genymotion and test it?](https://rozz.genymotion.com/qna/can-i-download-an-sdk-from-genymotion-and-test-it.html)
- [How do I install the Android Studio Emulator on macOS?](https://rozz.genymotion.com/qna/how-do-i-install-the-android-studio-emulator-on-macos.html)
### Performance & Compatibility
**Pages:**
- [My webcam does not work with Genymotion Desktop](https://rozz.genymotion.com/pages/my-webcam-does-not-work-with-genymotion-desktop.html)
- [Genymotion Desktop installer doesn't run](https://rozz.genymotion.com/pages/genymotion-desktop-installer-doesn-t-run.html)
- [How to get Genymotion Desktop logs](https://rozz.genymotion.com/pages/how-to-get-genymotion-desktop-logs.html)
- [Device image User Guide](https://rozz.genymotion.com/pages/device-image-user-guide-4.html)
- [I get the error "msvcr100.dll is missing"](https://rozz.genymotion.com/pages/i-get-the-error-msvcr100-dll-is-missing.html)
- [The map is blank on the GPS widget](https://rozz.genymotion.com/pages/the-map-is-blank-on-the-gps-widget.html)
- [The date and time of the device is not correct](https://rozz.genymotion.com/pages/the-date-and-time-of-the-device-is-not-correct.html)
- [I have upgraded macOS Sequoia to 15.2 and Genymotion Desktop has stopped working](https://rozz.genymotion.com/pages/i-have-upgraded-macos-sequoia-to-15-2-and-genymotion-desktop.html)
- [Can I use VirtualBox 7.2 or 7.1 with Genymotion Desktop?](https://rozz.genymotion.com/pages/can-i-use-virtualbox-7-2-or-7-1-with-genymotion-desktop.html)
- [The virtual device display is black](https://rozz.genymotion.com/pages/the-virtual-device-display-is-black.html)
**Q&As:**
- [What are the system requirements?](https://rozz.genymotion.com/qna/what-are-the-system-requirements.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)
- [Is Genymotion good for gaming?](https://rozz.genymotion.com/qna/is-genymotion-good-for-gaming.html)
- [Can I install games on Genymotion?](https://rozz.genymotion.com/qna/can-i-install-games-on-genymotion.html)
- [Is it magical possible?](https://rozz.genymotion.com/qna/is-it-magical-possible.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)
- [Is Genymotion available by phone as usual?](https://rozz.genymotion.com/qna/is-genymotion-available-by-phone-as-usual.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)
- [Does the emulator work with the latest Mac OS?](https://rozz.genymotion.com/qna/does-the-emulator-work-with-the-latest-mac-os.html)
### Licensing & Activation
**Pages:**
- [Is it possible to use Genymotion Desktop offline?](https://rozz.genymotion.com/pages/is-it-possible-to-use-genymotion-desktop-offline.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)
- [How to get Genymotion Desktop free for personal use edition](https://rozz.genymotion.com/pages/how-to-get-genymotion-desktop-free-for-personal-use-edition.html)
- [How to release or re-assign a BUSINESS License?](https://rozz.genymotion.com/pages/how-to-release-or-re-assign-a-business-license.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)
- [How to manage (release, re-assign) my company licences?](https://rozz.genymotion.com/pages/how-to-manage-release-re-assign-my-company-licences.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)
- [I get the error "Server Error (500)" when I try to purchase a license](https://rozz.genymotion.com/pages/i-get-the-error-server-error-500-when-i-try-to-purchase-a-li.html)
**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)
- [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)
- [The main difference between Genymotion standard and free trial is that the free trial version has...?](https://rozz.genymotion.com/qna/the-main-difference-between-genymotion-standard-and-free-tri.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)
- [Are there any restrictions in activating pro plan?](https://rozz.genymotion.com/qna/are-there-any-restrictions-in-activating-pro-plan.html)
### GPU & ARM Support
**Pages:**
- [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)
- [I have a mac and I can't find Android 5.0 to 10.0 in Genymotion Desktop](https://rozz.genymotion.com/pages/i-have-a-mac-and-i-can-t-find-android-5-0-to-10-0-in-genymot.html)
- [Can I use Genymotion Desktop remotely?](https://rozz.genymotion.com/pages/can-i-use-genymotion-desktop-remotely.html)
- [I can't set more than 2048MB of RAM to the device (mac M series)](https://rozz.genymotion.com/pages/i-can-t-set-more-than-2048mb-of-ram-to-the-device-mac-m-seri.html)
**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)
- [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)
- [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)
- [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)
- [Is there a free trial available for the ARM64 SaaS plans?](https://rozz.genymotion.com/qna/is-there-a-free-trial-available-for-the-arm64-saas-plans.html)
- [Were you not planning to move on arm64 for all plans?](https://rozz.genymotion.com/qna/were-you-not-planning-to-move-on-arm64-for-all-plans.html)
### Android Version Selection
**Pages:**
- [Is Android 16 available?](https://rozz.genymotion.com/pages/is-android-16-available.html)
- [Is Genymotion Desktop available for 32-bit?](https://rozz.genymotion.com/pages/is-genymotion-desktop-available-for-32-bit.html)
- [Dynamically change vehicle properties in Android Automotive](https://rozz.genymotion.com/pages/dynamically-change-vehicle-properties-in-android-automotive.html)
- [Is it possible to use a custom ROM?](https://rozz.genymotion.com/pages/is-it-possible-to-use-a-custom-rom.html)
- [Does Genymotion support Android TV?](https://rozz.genymotion.com/pages/does-genymotion-support-android-tv.html)
- [New Genymotion Device Image v13.0](https://rozz.genymotion.com/pages/new-genymotion-device-image-v13-0.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'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)
- [I want to parallel test my application on various OEM and android versions?](https://rozz.genymotion.com/qna/i-want-to-parallel-test-my-application-on-various-oem-and-an.html)
- [Can I run Android 6 on Genymotion?](https://rozz.genymotion.com/qna/can-i-run-android-6-on-genymotion.html)
### CLI & Shell Tooling
**Pages:**
- [How to get logs and logcats with Genymotion SaaS](https://rozz.genymotion.com/pages/how-to-get-logs-and-logcats-with-genymotion-saas.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 automate widgets with Genymotion Desktop?](https://rozz.genymotion.com/pages/how-to-automate-widgets-with-genymotion-desktop.html)
- [gmsaas](https://rozz.genymotion.com/pages/gmsaas.html)
- [gmsaas 1.10.0](https://rozz.genymotion.com/pages/gmsaas-1-10-0.html)
- [Genymotion Desktop 3.0.1 (February 26th, 2019)](https://rozz.genymotion.com/pages/genymotion-desktop-3-0-1-february-26th-2019.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)
- [Ubuntu@begin-docker-test:~/Android$ gmsaas instances adbconnect --adb-serial-port 40100 "$INSTANC...?](https://rozz.genymotion.com/qna/ubuntu-begin-docker-test-android-gmsaas-instances-adbconnect.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 have forgotten my Genymotion SaaS (Cloud) account password](https://rozz.genymotion.com/pages/i-have-forgotten-my-genymotion-saas-cloud-account-password.html)
- [Genymotion HTTP API](https://rozz.genymotion.com/pages/genymotion-http-api.html)
- [Reset Password](https://rozz.genymotion.com/pages/reset-password.html)
- [I can't log in to Genymotion Desktop: "Too many failed attempts, please try a...](https://rozz.genymotion.com/pages/i-can-t-log-in-to-genymotion-desktop-too-many-failed-attempt.html)
- [How to delete my Genymotion Desktop account?](https://rozz.genymotion.com/pages/how-to-delete-my-genymotion-desktop-account.html)
- [I have forgotten my Genymotion Desktop account username](https://rozz.genymotion.com/pages/i-have-forgotten-my-genymotion-desktop-account-username.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)
- [I cannot create content that promotes hate speech. Is there anything?](https://rozz.genymotion.com/qna/i-cannot-create-content-that-promotes-hate-speech-is-there-a.html)
- [Does the free version require an account?](https://rozz.genymotion.com/qna/does-the-free-version-require-an-account.html)
### Network Tunneling & Proxy
**Pages:**
- [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)
- [How to use a VPN with Genymotion Device image (PaaS)](https://rozz.genymotion.com/pages/how-to-use-a-vpn-with-genymotion-device-image-paas.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) - 541 indexed pages
- [Q&A API](https://rozz.genymotion.com/api/qna.json) - 262 questions answered
- [Topics API](https://rozz.genymotion.com/api/topics.json) - Topic taxonomy
---
**Content Statistics:**
- Total Pages: 541
- Total Q&As: 262
- Topics Covered: 15
- Last Updated: 2026-04-24
- Update Frequency: Weekly
*This file is auto-generated. For questions, contact contact@genymobile.com*Document
llms-full.txt
Not stored for this site.