Go to preview program

 

User Guide

Genymotion is a complete set of tools that provides a virtual environment for Android. It can be very useful for developers, testers, salesman or even gamers.

It is available for most operating systems: Windows, Linux and Mac OS X. It is as simple to install as powerful to use:
Follow the simple install process, choose one of our Android virtual devices, start it, and enjoy it!

Android as its best

  • OpenGL acceleration to achieve the best 3D performance
  • Enable full screen option and improve your experience
  • Be precise in your UI development with the "pixel perfect" functionality

Fully controllable

  • Start multiple virtual device at the same time
  • Manage sensors:
    • Battery level / status
    • GPS
    • Rotation
    • Camera
  • Override virtual device identifiers
  • Directly command virtual devices sensors with Genymotion Shell
  • Fully compatible with ADB. You can control your virtual device from the host

Manage your devices

  • Easy to install
  • Compatible with Microsoft Windows 32/64 bits, Mac OSX 10.6+ and Linux 32/64 bits
  • Configure virtual devices:
    • Screen resolution
    • Memory quantity
    • CPU unit quantity
  • Download and deploy easily the latest Genymotion virtual device

Start your virtual devices from Eclipse

  • Test your applications with Genymotion

Operating System requirements

You need one of the following system:

  • Microsoft Windows XP SP3 (32 or 64 bits)
  • Microsoft Windows Vista (32 or 64 bits)
  • Microsoft Windows 7 (32 or 64 bits)
  • Microsoft Windows 8 / 8.1 (32 or 64 bits)
  • Linux Ubuntu 12.04 (32 or 64 bits)
  • Linux Ubuntu 12.10 (32 or 64 bits)
  • Linux Debian Wheezy (64 bits)
  • Mac OS X 10.6

System requirements

  • OpenGL 2.0 capable graphic card, with an up-to-date driver
  • VT-x or AMD-V capable CPU, enabled in BIOS settings
  • At least 2GB of RAM memory
  • At least 100MB of free space on Hard Drive for Genymotion installation

    A minimum of 2GB of free space is required to deploy each Genymotion virtual devices. They might need more than 8GB depending on your usage of the virtual devices and the applications you have installed.

  • Internet connection (installation and updates)
  • Screen resolution greater than 1024 x 768 pixels

Application requirements

  • Oracle VirtualBox >= 4.2.12 (greater is better)

Genymotion Cloud requirements

  • Internet Explorer >= 9 (greater is better)
  • Mozilla Firefox >= 3.0
  • Google Chrome >= 2.0
  • Safari >= 4.0

Register

  1. Go to Genymotion register page
  2. In the signup form, fill the fields with your personal informations
  3. Click the "SIGN UP" button
  4. You will receive a validation E-mail. Click on the validation link to finish
  5. You will receive another E-mail, indicating that your registration is now complete

Download and Install Oracle VirtualBox

If you don't already have VirtualBox installed, read the following section.

  • Windows

    The easiest way to install VirtualBox is to download the Genymotion package that contains VirtualBox installer here

  • Mac OS X

    Go to VirtualBox download page and get the Mac OS X .dmg file. Open the .dmg file and follow the installation steps. When finished, reboot.

  • Linux

    Check your repositories: almost every GNU/Linux have a package installer for VirtualBox. If not, or if you need to install a specific version, go to VirtualBox download page

Download Genymotion

  1. Go to official Genymotion download page
  2. Select the package corresponding to your system and download it

Install Genymotion

