Skip to content

Emulated Sensors and Features

The widgets visibility in the right tool bar will vary depending on the virtual device display window size and your screen resolution. To display all the available widgets, click on top of the tool bar.

To simulate various behaviors of your application according to specific use cases, Genymotion Desktop provides easy-to-use widgets which emulate the following sensors and features:

Capture

The Capture widget allows you to take a screenshot or screencast of virtual devices. This way, you can share images or videos of your applications.

To open the capture window, click

Capture widget

Then, select an action:

  • Screenshot : take a screenshot.
  • Screencast : record a screencast. Click again to stop.
  • Browse file : browse the recorded screenshots and/or screencasts folder.

The default folder can be changed in Genymotion > Settings > Device.

Battery

The Battery widget allows you to test how your application reacts with different battery charge levels and states of charge.

Click to open the widget:

Battery widget

Then, you can:

  • edit the charge level using the slider, or enter a value in the Charge level input field
  • toggle the state of charge with the State of charge switch

GPS

Click to open the GPS widget window:

GPS

Single position

To use the GPS widget and set a single position:

  1. Toggle the Activate GPS emulation switch.
  2. Set the following values:
Description Value range
Latitude The latitude value you wish to simulate. -90° to 90°
Longitude The longitude value you wish to simulate. -180° to 180°
Altitude The altitude value you wish to simulate. -10000m to 10000m
Speed Set a speed in meters per second. 0m/s to 99999.99m/s
Accuracy Use the slider or enter a value to set the accuracy. 0m to 200m
Bearing Use the compass or enter a value to set the bearing. 0° to 359.99°

You can also define a location using the built-in map.

Many applications do not rely on the GPS orientation, but use the device accelerometer or gyroscope to determine the bearing of the device. This is not emulated yet, but you can use the remote control widget to use a real device with accelerometer and/or gyroscope.

Simulate routes

3.3.0 - Paying

It is also possible to simulate routes by uploading a track file.

Requirements & Limitations

  • This feature only supports GPX trace format for the moment. More formats may be added in the future.
  • Your GPX file must at least contain latitude and logitude data, for example:
<trkpt lat="46.0538" lon="6.6692"><ele>1410.734375</ele><time>2020-02-21T13:51:25Z</time></trkpt>
  • If elevation is missing, it will default to 0.
  • If timestamp is missing from a data point, it will default to the previous data point timestamp plus 1 second.
  • If the data points are not in chronological order, they will be sorted before being played.
  • If your GPX file contains more than one track, only the first track will be played.
  1. Generate a GPX track file with your favourite application, such as GoogleEarth.
  2. If it is not already enabled, toggle Activate GPS emulation on.
  3. Toggle the Replay a GPS trace feature on:

    GPS tracks open

  4. Click Open to upload your GPX.

  5. Click to start or pause the route simulation:

  6. Change play speed by selecting a replay speed in the drop-down menu.

Camera and Media Injection

3.3.0 - Paying

With this widget, you can select your host webcams, microphones, videos, images or audio files as the device camera and audio input source.

To open the widget window, click Created with Sketch.

media inputs

Host physical camera

Your host physical camera devices are listed in the Cameras box:

media source

You can assign them to the virtual device front and/or back cameras in the Video section.

Media inputs

You can use image, video and audio files as audio and/or video inputs for the device.

Genymotion Desktop does not include any codecs: Most media files should work "out of the box" on Linux and macOS but you may need to install Codec packs on Windows, such as K-Lite Codec Pack Full .

  1. In the Media files box, click OPEN MEDIA FOLDER:

    Media files

  2. Copy your media files to the opened folder. The files you added should appear in the Media files box.

Media folder

Genymotion Desktop media folder is located at the following path:

%LOCALAPPDATA%\Genymobile\Genymotion\media
$HOME/.Genymobile/Genymotion/media
$HOME/Applications/Genymotion.app/Contents/MacOS/media

