Skip to main content

gmsaas

Description

gmsaas is a command line interface to rule all your virtual devices hosted in Genymotion SaaS solution without opening an Internet browser. With it you can list, start and stop devices. Above all, you can securely connect to any devices through Android Debug Bridge.

It is a lightweight binary, easy to install, easy to update.

Requirements

  • Python 3.10 or above
  • pip3
  • Android SDK

Installation

pip3 install [--user] gmsaas

Get started

Two steps are required to use gmsaas properly:

  • Configure the path to your Android SDK with:

    gmsaas config set android-sdk-path <sdk_path>
    
  • Authenticate with:

    gmsaas auth token <token>
    

Full documentation can be found here

Change Log

All notable changes of gmsaas are documented in this file.

1.16.1

Fixed

  • Fix macOS wheel being advertised as compatible with macOS 11 Big Sur, macOS 12 Monterey or newer is required
  • Fix Brotli security vulnerability (CVE-2026-111497) in the Linux arm64 wheel, other wheels are not affected
  • Fix ADB Tunnel daemon memory leak growing with each ADB Tunnel command
  • ADB Tunnel daemon no longer retries requests when credentials are invalid

1.16.0

Added

  • gmsaas admin usage command to get usage report for the current organization
  • --cpu-count and --ram-size options to gmsaas hwprofiles create command
  • form_factors fields in gmsaas osimages list|get|clone commands
  • gmsaas --completion to get help on Tab-Completion setup

Changed

  • Drop Python 3.8 and 3.9 support
  • Better handling of HTTP 403 errors
  • gmsaas instances adbconnect does not need UUID argument as long as one and only one instance is ONLINE.
  • gmsaas instances adbdisconnect does not need UUID argument

Fixed

  • Fix inverted --delete-osimage and --delete-hwprofile in gmsaas recipes delete command
  • Enforce ADB connection
  • Fixed ADB Tunnel daemon failing to start in certain environments where $TMPDIR is ephemeral (e.g. Nix shell sessions)
  • Fix grammar in API error messages

1.15.0

Added

  • Linux arm64 wheel available for distributions with glibc 2.39 (Ubuntu 24+, Fedora 40+, Debian 13+)

Changed

  • macOS: native arm64 ADB Tunnel (Rosetta 2 no longer needed)
  • Linux x86 wheel upgraded and available for distributions with glibc 2.31 (Ubuntu 20+, Fedora 32+, Debian 11+)
  • Windows x86 wheel upgraded
  • OpenSSL 3 used for ADB Tunnel instead of OpenSSL 1.1.1

1.14.1

Fixed

  • Resolved an issue where adbconnect command failed on Windows due to a missing OpenSSL dependency.

1.14.0

Changed

  • Drop support of Linux distributions using glibc version earlier than 2.31.

Fixed

  • Fixed ADB Tunnel stability within a congested network environment.

1.13.0

Added

  • Added gmsaas adb start|stop commands.

Changed

  • Included architecture information in the gmsaas portal.
  • Updated exit_code_desc for exit code 12 from ADBTUNNEL_GENERIC_ERROR to ADBTUNNEL_TIMEOUT_ERROR.
  • Updated exit_code_desc for exit code 9 from APPLE_M1_CHIP_ERROR to APPLE_SILICON_CHIP_ERROR.
  • Refined error wording for exit code 7 (PACKAGE_ERROR).
  • Refined error wording for exit code 12 (ADBTUNNEL_TIMEOUT_ERROR).

Fixed

  • Enhanced ADB Tunnel reliability.

1.12.0

Added

  • Native Android support (ARM-based images).
  • Display Android image beta information in the recipes get|list and osimages get|list commands.

1.11.0

Added

  • Added gmsaas doctor command to quickly check if gmsaas is configured properly.

Fixed

  • Python 3.12 support.

1.10.0

Added

  • Added gmsaas auth token <token> command (use API Token for authentication).
  • Added gmsaas auth reset command (clear API Token from cache).
  • Read GENYMOTION_API_TOKEN environment variable for authentication.

Changed

  • Marked gmsaas auth login <email> command as deprecated.
  • Marked gmsaas auth logout command as deprecated.
  • Marked gmsaas auth whoami command as deprecated.

Fixed

  • Improved real-time instance state update reliability.

1.9.0

Added

  • Added gmsaas instances display command.

1.8.0

Added

  • Added --max-run-duration option for command gmsaas instances start.
  • Added gmsaas hwprofiles get|list|create|delete commands.
  • Added gmsaas osimages get|list|clone|delete commands.
  • Added gmsaas recipes get|create|delete commands.
  • Added gmsaas instances save|saveas commands.

Changed

  • Require at least Python 3.8.
  • Marked as deprecated --stop-when-inactive option, replaced by --max-run-duration.
  • Added --out option to gmsaas logzip command.
  • Added --source option to gmsaas recipes list command.
  • Improved help wording which is now accessible with -h in addition of --help.
  • Added more details in JSON output format regarding Recipes and Instances.

1.7.1

Fixed

  • Fix gmsaas when system temp directory is mounted on a separate partition.

1.7.0

Added

  • Added Apple Silicon support (requires pip3 >= 20.9)
  • Instances returned by gmsaas --format json instances * commands include created_at info
  • Improved Android Sdk path verification with gmsaas config set android-sdk-path <path> command