Depending of your system, follow the install process:

  • Windows
    1. Double click on .msi installer
    2. Choose the installer language (the Genymotion language depends of your system language) and click the "Next" button
    3. Click the "Next" button again
    4. Change the path if needed (the default path is C:\Program Files\Genymobile\Genymotion) then click the "Next" button
    5. Click the "Next" button again
    6. Choose whether or not to create desktop icon. Then click "Next" button
    7. Click the "Install" button
    8. Click the "Finish" button
  • Mac OS X
    1. Open the .dmg installer
    2. Move Genymotion and Genymotion Shell to application directory
  • Linux
    1. In a terminal, run the following commands:
      chmod +x [DOWNLOAD_PATH]/genymotion-[VERSION]_[ARCH].bin
      cd [DOWNLOAD_PATH]
      ./genymotion-[VERSION]_[ARCH].bin -d [YOUR_INSTALL_PATH]
    2. Run Genymotion:
      cd [YOUR_INSTALL_PATH]
      ./genymotion
  1. Run Genymotion
    • Windows

      Click the icon on your desktop

    • MacOS

      Click the icon from the Application directory

    • Linux

      Launch [InstallationPath]/genymotion

  2. The main window appears.

    Genymotion main window

  3. And immediately, a pop-up appears and invites you to add your first virtual device.

    Genymotion main window add device

  4. Click the "Yes" button.

    The creation window appears.

    Genymotion not connected

  5. Click the "Connect" button.

    Fill the authentication window with your Genymotion Cloud username/email address and password, then click the "Connect" button.

    Genymotion connection
  6. Once connected, you will see all the available virtual devices.

    Select a virtual device (Nexus 7 - 4.3, for example) in the list and click the "Next" button.

    Genymotion connection
  7. Choose a new name for your virtual device and click the "Next" button.

    Genymotion new resume

  8. Your virtual device will now be downloaded and deployed.

    Genymotion finished download

  9. Click the "Finish" button to close the deployment window.

    Genymotion deployment

  10. Click the "Play" button to start your newly created virtual device.

    Genymotion deployment

  11. Enjoy.

    Genymotion main window

Genymotion licensing system

For more informations about Genymotion software usage, please visit the following page: Usage disclaimer

Licenses differences and contents

For more details about the content of each licenses and differences among licenses, please visit the following page: Licenses details

License installation

To install a license into Genymotion and use the related features (Remote Control widget, Screencast widget, ...), follow these steps:

  • Run Genymotion
  • Open the 'About' windowGenymotion main window
  • Copy and paste your license key in the dedicated text field
  • Press the 'Register' button
  • If you're not already logged, a window will open and allow you to enter your credentials
  • License information are sent to the Genymotion Cloud to check their validity

If your license is valid, your software will be fully unlocked and all corresponding features will be available.

If you have any problem registering your license, please, contact us using the support page

Software activation

To check your license validity and ensure nobody else is using it, you’ll have to connect periodically to the Genymotion Cloud with Genymotion.

If you don't connect for several days, then your Genymotion software will switch back to free mode.

When your license is about to expire, the Genymotion software will notify you and ask you to connect to Genymotion Cloud.

Manage window

The main Genymotion window lets you manage your virtual Genymotion devices:

Genymotion main window

In the menu bar, you can:

  • Launch the selected virtual device, using the "Play" button
  • Create a new virtual device, using the "Add" button
  • Open the application settings, using the "Settings" button
  • Open the information window, using the "About" button
  • Open the documentation, using the "Help" button
You can also use the dedicated button or the context menu on each virtual device to:
  • Configure virtual machine settings (resolution, DPI, Android navigation bar, ...)
  • Remove a virtual device

Virtual device creation window

When clicking the "Add" button of the main window, it will open the virtual device creation window:

Add a new virtual device

From this window, you can choose and create virtual device from the ones available online, or locally.

If you don't see any virtual device in the list, click the "Connect" button at the bottom of the list.

Genymotion Cloud connection window

When clicking the "Connect" button, you will be prompt for your Genymotion Cloud credentials:

genymotion-main-window.png

Application settings

General tab

genymotion-settings-general.png

The general tab contains basic settings.

  • Automatically checks for software update: enable update process at start.
  • Authorize send of software statistic for the purpose of improve it: allow Genymotion to send anonymous usage statistics. This really helps us understanding how the product is used to improve it.
  • Notify me when my license is about to expire: enable license notifications. Genymotion will inform you before your license expiration.
  • Notify me when my activation is about to expire: enable activation notifications. Genymotion will inform when you will need to renew your software activation. You must connect to the Genymotion Cloud to refresh your software activation.
  • Remember my Genymotion Cloud credentials: enable quick connections. You have to set your username and password in the corresponding fields. Note that password will not be stored in plain text but in an encrypted form.