When done, you can:

  • click to play your media files.
  • select an audio file as Microphone input.
  • select a video or image file as front and/or back Camera input.
  • resize the video or image. Available resize profiles are Crop, Keep aspect and Resize:

Remote control

With the Remote control widget, you can take control of a virtual device from a physical device (any phone or tablet running Android version 2.2/API level 8/Froyo or above). This widget works with a specific Android application that runs on the physical device and forwards touch inputs and accelerometer events to Genymotion Desktop. As a result, you can test your application as if you were holding a device in your hands.

The Remote control widget requires to have ADB installed and setup on your computer.

To use the Remote control widget:

  1. Connect your physical device either by wire or with Wi-Fi. To connect with Wi-Fi, your physical device must support ADB over network.
  2. On your physical device, go to Settings → Developer options. If you haven't unlocked the Developer options menu yet, go to Settings → About and click several times on Build number until you get a message saying that Developer options are now available.
  3. Check Android debugging and then ADB over network.
  4. Connect your physical device to the Wi-Fi and retrieve its IP address from the Wi-Fi menu.
  5. Open a terminal or command prompt and enter:

    adb connect {your_device_IP}
    
  6. Click

    Remote control widget

  7. Activate remote control emulation. Genymotion Desktop tries to detect any connected Android device.

  8. Select your device from the Available devices drop-down box and click

    If the device is connected to ADB and not visible in the list, restart the widget.

  9. Check the desired options:

    • Enable preview: Preview your Genymotion Desktop screen on your physical device.
    • Enable touch screen: Send touch events to Genymotion Desktop.
    • Enable accelerometer: Send accelerometer events to Genymotion Desktop.

The Remote control widget automatically stops when you disconnect your device.

Android Controls

3.3.0 - Paying

With this widget, you can emulate the following Android controls:

  • Directional pad
  • Volume
  • Calls
  • Media controls

To open the widget, click

Android Controls

Identifiers

The Identifiers widget shows Android ID and Device ID/IMEI/MEID values. You can view and edit these values at any time, without having to reboot your virtual device.

To open the identifiers window, click and enter a value for each identifier or click  to generate random values:

identifiers

You cannot set an empty Android ID.

Device ID/IMEI/MEID value must be compliant with the GSM 02.16 standard and the 3GPP2 specification (14 digits or hexadecimal digits + a checksum digit). Valid characters for setting device ID/IMEI/MEID are lower-case and upper-case letters [a-z, A-Z], digits [0-9], dots [ . ], dashes [ - ] and underscores [ _ ].

Note

  • On Android 8.0 and above, the Android ID has a different value for each application on the device. This is not the case in Genymotion: the Android ID remains the same for all applications.
  • By default, a new virtual device is deployed with the default Device ID number 000000000000000.

Disk I/O

The Disk I/O widget allows you to emulate devices with slow internal storage. It can be very handy if your app requires reading large amount of data from the disk such as gallery apps that load locally stored images or games that load large assets.

Disk I/O

To simulate high or low disk performance:

  1. Click
  2. Enable disk I/O emulation.
  3. From the Profile drop-down box, select a type of device:
Read speed limit
High-end device 200 MiB per second.
Mid-range device 100 MiB per second.
Low-end device 50 MiB per second.
Custom device Enter the read speed limit you wish to emulate in MiB.

When switching from a device profile to another, the disk cache is automatically cleared. You can force clearing the cache by clicking Clear.

Network

3.3.0 - Paying

The Network widget allows you to test your application with different network interfaces, network types and signal strength.

Click to open the network widget:

Network

Wifi

When Wifi is enabled, your applications will behave as if you're connected on a Wifi network. Wifi is the interface enabled by default.

Mobile data

Mobile data is only simulated: Baseband (SIM data connection) is not emulated and it is not possible to send nor receive calls and text messages to other mobile devices from Genymotion.