Changed

  • Deprecate Python 3.5

Fixed

  • Fix corrupted configuration file with simultaneous multiple gmsaas processes

1.6.1

Fixed

  • Fix dependencies to continue supporting Python 3.5

1.6.0

Added

  • gmsaas instances get <uuid> command to get information about one specific instance

Fixed

  • Enforce start and stop commands in case of server connection failure

1.5.2

Added

  • gmsaas --format json instances * command outputs full recipe(s) info

Fixed

  • Improve ADB Tunnel stability over time

1.5.1

Added

  • Instances printed by gmsaas --format json instances * commands include recipe UUID info

Fixed

  • Optimize gmsaas instances adbconnect command and reduce the number of timeout errors

1.5.0

Added

  • JSON format output for all gmsaas commands. Get it with --format global option or by defining it in configuration gmsaas config set output-format json

Fixed

  • Improve Socket.IO stability

1.4.0

Added

  • SOCKS5 proxy support with gmsaas config set proxy command

Changed

  • Use simple quotes instead of back quotes in all outputs

Fixed

  • Fix recipes sorting regarding Android 10

1.3.2

Fixed

  • Fix gmsaas behavior when configuration and system proxy are both set: system proxy no longer interferes

1.3.1

Fixed

  • Fix assertion when gmsaas is upgraded while an older ADB Tunnel is running
  • Improve Socket.IO connection stability

1.3.0

Added

  • HTTP/HTTPS proxy support with gmsaas config set proxy command
  • --verbose/-v global option to print logs to standard output

Changed

  • Improve wording of error messages
  • Improve password cyphering

Fixed

  • Make ADB Tunnel more resilient: continue running when terminal is closed

1.2.0

Added

  • --quiet/-q option to gmsaas instances list command to print instance UUIDs only

1.1.0

Added

  • gmsaas logzip command to fetch all logs in one ZIP archive

Changed

  • Improve gmsaas auth login output in case of failure

1.0.0 (initial release)

Added

  • List device recipes available
  • List running devices
  • Start a device based on one recipe
  • Stop a running device
  • Connect a running device to ADB
  • Disconnect a running device from ADB

Metadata

Release files for gmsaas 1.16.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for gmsaas 1.16.1
File Actions
gmsaas-1.16.1-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for gmsaas-1.16.1-py3-none-win_amd64.whl
gmsaas-1.16.1-py3-none-manylinux_2_39_aarch64.whl Python 3 none Linux glibc 2.39+ ARM64 Details for gmsaas-1.16.1-py3-none-manylinux_2_39_aarch64.whl
gmsaas-1.16.1-py3-none-manylinux_2_31_x86_64.whl Python 3 none Linux glibc 2.31+ x86-64 Details for gmsaas-1.16.1-py3-none-manylinux_2_31_x86_64.whl
gmsaas-1.16.1-py3-none-macosx_12_0_universal2.whl Python 3 none macOS 12.0+ universal2 (ARM64, x86-64) Details for gmsaas-1.16.1-py3-none-macosx_12_0_universal2.whl

Total release size: 142.7 MB

Release files / gmsaas-1.16.1-py3-none-win_amd64.whl

Download URL gmsaas-1.16.1-py3-none-win_amd64.whl
Size 32.1 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
560f69318b79663ea56357ba40b50094d9256562d10b146b8a2798291697765e
BLAKE2b-256 checksum
How to use checksums
a950dcafd684d3b81df69351a29f933147e2a1fb2ab9d298a41259390ed7f704
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / gmsaas-1.16.1-py3-none-manylinux_2_39_aarch64.whl

Download URL gmsaas-1.16.1-py3-none-manylinux_2_39_aarch64.whl
Size 21.7 MB
Tags Linux glibc 2.39+ ARM64 Python 3
SHA-256 checksum
How to use checksums
21e7c8a1c2919825106658d1974c0a989bafc63fd8705b722ad11cba11b4cf8c
BLAKE2b-256 checksum
How to use checksums
6db944584b1c51e2206647684c708867462f60a7396cd1df712a946df876dd0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / gmsaas-1.16.1-py3-none-manylinux_2_31_x86_64.whl

Download URL gmsaas-1.16.1-py3-none-manylinux_2_31_x86_64.whl
Size 22.6 MB
Tags Linux glibc 2.31+ x86-64 Python 3
SHA-256 checksum
How to use checksums
414583ae4981314bb46a84185b54863ed776c15ef7729e8ed6057d94c310327d
BLAKE2b-256 checksum
How to use checksums
d59bf65acc2629d08cefcfe8c476defde80b7721a182312f813570399ec6f332
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / gmsaas-1.16.1-py3-none-macosx_12_0_universal2.whl

Download URL gmsaas-1.16.1-py3-none-macosx_12_0_universal2.whl
Size 66.3 MB
Tags Python 3 macOS 12.0+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
d94f62a9841f1ab39930b499f3e6c98ab1716225ccd1b377b73bfe0adda54055
BLAKE2b-256 checksum
How to use checksums
270928b4526951354b25ec239cea78bfd33ce387c7fbaa4f30a145d4837d04ba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for gmsaas 1.16.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.16.1 This release

4 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page