Network tab

genymotion-settings-network.png

Change the network settings to fit your Internet access.

  • Use HTTP Proxy: tell Genymotion to use a proxy to connect to Genymotion Cloud. You have to set your proxy address and port in the corresponding fields. Only HTTP proxy works. NTLM or Socks proxy won’t.
  • Use authentication: enable proxy authentication. You must enter your username and password in the corresponding fields.

VirtualBox tab

genymotion-settings-virtualbox.png

Configure virtual devices storage path.

  • Virtual device path: set where to store Genymotion virtual devices. It must be an absolute path.

ADB tab

genymotion-settings-adb.png

Configure Genymotion to use ADB

By default, Genymotion use its own ADB utility. But it is possible to use your own ADB configuration (from Android SDK).

  • Use Genymotion tools (default): work with ADB tool provided with Genymotion.
  • Use custom Android tools: set the storage path of an installed Android SDK, to use tools provided by this SDK. For more information on how to install your own Android SDK, follow this tutorial.

Misc tab

genymotion-settings-misc.png

Set various options.

  • Capture location: you can modify the storage path for screenshots and video.
  • Cache usage: to save space on your workstation, you can remove temporary downloaded files and logs with Clear cache button.

Virtual device management

Genymotion virtual device list

From the virtual devices list, you can:

  • Genymotion settings button Configure: Modify selected virtual device settings.
  • Genymotion clone button Clone: Copy this virtual device to a new one.
  • Genymotion reset button Factory Reset: Restore selected virtual device to its initial state.
  • Genymotion trash button Delete: Delete selected virtual device.

Virtual device settings

Genymotion virtual device settings

In this window, you can configure virtual device settings such as its screen size, density, navigation bar, ...

  • Predefined screen size: set screen size and density from a predefined list.
  • Custom screen size: set a custom screen size and density. Warning, you may experience issues when using custom density and screen size values.
  • Run virtual device in full screen mode: if checked, the virtual device will start in fullscreen mode and its screen size will be adjusted to your screen size.
  • Show Android navigation bar: if checked, the virtual device will start with Android navigation bar enabled (with 3 Android buttons: Back, Home and Recent applications)
  • Use virtual keyboard for text input: if checked, the virtual device will use either the virtual keyboard or your computer keyboard when focusing on an input area. If not checked, then your computer keyboard will be used.

Virtual device factory reset

When you deploy a new virtual device, at the end of the deployment, a snapshot is created. At any time you can restore your virtual device to its initial state just by using the "Factory Reset" button.

Warning: All installed applications, system patches, modified settings and data will be lost.

Virtual device starting

When you run a virtual device from the main window of Genymotion, there are three steps:

  1. Set network parameters and rendering parameters.
  2. Check if CPU virtualization (VT-X on Intel processors and AMD-V on AMD processors) is enabled. If not, then your virtual device doesn't support the management of several processors. In this case, the number of processors will be set to 1 automatically.
  3. Check if the Genymotion version of your virtual device is compatible with the Genymotion version software.

If all these steps passed with success then your Genymotion virtual device is ready to use.

Virtual device update

If Genymotion is up-to-date but a new version of virtual devices has been released, we recommend that you update some or all of your virtual devices.

When starting a virtual device, a popup window indicates that a newer version is available. Click Update.

Genymotion virtual device update popup

During the update process, the wizard introduces some of the new features.

Genymotion virtual device update popup

Note that when you upgrade a virtual device, the following items will not be lost:

  • User settings in Android
  • System packages that you have deployed via drag'n drop
  • Applications that you have installed, and their data

Virtual device execution

Genymotion Player ready

