You are here: Get Started > Basic steps

Basic steps

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

  1. Start Genymotion 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 Genymotion main window opens:
  2. When the following window pops up, click Yes:
    "Add a virtual device" popup
    The Select a new virtual device window opens:
    "Select a new virtual device" window
  3. Click Sign in.
    The Credentials window opens:
    "Credentials" window
  4. Fill in the fields with your username and password and click Sign in.
    The Available virtual devices list appears:
    "Available virtual devices" list
  5. Select a virtual device from the list and click Next.

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

    The Create a new virtual device window opens:
    "Create a new virtual device" window

  6. Enter a name for your new virtual device and click Next.
    Your virtual device is being downloaded and deployed:
    Deployment window
  7. Click Finish to close the deployment window.
    Your virtual device appears in the Genymotion main window:
    Genymotion main window
  8. Click "Start" button to start your newly created virtual device.
    The virtual device window opens:
    Virtual device main window
  9. Deploy your Android application in either of the following ways:
    • Drag and drop the application APK file into the virtual device window.
    • Run the following command: adb install <application name>.apk.
    • Download and install the application directly from the virtual device using a web link.

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