yarn add global appshot
# or
npm i -g appshot
A CLI tool to record GIFs of apps on MacOS.
The result of the recording: |
|---|
Click to View: apphost -a Code -t appshot
|
The convert utility from ImageMagic library should be installed to allow saving optimized GIFs.
brew install imagemagicOtherwise, un-optimized records can be taken with -g flag.
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.
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
|
Filter by the name of the application.
Filter by the title of the window. Same as passing the title as the first argument.
Delay in seconds before the recording starts.
Path to the file. If none specified, a prompt will be displayed.
How often to take screenshots. Defaults to 1 second.
Resize to this width, keeping height proportionate.
How many colors to use in the output gif.
Directory in which to save the gif.
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.
Capture this number of frames at maximum and stop recording.
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.
(c) Art Deco 2018