This is the window where the virtual device is running and where you can interact with it

  • Genymotion widget buttons
    • Genymotion widget Battery button (CTRL + 1)
    • Genymotion widget GPS button (CTRL + 2)
    • Genymotion widget Camera button (CTRL + 3)
    • Genymotion widget Screencast button (CTRL + 4)
    • Genymotion widget Remote Control button (CTRL + 5)
    • Genymotion widget Identifier button (CTRL + 6)
  • Genymotion Screencast buttons
    • Take a screenshot (CTRL + SHIFT + S)
    • Record a video (CTRL + SHIFT + V)
    • Browse recorded media files (CTRL + SHIFT + E)
  • Control buttons
    • Virtual device rotation button (CTRL + F11)
    • Pixel perfect button (CTRL + R)
    • Volume up button (CTRL + +)
    • Volume down button (CTRL + -)
    • Back button (CTRL + BACKSPACE)
    • Recent applications button(CTRL + SPACE)
    • Menu button (CTRL + M)
    • Home button (CTRL + HOME)
    • Power button (CTRL + ESCAP)

Multi-touch Gestures

Because in most cases, virtual devices are controlled with mouse and keyboard, some shortcuts have been implemented to help simulate common gestures:

  • Right click + Move mouse to the Left: Zoom In
  • Right click + Move mouse to the Right: Zoom Out
  • Right click + Move mouse Up: Tilt Forth
  • Right click + Move mouse Down: Tilt Back
  • SHIFT + Right click + Move mouse to the Left: Counterclockwise Rotation
  • SHIFT + Right click + Move mouse to the Right: Clockwise Rotation

Note: on Apple OS X, you can replace Right click by using CTRL + click

Drag & drop

Genymotion virtual devices support files drag&drop from computer to the device. Behaviour is different depending on the file type:

  • Regular files: regulars files will be pushed to /sdcard/Download.

    They can be accessed by the the file explorer provided into the virtual device.

  • Android applications: APK will be installed on the virtual device.

    If the same application already exists with another signature, you will have the choice to override the existing application.

  • Flashable archives: zip archives detected as flashable (containing a /system folder) will be flash on the device.

    Such archives may damage your Genymotion virtual device. It is recommended to reboot your virtual device after flashing an archive.

Note: drag&drop requires ADB configured to work. Click here to learn how to configure ADB with Genymotion.

Copy/past

The clipboard is shared between your computer and Genymotion. Thus, you can easily copy and paste text from your computer to Genymotion, and reciprocally.

Pixel perfect!

If you want to be precise in your UI development, you can use the "pixel perfect" button.

  • One click on the button will enable pixel-perfect mode. Each pixel of the device will be displayed using only one pixel of your monitor, allowing you to ensure every pixel of your application is really as it should be.
  • Another click will exit the pixel-perfect mode.

Note: if the device screen size is bigger than your monitor size, Genymotion window will be maximized and you will be able to use scrollbars to move into the device screen.

Battery widget

Genymotion battery widget

The battery widget allows modifications of the battery level, power status and power mode of the Genymotion virtual device.

First, open the widget using the corresponding panel button

  • Activate the simulated battery mode

    By default, the Genymotion virtual device simulates the same battery as the one present in your computer. This button activate the simulation of a battery with custom values that you can adjust to test your application.

    When your computer does not have a battery (desktop computer for example), the simulated is automatically activated.

  • Modify the battery power level

    When the simulated battery is activated, you can specify the Genymotion current battery level using the slider or by entering manually the value in the corresponding field.

  • Modify the status

    When the simulated battery is activated, you can also modify the current status of the battery with the corresponding button:

    • Charging: the AC is plugged in and the battery is currently in charging state
    • Discharging: the AC is unplugged and the battery is currently in discharging state

GPS widget

Genymotion GPS widget

The GPS widget allows *real time* activation and modifications of the position,accuracy and orientation.

  • Activate the GPS

    When you activate the GPS with the corresponding button, you enable the reception of generated GPS frames in the Genymotion virtual device. When it is not activated, the GPS is not able to refresh the position, and the last known location is used.

  • Modify position

    Using the latitude and longitude field, you can specify the current position you want to simulated. They must be specified in degrees: the latitude from -90.0° to 90.0°, and the longitude from -180 to 180°

  • Modify the altitude

    You can specify a custom altitude from -10000 m to 10000 m

  • Modify accuracy

    You can specify a custom accuracy value using the slider or by entering the desired value from 0 to 200 m.

  • Modify bearing

    You can modify the bearing using the corresponding dial, or by entering the desired value form 0 to 359,99°

    Note than many applications do not rely on the GPS orientation, but use the device accelerometer or gyroscope to determine the bearing of the device, which are not yet supported.

