Skip to content
Records Gifs Of Selected App Window.
JavaScript Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.documentary/section-breaks
.vscode
Documentary
doc
example
src
test
.alamoderc
.eslintignore
.eslintrc
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
open_chrome.js
package.json
yarn.lock

README.md

appshot

npm version Build Status

yarn add global appshot

# or
npm i -g appshot

A CLI tool to record GIFs of apps on MacOS.

The result of the recording:
appshot output
Click to View: apphost -a Code -t appshot
Alt: How the recording looks.

Table Of Contents

ImageMagic convert

The convert utility from ImageMagic library should be installed to allow saving optimized GIFs.

brew install imagemagic

Otherwise, un-optimized records can be taken with -g flag.

CLI

After installing globally, the program can be run from the command line. The app name and the window title should be passed with the -a and -t arguments to start the recording of the required window.

appshot -a Application -t part_of_window_title

Otherwise, just part of the window title can be passed as the command when only one window with such title exists.

appshot README.md

If more that one window is found, the recording won't start.

List Windows: --list, -l

Only list the open windows without capturing a gif. Display the window's ID, App, title and PID.

appshot -l
┌────────┬──────────────────┬────────────────────────────────────────┬────────┐
│ winid  │ app              │ title                                  │ pid    │
│ 84     │ Flux             │ Item-0                                 │ 912    │
│ 61     │ SystemUIServer   │ AppleClockExtra                        │ 346    │
│ 49     │ SystemUIServer   │ AirPortExtra                           │ 346    │
│ 92     │ Tunnelblick      │ Item-0                                 │ 1058   │
│ 157    │ AAM Updates Not… │ Item-0                                 │ 2771   │
│ 86     │ Evernote Helper  │ Item-0                                 │ 911    │
│ 35     │ SystemUIServer   │ AppleTimeMachineExtra                  │ 346    │
│ 39     │ SystemUIServer   │ AppleBluetoothExtra                    │ 346    │
│ 43     │ SystemUIServer   │ AppleVolumeExtra                       │ 346    │
│ 57     │ SystemUIServer   │ BatteryExtra                           │ 346    │
│ 53     │ SystemUIServer   │ AppleTextInputExtra                    │ 346    │
│ 65     │ SystemUIServer   │ AppleUser                              │ 346    │
│ 30     │ Spotlight        │ Item-0                                 │ 371    │
│ 21     │ SystemUIServer   │ NotificationCenter                     │ 346    │
│ 3      │ Window Server    │ Menubar                                │ 209    │
│ 151    │ Code             │ index.md — appshot                     │ 333    │
│ 99     │ Google Chrome    │                                        │ 337    │
│ 98     │ Google Chrome    │ artdecocode/appshot: Records Gifs Of … │ 337    │
│ 272    │ Terminal         │ doc — -bash — 131×21                   │ 339    │
│ 76     │ Sketch           │ Welcome to Sketch                      │ 340    │
│ 4      │ Window Server    │ Backstop Menubar                       │ 209    │
│ 33     │ Finder           │                                        │ 347    │
│ 14     │ Dock             │ Desktop Picture - DefaultDesktop.heic  │ 345    │
│ 2      │ Window Server    │ Desktop                                │ 209    │
└────────┴──────────────────┴────────────────────────────────────────┴────────┘
Click to View: apphost -l
Alt: Displaying the list information once.

--app, -a

Filter by the name of the application.

--title, -t

Filter by the title of the window. Same as passing the title as the first argument.

--wait, -w

Delay in seconds before the recording starts.

--file, -f

Path to the file. If none specified, a prompt will be displayed.

--delay, -d

How often to take screenshots. Defaults to 1 second.

--resize, -z

Resize to this width, keeping height proportionate.

--colors, -c

How many colors to use in the output gif.

--dir, -D

Directory in which to save the gif.

--gifsicle, -g

Save in un-optimized gif format. This can be used when imagemagic is not installed, however not recommended as the image size is not optimal.

--max, -m

Capture this number of frames at maximum and stop recording.

--chopTop, -T: Chop Top

How many pixels to take off top of each image. Pass 23 value (on non-retina displays) to remove the window headers, which can change title or status and lead to de-optimisation.

Copyright

(c) Art Deco 2018

You can’t perform that action at this time.