Record animated GIFs (and videos) from the iOS Simulator and the Android Emulator
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode RecorderFactory create tests Dec 18, 2018
bin move executable code to executable file Jan 16, 2019
lib go back to require_relative Jan 16, 2019
spec remove recorder files and fix requires Jan 16, 2019
.gitignore code coverage Dec 19, 2018
.travis.yml remove master only requirement Jan 16, 2019
Gemfile code coverage Dec 19, 2018
Gemfile.lock code coverage Dec 19, 2018
LICENSE
README.md code coverage Dec 19, 2018
android.mp4.gif Add parameters, add image from Android as well, increase version Oct 16, 2018
capa.gemspec fix documentation Dec 17, 2018
ios.mp4.gif Add parameters, add image from Android as well, increase version Oct 16, 2018

README.md

capa

Build Status Test Coverage Gem Version License

Record animated GIFs (and videos) from the iOS Simulator and Android Emulator. Because a GIF is worth a thousand lines of code.

iOS Simulator Android Emulator

Motivation

When developing a mobile app within a team that contributes to the code base doing Pull Requests, sometimes it's hard to visualize how the changes will look like in a running App just by looking at the diff. You can help your colleagues by adding an animated GIF into the Pull Request description and this tool wants to make it very simple for you.

Getting started

  1. Install gifify
> brew install node
> brew install ffmpeg --with-libass --with-fontconfig
> brew install imagemagick --with-fontconfig
> brew install giflossy
> npm install -g gifify
  1. Install capa
gem install capa

Usage

capa -o recording -p ios
capa -o recording -p android

capa will generate a video and a GIF from the iOS Simulator or the Android Emulator. capa will try to infer the platform. Alternatively you can select which platform you wish to record in.

Limitations of the screenrecord utility, the Android Emulator recording tool:

  • Audio is not recorded with the video file.
  • Video recording is not available for devices running Wear OS.
  • Some devices might not be able to record at their native display resolution. If you encounter problems with screen recording, try using a lower screen resolution.
  • Rotation of the screen during recording is not supported. If the screen does rotate during recording, some of the screen is cut off in the recording.

You can find all the options from either command with --help

$ capa -h
> capa will generate a video and a GIF from the iOS Simulator or the Android Emulator. 
capa will try to infer the platform. Alternatively you can select which platform you wish to record in.

 Usage: lib/capa.rb [options]
    -o, --output NAME                Output filename. Defaults to recording
    -p, --platform NAME              Available platforms: ios and android
    -v, --version                    Display version
    -h, --help                       Display help

Acknowledgments

This tool is a wrapper around xcrun simctl, adb and gifify

If your pictures aren't good enough, you aren't close enough.

License

capa is released under the MIT license. See LICENSE for details.