Camera widget

Genymotion Camera widget

The Camera widget allows you to send a video stream to the Android system from a Genymotion virtual device.

With this feature you can test your Android application that requires the use of Android device builtin camera (eg, the development of an application such as a camera or video editing application type, ...).

The video stream can come from a dummy camera or a real physical webcam connected (or integrated) in your workstation. So you can send a real-time streaming.

  • Activate the Camera widget

    When you activate the widget with the corresponding button, the Genymotion software tries to detect the available webcam on your workstation.

  • Front and rear cameras:
    • Front camera allows to send data to the Android front camera
    • Back camera allows to send data to the Android back camera
    For the front camera or for the back camera or for both, you can choose the source of data :
    • Dummy webcam: data are images generated by the widget
    • Physical (real) webcam: data are images sent by the selected webcam
  • Preview:

    The preview allows you to see the video stream which will be sent to the Android system, as the front or as the back camera.
    With this preview, you know if webcam is operational.

Screencast widget

Genymotion screencast widget

The Screencast widget allows you to take a screenshot or to record a video (with sound capture) of virtual devices.
It is very convenient to broadcast images or videos of your applications on web sites (Youtube, Google Play, ...).

All screenshots and recordings are stored in your home directory, in a folder named with your virtual device name. You can change this default folder in the configuration panel.

  • Screenshot button Genymotion screenshot button

    When you press this button, a screenshot of your virtual device is stored in configured folder.
    The shortcut for this action is CTRL-SHIFT-S.

  • Video button Genymotion video button

    When you press this button, a video of your virtual device starts recording. Press this button again to stop recording.
    If your virtual device emits sound then it will be captured with the video.
    The shortcut for this action is CTRL-SHIFT-V.

  • Browse button Genymotion browse button

    When you press this button, a file explorer opens to allow you to directly access your screenshots and recorded videos.
    The shortcut for this action is CTRL-SHIFT-E.

Note: All screencast features are accessible via shortcuts even if Screencast widget is not displayed.

Remote control widget

Genymotion remote control widget screenshot

The remote control widget allows you to take control of Genymotion virtual devices with your real device (any phone or tablet running API 8/Froyo or greater). This widget works with a specific Android application that runs on your device and forwards touch inputs and accelerometer values to Genymotion.
As a result, you will be able to test the behavior of your application as if it was running in your hands.

  • Activate the Remote control widget

    When activating the widget with the corresponding button, Genymotion tries to detect any connected Android devices.

  • Select the device and start

    Select your device in the list box, then click the "Start" button. If the device is connected to ADB and not visible in the list, then restart the widget.

  • Enable options
    You can toggle the desired options:
    • Display preview.
      Allows you to preview your Genymotion screen on your physical device.
    • Touch input.
      Allows your physical device to send touch events to Genymotion.
    • Accelerometer.
      Allows your physical device to send accelerometer events to Genymotion
Remarks:
  • You must install ADB to use this feature.
  • The widget automatically stops if you disconnect your device without stopping the widget; you can resume the remote control widget reconnecting the device to ADB and clicking the "Start" button.
  • Errors will appear between the select box and the options. Moving the mouse on the error will display the details.

Identifier widget

Genymotion Identifier widget screenshot

Genymotion identifier widget shows Device ID and Android ID numbers. You can see and edit these values at runtime, without having to reboot your virtual device.

Android ID

An Android ID is a 64-bit number (as a 16 hex digits string) that is randomly generated when the user first sets up the device and should remain constant for the whole lifetime of user's device.

Android 4.2.2 and newer versions support multiple user accounts, each one having a unique Android ID.

Button Android ID randomize button on the right of input text box generates a random identifier for you.

Valid characters for setting Android ID are:

  • 16 hexadecimal digits long (mandatory).

