How to capture screenshots for a Flutter app?

Me, trying to figure out, how to capture screenshots…

TL;DR: This is a story about how I made my own tool to capture screenshots on multiple devices. It’s not some kind of magic tool that can make screenshots fully automatically, it only starts the simulator/emulator and runs the UI tests on the booted device. Where exactly the screenshot capturing happens? It’s totally up to you. It depends on where you put a screenshot method call in your tests.
You can find more details under Usage and you can check the link of the project’s GitHub repository at the end of the story.

The problem

I faced with this too, maybe same as you. So I started to search on the Net and found a few tools, but I wasn’t able to make them work.

The solution

  1. If it is necessary create a schema about the device
  2. Boot more devices after each other
  3. Switch the theme of the os between light and dark
  4. Run the UI tests on the booted device and extend the test with screenshot taking
  5. Able to configure test runs for readable test results — pass the current device’s name and theme setup, so it puts the images to individual directories
  6. Stop the device after test done

It didn’t look like rocket science, so I started to implement it. I wanted to create a simple, straight forward tool so it was evident to create it in Go.


On MacOS this command is available if you install Command Line Tools for XCode.


If you want to run Android emulators, there are two possible options:

  1. Install Android Studio and set up the necessary environment variables
  2. Install only the command line tools for Android development and also set up the necessary environment variables, link here

It’s totally up to you, I’ll attach the mentioned variables with an example:

export ANDROID_HOME="$HOME/android"
# you can use specific version, instead of latest



  • Installed Xcode with Simulator
  • Installed Android development environment (it can be Android Studio or only command line tools)

Install the tool from source

Install the prebuilt release from GitHub


wget{RELEASE}/flutter-screenshot_{RELEASE}_{OS_KIND}_{ARCH}.tar.gz -O ~/Downloads/flutter-screenshot.tar.gz
tar -xzvf ~/Downloads/flutter-screenshot.tar.gz flutter-screenshot
mv ~/Downloads/flutter-screenshot /usr/local/bin/flutter-screenshot

Download and extract the release.

Add configuration to your flutter project

Or do it manually:

Name it screenshots.yaml

The value of the command field will be executed after the virtual device started

command: flutter drive --target=test_driver/app.dart
- name: iPhone X
mode: both
- name: iPad Pro (12.9-inch) (4th generation)
mode: dark
- name: Pixel

Test your setup before continue

INFO[0000] Checking iOS commands are on path...
INFO[0000] xcrun: ✅
INFO[0000] Checking Android environment variables...
INFO[0000] Checking Android commands are on path...
INFO[0000] emulator: ✅
INFO[0000] adb: ✅

Implement a custom helper method in your UI tests

Note: You can use EMU_DEVICE environment variable to group the captured images, it contains the running device’s name and the theme setup in snake_case format. e.x.: iPhone_X_dark

final now = new;
Future<void> makeScreenshot(FlutterDriver driver, String filename) async {
final imageInPixels = await driver.screenshot();
new File('screenshots/${Platform.environment['EMU_DEVICE']}_${now.toString()}/$filename.png')

As last step, execute the following command

You can use --verbose flag to get more log messages

The --config flag is optional and it waits your configuration file’s path, so you can put anywhere and/or rename your configuration file.

flutter-screenshot [--verbose] [--config/-c]

Plans for future

I’m also open for opinions and proposals, so don’t be shy and share your experiences with me! If you want to contribute to project, check the GitHub link down.

Gopher, software engineer, remote worker. Likes science and technology.