Desktop User Guide

Get Started

Basic steps

To start using Genymotion Desktop and run your Android application in a virtual device, follow the steps below.

First run

• To start Genymotion Desktop, launch the application on your operating system.
• On Windows, click Genymotion from the Windows Application menu or desktop.
• On macOS, click Genymotion from the Applications directory.
• On Linux, click Genymotion from your distribution Application Launcher, or run in a terminal: $ ~/genymotion/genymotion
• If Genymotion is installed in a specific directory, replace ~/genymotion/ with your Genymotion installation path.
• If Genymotion is installed globally (with sudo), replace ~/genymotion/ with /opt/.
• After starting, the first start window appears.
• If you already have a Genymotion account, enter your credentials and click NEXT.
• If you do not have an account, click CREATE ACCOUNT to create a new Genymotion account.
• If your host machine is connected to a proxy, click View proxy options to set the proxy type, hostname, port, and authentication.
• In the Usage panel, select one of the following options:
• I have a license: to use Genymotion Desktop Pro with full features and technical assistance. A paid license is required.
• Personal use: to use Genymotion Desktop free edition. For Personal Use ONLY.
• Read the Terms & Conditions carefully and check I understand and agree to the Terms & Conditions.
• Click NEXT.
• The Genymotion Launcher Dashboard is shown.

Change Hypervisor (not recommended)

• Virtual devices created with VirtualBox will not appear in the Genymotion dashboard if the hypervisor is switched to QEMU, and vice versa.
• The default and recommended hypervisor for Linux and macOS is QEMU.
• It is possible to switch between VirtualBox or QEMU hypervisor:
• Go to Settings > Hypervisor.
• Select QEMU or VirtualBox from the drop-down box.
• If you change from the default, you will be prompted to restart Genymotion to apply the change.
• For more information, refer to Genymotion configuration.

Create a new device

• Click CREATE and select a virtual device template from the list.
• Use the box and Filters to find a specific device profile.
• Click NEXT or double-click the template of your choice. The virtual device installation wizard opens.
• In the GENERAL tab, you can change the name and select the Android version of the device.
• Click NEXT when done.
• If you upgraded from a previous version, you can click to force an update of the available Android images.
• If you use a non-rooted Android image, you can enable root from here.
• In the SYSTEM tab, you can change the number of processors, RAM, and/or VM Heap size.
• Click NEXT to proceed.
• In the DISPLAY tab, you can select the resolution, the window style, and the OpenGL ES maximum API version.
• Click NEXT to proceed.
• In the Android options tab, you can enable or disable the Android navigation bar (default: enabled) and the virtual keyboard (default: disabled).
• Click NEXT to proceed.
• In the Hypervisor options tab, you can toggle the QEMU quick boot feature.
• Click INSTALL to start the device deployment.
• In the Hypervisor options tab, you can set NAT (default) or Bridge hypervisor network mode.
• Click INSTALL to start the device deployment.
• Your virtual device is being downloaded and will appear in the dashboard: Genymotion Dashboard - Devices.
• If the virtual device deployment fails at this point, you may be running out of free space.

Launch a device

• Double-click on your newly created virtual device, or click the start control to begin it.
• The Virtual Device display appears.
• If you wish to change Genymotion or the device configuration, refer to the Genymotion configuration and controls pages, or the Virtual Devices configuration and controls pages.

---

Note: The above content reflects the "Basic Steps" guide for Genymotion Desktop, focusing on getting started, switching hypervisors, creating devices, and launching them. Images referenced in the original page are not included here.