Note: it is NOT allowed to set an empty Android ID.

Device ID / IMEI / MEID

By default, a new virtual device is deployed with a default Device ID of 00 000000 000000 0.
Button Android ID randomize button on the right of input text box generates a random identifier for you. As IMEI or MEID number are used as Device ID, Genymotion will generate valid numbers, according to GSM 02.16 standard and 3GPP2 specification (14 digits or hex-digits + a checksum digit).

Valid characters for setting Device ID / IMEI / MEID are:

  • dot (.)
  • letters (a-z, A-Z)
  • digits (0-9)
  • dash (-) and underscore (_)

Note that it is allowed to set an empty Device ID.

One of the most interesting feature of Genymotion is that you can test your application developed with Eclipse IDE. It uses ADB to connect to any active Genymotion virtual devices and then push your application.

Plugin installation

There are two ways to install the plugin:

  1. Update Site method
    • Start Eclipse
    • Go to the "Help/Install New Software..." menu
    • In the new opened window, click the "Add..." button (on top right of the window)
    • Fill the fields with these items and then validate:
      • Name: Genymobile
      • Location: http://plugins.genymotion.com/eclipse
    • You should see a tree with Genymobile < Genymotion names
    • Check those entries and then, click "Next"
    • Read and Accept the license
    • Eclipse will warn you that the plugin is not signed, accept it even though
    • To finish the installation, restart Eclipse
    • After Eclipse's restart, you will see a new button on the toolbar: Plugin button
    • Finally, you can check install: Go to "Help/About" menu, click the "Installation Details" button. In the "Plugin" column Genymotion should appear
  2. Manual method
    • Ensure Eclipse is closed
    • Download the plugin on Genymotion official download page
    • Depending of you system, follow the steps:
      • Windows
        • If you have administrator rights, put the jar archive in plugins directory of your Eclipse install
        • Without administrator rights, put the jar archive in plugins directory of your Local Settings\Eclipse
      • Mac OS X
        • With administrator rights, put the jar archive in plugins directory of your Eclipse install
      • Linux
        • If you have administrator rights, put the jar archive in plugins directory of your Eclipse install
        • Without administrator rights, put the jar archive in plugins directory of your /home/[user]/Eclipse

Plugin usage

Click the Plugin button in Eclipse toolbar to open the plugin

