# Basic steps

# First run

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

  1. Start Genymotion Desktop in one of the following ways depending on your operating system:

    • Windows: Click Genymotion icon from your application menu.
    • macOS: Click Genymotion icon from the Applications directory.
    • Linux: Run <Genymotion installer path>/genymotion.

    The main window opens:

    Genymotion main window

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

  3. Select a virtual device from the Available template list and double click on it or click on virtual device options and select Install.


    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.

    The Install virtual device window opens:
    Install virtual device window

  4. Enter a name and/or adjust the settings for your new virtual device and click Next.
    Your virtual device is being downloaded and will appear in My installed device :
    Deployment window

  5. Double click on your newly created virtual device or click on virtual device options 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 section Virtual Devices

# Custom virtual devices

If the virtual device you need to deploy is not listed in the available virtual devices list, you can create your own custom virtual device:

  1. From the Genymotion Desktop main window, scroll down to the bottom and click ADD CUSTOM DEVICE:
    Add custom device
  2. Thu custom device setup window opens:
    Add custom device setup
  3. Set a name for the device
  4. Choose a predefined or custom display resolution that matches the device you wish to emulate
  5. Set your System settings (Android version, number of CPU and RAM size) to match those of the device you wish to emulate.
  6. Adjust the other options to your liking and needs
  7. Click on INSTALL and wait for the virtual device to be deployed

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