To use this feature:

  1. Disable Wifi
  2. Enable Mobile data
  3. Select a Network type from drop-down list:

    Download speed Upload speed Upload/Download delay (in ms) Upload/Download packet loss
    Unlimited N/A N/A N/A N/A
    2G GSM 14Kb/s 14 Kb/s 500 0
    2G GPRS 57Kb/s 28Kb/s 300 0
    2G Edge 236Kb/s 236Kb/s 75 0
    3G UMTS 384Kb/s 384Kb/s 75 0
    3G HSDPA 13.98Mb/s 5.76Mb/s 10% 0
    4G LTE 173Mb/s 58Mb/s 5 0
    5G 1174Mb/s 211Mb/s 5 0
  4. Select a Signal strength from the drop-down list. Available values are: Great, Good, Moderate, Poor and None.

Disable all network

Simply disable Wifi and Mobile data to disable network altogether on the device.

Mobile data is only simulated: Baseband (SIM data connection) is not emulated and it is not possible to send nor receive calls and text messages to other mobile devices from Genymotion.

The Network widget allows you to test how your application reacts with different network quality and performance types:

Old network widget

  1. Click
  2. Activate the network simulation with the switch
  3. Select a network profile from the drop-down list:
Download speed Upload speed Upload/Download delay (in ms) Upload/Download packet loss DNS delay (in ms)
Unlimited N/A N/A N/A N/A N/A
No data 0 0 100%
2G GPRS 57Kb/s 28Kb/s 300 0 1000
2G Edge 236Kb/s 236Kb/s 75 0 800
3G UMTS 384Kb/s 384Kb/s 75 0 200
4G LTE 173Mb/s 58Mb/s 5 0 100
4G (High DNS delay) 5.5Mb/s 17.9Mb/s 50 0.01% 3000
4G (High packet losses) 5.5Mb/s 17.9Mb/s 50 10% 100

Baseband

3.5.0 - Paying

Network operator and SIM operator (Baseband) are only emulated: it is not possible is not possible to send nor receive calls to other mobiles devices from Genymotion.

Virtual devices do not have a phone number.

The Baseband widget allows you to test applications by providing information and control related to the network and SIM operators.

To use the Baseband widget, click on

Baseband widget

Then, for the Network operator section, enter the following information:

  • MCC/MNC: The MCC/MNC to uniquely identify the mobile network operator
  • Name: The operator name.

For SIM operator:

  • MCC/MNC: The MCC/MNC to uniquely identify the mobile network operator
  • MSIN: The MSIN to uniquely identify the mobile phone
  • Name: The name of the operator
  • Phone number: The simulated phone number.

Names of network and SIM operator are displayed in the Internet settings of the virtual device.

Phone

SIM data connection (Baseband) is not emulated: it is not possible to send or receive calls and text messages to other devices.

Virtual devices do not have a phone number.

The Phone widget allows you to test applications relying on telephony features and observe their behavior when receiving a call or a text message.

To use the Phone widget, click

Phone widget

Then, enter a fictitious incoming phone number and:

  • Click Call to simulate an incoming phone call
  • Enter a text message and click Send message to simulate an incoming text message

Text messages are displayed in the virtual device via a notification, but they can also be read in the Messaging application.

Open GApps

The application you are developing or testing may require an interaction with Google Play Services (e.g.: in-app purchasing, advertising, etc.). The Open GApps widget allows you to install a minimum package of those services, also containing an application store.

We assume no liability whatsoever resulting from the download, install and use of Google Play Services within your virtual devices. DO IT AT YOUR OWN RISK!

To install the package:

  1. Click , or and Install Open GApps.
  2. Read the Disclaimer carefully and click Accept if you agree with the terms. The Open GAPPs package will be automatically downloaded and flashed.
  3. Reboot the virtual device when prompted. The device will reboot and, meanwhile, you will be redirected to Open GAPPS website.

To launch Google Play Store, hold the left mouse button and slide up from the bottom of the device display. Then, click Google Play:

Your device isn't compatible with this version

If the application cannot be found, or if Play Store displays the "Your device isn't compatible with this version" error message, it may mean that:

  • the application has been compiled for ARM only. Please refer to Deploy an Application for possible solutions.
  • the application cannot run on a rooted device: Genymotion Desktop devices are all rooted.
  • the application requires a feature that is not emulated, such as Bluetooth.