First start

  1. You will need to set path to Genymotion installation directory (given default path only works for standard's Genymotion installation): Genymotion settings
    • Windows: C:\Program Files\Genymobile\Genymotion
    • Mac OS X: /Applications/Genymotion.app
    • Linux: /home/[user]/genymotion
  2. Click the "Apply" button and then "OK"
  3. Click again the Plugin button to prompt the main plugin window
    Genymotion device list

Actions

In the plugin main window, you can do the following steps:

  1. Start a Genymotion virtual device
  2. Create a new Genymotion virtual device
  3. Refresh the list of Genymotion virtual device

"Create" action will automatically start the Genymotion creation wizard

virtual device states

In the "status" column of the main window can take the following status:

  • Off: The virtual device is in Off state
  • Paused: The virtual device has been started, and then paused : restart action will get back at exactly same state
  • On: The virtual device is on, but not connected to ADB. It means that you cannot choose this virtual device in the "Android Device Chooser" window of ADT plug-in

Use Genymotion to run Android application

  1. First, click the Plugin button and start the virtual device you want to use.
  2. Close the Genymotion main window
  3. In your application project, right click and chose "Run as Android application"
  4. The "Android Devices Chooser" opens
  5. Click on the Genymotion virtual device you started/created
    Genymotion-VMNAME-@IP:PORT
    Where:
    • VMNAME is the virtual device name, as define in Genymotion
    • @IP:PORT are the device address and port (assigned by ADB)

    After a reboot or an unexpected halt of a Genymotion virtual device, its displayed name in the "Android Devices Chooser" window can became unrelated. Close and re-open the Genymotion plugin to resolve this

Error handling

While Genymotion plugin window is open, errors are printed in Eclipse console.

As for Eclipse, we provide a plugin for IntelliJ IDE (Like Android Studio, or IDEA).
With it, you can easily test your applications. It uses ADB to connect to any running Genymotion virtual device and then push your application.

Plugin installation

There are two ways to install the plugin:

  1. JetBrains repositories method
    • Start your IDE
    • Go to the "File/Settings" menu
    • In the new opened window, select the "Plugins" section and then click the "Browse repositories..." button (on the bottom right)
    • In the list, click on Genymotion and click the "Download and install" button (on the upper-left corner)
    • Click the "Yes" button to begin
    • Click the "Close" button to leave the browse repository window
    • Click the "OK" button to leave the settings window
    • IntelliJ asks for restart. Accept by clicking the "Restart" button
  2. Manual method
    • Download the plugin on Genymotion official download page
    • Start your IDE
    • Go to the "File/Settings" menu
    • In the new opened window, select the "Plugins" section and then click the "Install plugin from disk..." button (on the bottom right)
    • Select the genymotion-IDEA-plugin.jar file
    • Click the "OK" button
    • The IDE asks for restart, accept by clicking the "Restart" button

Plugin usage

Click the Plugin button in IntelliJ toolbar to open the plugin

First start

  1. You will need to set path to Genymotion installation directory (given default path only works for a standard install): Genymotion settings
    • Windows: C:\Program Files\Genymobile\Genymotion
    • Mac OS X: /Applications/Genymotion.app
    • Linux: /home/[user]/genymotion
  2. Click the "OK" button
  3. Click the Plugin button again to open the main plugin window
    Genymotion device list

Actions

In the plugin main window, you can do the following actions:

  1. Start a Genymotion virtual device
  2. Create a new Genymotion virtual device
  3. Refresh the list of Genymotion virtual device

"Create" action will automatically start the Genymotion creation wizard.

virtual device states

The "status" column of the main window can take the following values:

  • Off: The virtual device is Off
  • Paused: The virtual device has been started, and then paused: restart action will get back at exactly same state
  • On: The virtual device is on, but not connected to ADB. It means that you cannot choose this virtual device in the "Android Device Chooser" window of ADT plug-in

Use Genymotion to run Android application

  1. First, click the Plugin button and start the virtual device you want to use.
  2. Close the Genymotion main window
  3. In your application project, right click and chose "Run as Android application"
  4. The "Android Devices Chooser" opens
  5. Click on the Genymotion virtual device you started/created
    Genymotion-VMNAME-@IP:PORT
    Where:
    • VMNAME is the virtual device name, as defined in Genymotion
    • @IP:PORT are the device address and port (assigned by ADB)

    After a reboot or an unexpected halt of a Genymotion virtual device, its displayed name in the "Android Devices Chooser" may become not relevant. Close and re-open the Genymotion plugin to solve it.

Error handling

While Genymotion plugin window is open, errors are printed in IntelliJ console.

Genymotion provides a shell that enables you to script the modification of sensor states.

Command line options

  • -h: print help
  • -r ip_address: connect to specific Genymotion virtual device
  • -c "command": execute the given command in Genymotion Shell environment and return
  • -f file: execute the content of the file. Each command per line

Available commands

  • battery getmode
    Get the current battery mode of the selected virtual device. The mode can only be:
    • host: The virtual battery reflect the host battery (if exists)
    • manual: In this mode, you can set the level and status battery values
  • battery setmode
    Set the battery mode. The mode can only be:
    • host: The virtual battery reflect the host battery (if exists)
    • manual: In this mode, you can set the level and status battery values
  • battery getlevel
    Get the current battery amount of power. The value can only be between 0% and 100%.
    If the battery mode is "host", the returned value is the host value.
  • battery setlevel
    Set the current battery amount of power. The value can only be between 0% and 100%.
    Set the battery level force the "manual" mode: if the last mode was "host", then it's turned to "manual"
  • battery getstatus
    Get the current battery status. There are 4 possible status:
    • Discharging: The power supply is disconnected and the battery is discharging.
    • Charging: The power supply is connected and the battery is charging.
    • Full: The battery is full.
    • Unknown: Sometimes, the battery status cannot be established, it happens when there is no host battery.
  • battery setstatus
    Set the current battery status. There are 4 possible status:
    • Discharging: The power supply is disconnected and the battery is discharging.
    • Charging: The power supply is connected and the battery is charging.
    • Full: The battery is full.
    • Unknown: Sometimes, the battery status cannot be established, it happens when there is no host battery.

  • devices list
    List available Genymotion virtual devices and provides details like current states or IP address.
  • devices ping
    Send a ping message to check if virtual device if responding
  • devices refresh
    Refresh Genymotion virtual device list. Use it to keep the list up-to-date.
  • devices select
    Select the Genymotion virtual device you want to interact with.
  • devices show
    List available Genymotion virtual devices and provides details like current states or IP address
  • devices factoryreset
    Factory reset virtual device (add keyword force at the end to avoid warning message about data loss)

  • gps activate
    Activate the GPS sensor (if not already activated)
  • gps desactivate
    Desactivate the GPS sensor (if activated)
  • gps getlatitude
    Return current latitude (if GPS is activated AND already has a latitude) or 0
  • gps setlatitude
    Set latitude (and activate GPS if not already activated)
  • gps getlongitude
    Return current longitude (if GPS is activated AND already has a longitude) or 0
  • gps setlongitude
    Set longitude (and activate GPS if not already activated)
  • gps getaltitude
    Return current altitude (if GPS is activated AND already has a altitude) or 0
  • gps setaltitude
    Set altitude (and activate GPS if not already activated)
  • gps getaccuracy
    Return current accuracy in meters (if GPS is activated AND already has a accuracy) or 0
  • gps setaccuracy
    Set accuracy (and activate GPS if not already activated)
  • gps getorientation
    Return current orientation in degrees (if GPS is activated AND already has a orientation) or 0
  • gps setorientation
    Set orientation (and activate GPS if not already activated)
  • rotation setangle
    Set the rotation angle of the virtual device.

  • genymotion capabilities
    Get Genymotion capabilities (gps, webcam, remote-control, ...) of selected virtual device.
  • genymotion clearcache
    Clear temporary downloaded files and logs.
  • genymotion version
    Get Genymotion version of selected virtual device.
  • genymotion license
    Get Genymotion license (type, validity, ...).

  • android version
    Get Android version of selected virtual device.
  • android getandroidid
    Get Android ID of selected virtual device (available only with Indie or Business license).
  • android setandroidid
    Set Android ID of selected virtual device (available only with Indie or Business license).
    Warning: if several users exist on the Android system, Android ID will only be set for the first user, not for all.
    Two kind of values are accepted:
    • random: generate a random Android ID.
    • custom value (must be 16 hexadecimal digits long).
  • android getdeviceid
    Get Device ID (IMEI/MEID number) of selected virtual device (available only with Indie or Business license).
  • android setdeviceid
    Set Device ID (IMEI/MEID number) of selected virtual device (available only with Indie or Business license).
    Three kind of values are accepted:
    • none: set an empty Device ID.
    • random: generate a random Device ID.
    • custom value (alphanumeric characters, point, dash, underscore).

  • build number
    Get Genymotion Shell build number
  • help
    Prompt the help.
  • pause
    Pause execution (in number of seconds).
  • version
    Get Genymotion Shell version.
  • exit or quit
    Close Genymotion Shell.

Android Debug Bridge (adb) is a versatile command line tool that lets you communicate with an emulator instance or connected Android-powered device. It is a client-server program that includes three components: a client, a server and a service

How to install your own ADB tool and configure Genymotion to use it:

  • Download the Android Developer tools (ADT)
  • Unzip / untar the archive in the path of your choice.
  • Start Genymotion and open the settings panel.
  • Go to the tab ADB.
  • Choose the option: Use custom Android tools.
  • Set the ADB path like the following example:
    adt-bundle\sdk
    Note that :
    • The field will stay red until the provided path is valid
    • "adt-bundle\sdk\platform-tools" is not a valid value.
  • Click the "OK" button

Every Genymotion devices will now be automatically connected to ADB at start.