Easy Screenshots

Android Instrumentation Test Screenshots made Easy.
Alternatives To Easy Screenshots
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Spoon2,6421022 years ago38February 03, 201795apache-2.0HTML
Distributing instrumentation tests to all your Androids.
Screenshot Tests For Android1,689143 months ago21February 03, 202251apache-2.0Java
Generate fast deterministic screenshots during Android instrumentation tests
4 years ago61apache-2.0Kotlin
Reactive Android Instrumentation Test Runner. Archived. Marathon is recommended as an alternative (https://github.com/Malinskiy/marathon).
Espresso Cucumber47
8 years ago1apache-2.0Java
Library to test Android applications using Espresso test framework with cucumber BDD language and Spoon screenshots
Easy Screenshots22
2 years ago9apache-2.0Java
Android Instrumentation Test Screenshots made Easy.
Alternatives To Easy Screenshots
Select To Compare

Alternative Project Comparisons

Due to changes in the priorities, this project is currently not being supported. The project is archived as of 9/17/21 and will be available in a read-only state. Please note, since archival, the project is not maintained or reviewed.

Easy Screenshots

Android Instrumentation Test Screenshots made Easy.

Getting Started

1) Add Gradle Dependencies:

androidTestCompile 'com.capitalone.easyscreenshots:easyscreenshots:1.1.0'

2) Take Screenshots


or (if you use a static import)

 import static com.capitalone.easyscreenshots.EasyScreenshots.takeScreenshot;

Note: at this point you would have screenshots taken and stored locally on the device.

3a) Add the External Storage Permission to your Manifest

Add the android.permission.WRITE_EXTERNAL_STORAGE Permission to your app's AndroidManifest.xml.

This is required in order to save the screenshots to the device's SD Card. You must declare the WRITE_EXTERNAL_STORAGE permission. If your app is not already using this permission, we recommend you add it to a non-release build variant's manifest (ex. debug).

Note: This cannot be added to your test application's manifest, it must be added to your normal app's manifest.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

3b) (API 23+ only) Granting the External Storage Permission during a Test

GrantPermissionRule - (Requires Android Testing Support Library 1.0.0 or Higher)

In order to work around this bug: https://issuetracker.google.com/issues/64389280, you currently need to grant READ_EXTERNAL_STORAGE and WRITE_EXTERNAL_STORAGE. So, you will need both of these in your application's manifest while this issues exists.

public GrantPermissionRule permissionRule =
    GrantPermissionRule.grant(android.Manifest.permission.READ_EXTERNAL_STORAGE, android.Manifest.permission.WRITE_EXTERNAL_STORAGE);

If you do NOT grant this permission, the following exception will be thrown.

java.lang.RuntimeException: Unable to capture screenshot.
Do you have the 'android.permission.WRITE_EXTERNAL_STORAGE' permission requested and granted?

4) View Screenshots


  • Use the Device File Explorer in Android Studio and view the images.
  • Use Spoon to run your tests and get a generated test report with the screenshots you took.
  • Use Composer to run your tests and get a generated test report with the screenshots you took.

Alternatively, you can also use the Spoon Gradle Plugin, but only works with the Android Gradle Plugin <3.

Customizing Easy Screenshots

Configure Screenshot Storage Location

Easy Screenshots uses a FileProvider to provide the filepath for a taken screenshot.

By default, we provide the SpoonFileProvider for Spoon compatibility, but you can create your own which will specify where you want the screenshots to be saved on the device by either:

  • Calling screenshotFileProvider(...) when constructing an EasyScreenshots instance with an Initializer.
  • Calling EasyScreenshots.setScreenshotFileProvider(...).

Configure Screenshot Policy

Control when screenshots are taken by either:

  • Calling policy(...) when constructing an EasyScreenshots instance with an Initializer.
  • Calling EasyScreenshots.setPolicy(...).
  • Using the screenshot-policy instrumentation argument.

Change Screenshot Library

By default, we use Falcon for <18 and UiAutomator for 18+, which should meet most use-cases. If you'd like to force a specific library, you can call EasyScreenshots.setScreenshotLibrary(...) with ex. new FalconScreenshotLibrary()


We welcome your interest in Capital Ones Open Source Project (the Project). Any Contributor to the Project must accept and sign a CLA indicating agreement to the CLA's terms. Except for the license granted in the CLA to Capital One and to recipients of software distributed by Capital One, you reserve all right, title, and interest in and to your contributions; this CLA does not impact your rights to use your own contributions for any other purpose.

Link to Individual CLA

Link to Corporate CLA

This project adheres to the Open Source Code of Conduct. By participating, you are expected to honor this code.

Popular Instrumentation Projects
Popular Screenshot Projects
Popular Operations Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.