Sound Control

Click or to control the volume of the sound emitted by your virtual device.

Rotate Screen

3.3.0

Click image/svg+xml to rotate the screen 90° to the left, or click image/svg+xml to rotate the screen 90° to the right.

Pixel Perfect

With Pixel Perfect, you can be highly precise in the development of your user interface and ensure every pixel of your application really looks as it should. One pixel of the virtual device is displayed using one pixel of your computer screen.

Click to enable or disable Pixel Perfect.

If the virtual device screen size is larger than your computer screen size, the virtual device window will be maximized and you will be able to use scrollbars to move inside the screen.

Advanced developer tools

3.4.0 - Paying

The Advanced developer tools widget provides quick access to the most common Android developer tools:

  • Root Access

    Root access is only available for Android 14.0 at the moment.

    For detailed instructions, please refer to Root Access.

  • Show taps

  • Show pointer location
  • Show layout bounds
  • Enable animation
  • Force desktop mode

    Notes

    • The 'Force desktop mode' tool only applies with multiple display.
    • A reboot of the device is necessary to activate this tool.

Click to open the widget window and use the switches to toggle the tools you need to use:

Advanced developer tools window

Biometrics

3.6.0 - Paying

This feature is only available for Android 13 and above.

The Biometrics widget allows you to simulate fingerprint recognition.

Click to open the widget window:

Biometrics widget disabled

The icons will only become available when fingerprint enrollment starts in Android. At this moment, Biometric authentication currently requested will turn to True:

Biometrics widget enabled

Then, you will be able to click on one of the icons to simulate the following scenarios:

  • Recognized: the fingerprint is matched and recognized.
  • Unrecognized: the fingerprint is not matched nor recognized.
  • Dirty: the fingerprint is dirty.
  • Partial: only part of the fingerprint is matched.
  • Insufficient: the fingerprint quality is not good enough to be recognized.
  • Too fast: the fingerprint capture has been made too fast to be recognized.

You can also toggle Automatically validate biometric authentication to automatically respond to a fingerprint enrollment with the Recognized scenario.

Important Note

In order to use this widget in any application asking for Fingerprint authentication, you need to configure one fingerprint in Android.

Follow these step, in Android:

  1. Go to "Settings".
  2. Then "Security".
  3. Then "Fingerprint".
  4. Then click on "Add fingerprint" and use the Biometric widget to configure one finger.

Here is a quick video showing the whole procedure:

The navigation widgets simulate a real device navigation buttons:

  • Click Created with Sketch. to bring the Android Recent Screen and list recently accessed activities and tasks.
  • Click Created with Sketch. to navigate to Android Home page.
  • Click Created with Sketch. to simulate the Back button of a real device.

Power

The power widget simulates a real device power button:

  • Click to put the virtual device to sleep.
  • Click and hold your mouse button to simulate a power button hold (reset/power off).

Settings

3.3.0

Click to open the extra settings window:

Extra settings

Information

In this section, you can find information related to Genymotion and your virtual device:

  • Emulator version: Genymotion version.
  • Android version: the Android version of the virtual device.
  • ADB serial: the ADB serial (local IP and port) of the virtual device.

Toolbar

You can click in the right-side toolbar to reach this feature.

With this feature, you can:

  • Select which widgets to display in the right-side toolbar by checking them.
  • Drag'n drop the widgets to change their order in the right-side toolbar.
  • Click to reset to default.

Toolbar

Shortcuts

This feature allows you to change the default virtual device shortcuts and add custom shortcuts:

Shortcuts

  1. Click on a feature to create or edit a shorcut:

    Shortcuts edit

  2. Press a key sequence (for example, Ctrl+A) and click SET to confirm.

Click to restore the default value.

Licenses

Displays the licenses of Genymotion open-source components:

Licenses

Click COPY to copy the full text of the license. 5. Dow

Back to top