Skip to main content

Python wrapper for BrowserStack features.

Project description

Python wrapper for BrowserStack features.

Build Status


The current stable release:

pip install browserstacker


easy_install browserstacker

or from source:

$ sudo python install


To start working with BrowserStack ScreenShots API simply type:

>>> from browserstacker import ScreenShotsAPI
>>> api = ScreenShotsAPI('user', 'key')
>>> api.list_browsers()
      "os": "Windows",
      "os_version": "XP",
      "browser": "chrome",
      "browser_version": "21.0",
      "device": null
      "os": "ios",
      "os_version": "6.0",
      "browser": "Mobile Safari",
      "browser_version": null,
      "device": "iPhone 4S (6.0)"

To generate screenshots:

>>> browser = api.list_browsers()[0]
>>> response = api.generate_screenshots('', browser)

Here you can pass single browsers or list of them. You’ll get the job_id from response. To list available screenshots for job_id:

>>> api.list_screenshots(response['job_id'])
    "callback_url": "",
    "win_res": "1024x768",
    "mac_res": "1920x1080",
    "quality": "compressed",
    "wait_time": 5,
    "screenshots": [
            "created_at":"2013-03-14 16:25:45 UTC",

To download screenshots:

>>> api.download_screenshots(response['job_id'], 'path_to_screenshots_dir')

All screenshots will be saved in ‘path_to_screenshots_dir’. If destination kwarg is absent, then screenshots will be downloaded to current working directory. Also you can use shortcut to create & download screenshots to your local machine:

>>> response = api.make_screenshots('', browser, destination='path_to_screenshots_dir')

Python support

BrowserStacker supports Python 2.6, 2.7, 3.2, 3.3, 3.4, 3.5, PyPy, PyPy3 and Jython.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

browserstacker-0.2.1.tar.gz (10.4 kB view hashes)

Uploaded source

Built Distribution

browserstacker-0.2.1-py2.py3-none-any.whl (12.4 kB view hashes)

Uploaded 3 5

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page