Basic steps

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

First run

1. Launch Genymotion Desktop:

   WindowsmacOSLinux

   Click from Windows Application menu or desktop.

   Click from the Applications directory.

   Click Genymotion from your distribution Application Launcher, or in a terminal:

   $ ~/genymotion/genymotion
   

   Note

   If you installed Genymotion in a specific directory, replace ~/genymotion/ by your Genymotion installation path; or, if you installed it globally (with sudo), replace ~/genymotion/ by /opt/.

   The main window opens:

   

2. If you already have a Genymotion account, enter your credentials and click NEXT. Otherwise, click on CREATE ACCOUNT to create a new Genymotion account.

   Proxy

   If you are using Genymotion Desktop behind a proxy, click View proxy options and set your Proxy type, hostname, port and authentication.

3. In the Usage panel, select:

   • Personal use if you wish to use Genymotion Desktop free edition for personal use only.
   • I have a license if your are using Genymotion Desktop for business. You must own a license in that case.

   

4. Read the End User License Agreement carefully and check I have read and accept the end user license agreement. Click NEXT:

   

Genymotion Desktop main window opens:

Select a hypervisor

3.3.0

From Genymotion Desktop 3.3.0 onwards, it is possible to choose between VirtualBox or QEMU hypervisor.

Note

If you upgraded from a previous Genymotion Desktop version, the default hypervisor will be VirtualBox. Otherwise, it is QEMU.

1. Go to Genymotion > Settings > Hypervisor

   

2. Select QEMU or VirtualBox from the drop-down box.

If you change from the default, you will be prompted to restart Genymotion to apply that change. For more information, please refer to Genymotion configuration.

Info

Each created virtual device depends on the hypervisor. For example, Virtual devices created with VirtualBox will disappear from Genymotion dashboard if the hypervisor is switched to QEMU, and vice versa.

Create a new device

1. Click on and select a virtual device template from the list. You can use the search box and Filters to find a specific device profile:

   

2. Click on NEXT or double-click on the template of your choice. The virtual device installation wizard opens:

   

3. In the GENERAL tab, you can change the name and select the Android version of the device. Click NEXT when done.

4. In the SYSTEM tab, you can change the number of processors, RAM and/or VM Heap size:

   Note

   If you cannot add a virtual device at this step, you may be running out of free space. We recommend you check the free remaining space on your hard disk.

   Click NEXT when done.

5. In the DISPLAY tab, you can select the resolution, style and the OpenGL ES maximum API version:

   

   Click NEXT when done.

6. In the Android options tab, you can enable or disable the Android navigation bar (default: enabled) and the virtual keyboard (default: disabled):

   

   Click INSTALL when done.

VirtualBox - Hypervisor options

If you selected VirtualBox hypervisor, there will be an extra Hypervisor options tab. There, you can set the NAT (default) or Bridge hypervisor network mode:

Click INSTALL when done.

Your virtual device is being downloaded and will appear in the My installed devices section:

Note

If you cannot add a virtual device at this step, you may be running out of free space. We recommend you check the free remaining space on your hard disk.

Launch a device

Double click on your newly created virtual device, or click , to start it:

Learn more

• Genymotion configuration and controls
• Virtual Devices configuration and controls
• Emulated sensors and features
• Install applications