Skip to content

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.

    Click Genymotion icon from your application menu or desktop.

    Click Genymotion icon from the Applications directory.

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



    Replace {Genymotion_install_path} by your Genymotion install path.

    The main window opens:

    Genymotion main window

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

  3. Click on Add a device and select a virtual device template from the list. You can use the search box and Filters to find a specific device model: Virtual device isntallation
  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: Install virtual device window

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


    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:

    Virtual device main window

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: Custom devices The device setup window opens: Install virtual device window
  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:

Custom device

Install applications

Please refer to Deploy an Application

Back to top