Basic steps

First start

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

1. Launch Genymotion Desktop.

   WindowsmacOSLinux

   Click from your application menu or desktop.

   Click  from the Applications directory.

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

   {Genymotion_install_path}/genymotion
   

   Note

   Replace {Genymotion_install_path} by your Genymotion install path.

   The main window opens:

   

2. Enter your account credentials and click NEXT or click on CREATE ACCOUNT to create a new Genymotion account.

3. Click on and select a virtual device template from the list. You can use the search box and Filters to find a specific device model:
4. Click on NEXT or double-click on the template of your choice.

5. Enter a name and adjust the settings, if necessary, for your new virtual device and click INSTALL:

   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.

6. Double click on your newly created virtual device or click on and select Start to start it. The virtual device window opens:

   

For more information about sensor and feature emulation as well as interaction with a virtual device, please refer to Virtual Devices and Emulated sensors and features.

Custom virtual devices

If you can't find a template for the device you wish to emulate, you can create your own custom virtual device:

1. When adding a new device, select either the Custom Phone or Custom Tablet from the list: The device setup window opens:
2. Set a name for the device.
3. Choose a predefined or custom display resolution that matches the device you wish to emulate.
4. Set your System settings (Android version, number of CPU and RAM size) to match those of the device you wish to emulate.
5. Adjust the other options to your liking and needs.
6. Click on INSTALL and wait for the virtual device to be deployed.

Your newly created device should appear in the My installed devices section:

Install applications

Please refer to Deploy an Application