Skip to content

screenshot tools for take and merge on android, ios(simulator and device), windows, macos(fullscreen and region only) and linux

License

Notifications You must be signed in to change notification settings

jerson/screenshot-tools

Repository files navigation

Screenshot tools

Commands to take captures easily on android and ios and combine them with an easy interface and with support for Windows, Linux and macOS.

Requirements

  • For Android screenshots is required adb
  • For iOS device screenshots is required Xcode and Automator
  • For iOS simulator screenshots is required Xcode and Automator

Install

Install supports Linux and MacOS with homebrew

brew install jerson/tap/screenshot-tools

Download

just download in release section https://github.com/jerson/screenshot-tools/releases

Build

requires Go to compile

git clone https://github.com/jerson/screenshot-tools.git
cd screenshot-tools
make install

screenshot-tools

Command line

NAME:
   Screenshot Tools

USAGE:
   screenshot-tools [global options] command [command options] [arguments...]

VERSION:
   0.1.0

COMMANDS:
   help, h  Shows a list of commands or help for one command

   debug:
     dump-config, dc  dump-config
     report, r        report

   evidences:
     merge-images, m  merge-images
     compress, c      compress

   screenshot:
     screenshot-session, ss  screenshot-session
     screenshot, s           screenshot

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

Screenshot session

NAME:
   screenshot-tools screenshot-session - screenshot-session

USAGE:

screenshot-session
screenshot-session name

CATEGORY:
   screenshot

DESCRIPTION:
   start session for take many screenshots

OPTIONS:
   --adb value, -a value          ADB path used when platform=android (default: "adb")
   --automator value, --au value  Automator used when platform=ios (default: "/usr/bin/automator")
   --platform value, -p value     Platform: ios,android,ios-simulator,desktop (default: "android")
? Name: sample session

 Insert key for do things:
 ------------------------
 help:
	C: capture screenshot
	E: capture desktop screenshot
	M: merge screenshots and close
	D: delete last screenshot
	L: list captured screenshots
	R: reset all captured screenshots
	A: add custom screenshot from filesystem (beta)
	Q: quit
	H: print help

	Note: keys are case sensitive

INFO[0008] new screenshot: sample session/sample session_01.png
INFO[0009] new screenshot: sample session/sample session_02.png
List:
[
 "sample session/sample session_01.png",
 "sample session/sample session_02.png"
]
Removed last: sample session/sample session_02.png
INFO[0014] new screenshot: sample session/sample session_02.png
Merged images:
Output file: sample session.png

Output

Sample output

Screenshot

NAME:
   screenshot-tools screenshot - screenshot

USAGE:

screenshot
screenshot "sample name"

CATEGORY:
   screenshot

DESCRIPTION:
   capture screenshot

OPTIONS:
   --adb value, -a value          ADB path used when platform=android (default: "adb")
   --automator value, --au value  Automator used when platform=ios (default: "/usr/bin/automator")
   --platform value, -p value     Platform: ios,android,ios-simulator,desktop (default: "android")