by: Robert Harder
Capture Images from the Command Line
ImageSnap is a Public Domain command-line tool that lets you capture still images from an iSight or other video source.
ImageSnap is included in various package managers such as Homebrew and MacPorts.
The easiest way to install
imagesnap is probably with one of those commands
brew install imagesnap.
You can also simply copy the binary
imagesnap file to someplace on
your path like
/usr/local/bin, or leave it in a "current directory," and
call it with
./imagesnap instead. If your download has a version number
appended to it like
imagesnap-0.2.10 then I recommend you rename it
The first time you use the tool, you may get a popup window from MacOS
asking to give
imagesnap permission to access the camera.
To capture an image simply run the program from the command line. There is a delay of a few seconds while the camera warms up, and then...snap!
$ imagesnap Capturing image from device "iSight"..................snapshot.jpg
To specify a filename, make that your last argument:
$ imagesnap icu.jpg Capturing image from device "FaceTime HD Camera (Built-in)"..................icu.jpg
If you have multiple video devices attached to your computer, use the
("el") flag to list them:
$ imagesnap -l Video Devices: => EpocCam => OBS Virtual Camera => Logitech BRIO => FaceTime HD Camera (Built-in) => USB 2.0 Camera
To select a specific video device use the -d device flag with the full or partial name of a device:
$ imagesnap -d BRIO Capturing image from device "Logitech BRIO"..................snapshot.jpg
You can capture a series of images in a timelapse using the
The following command would take a picture ever 60 seconds:
$ imagesnap -d BRIO -t 60 Capturing image from device "Logitech BRIO"..................snapshot-00001.jpg snapshot-00002.jpg snapshot-00003.jpg
There is a default warmup period of three seconds (new to version 0.2.13) when you take a picture. This gives the camera time to get its sensors all set up. Your camera might have a faster or slower response time, so you can adjust the warmup period to suit your needs.
$ imagesnap -d BRIO -w 0 Capturing image from device "Logitech BRIO"..................snapshot.jpg
Only JPEG output is supported.
- v0.2.16 - Added ability to specify directory where timelapse images will be saved.
- v0.2.15 - Added
-nflag to limit the number of timelapse pictures. Also changed first timelapse image numbering to start at one instead of zero.
- v0.2.14 - Bump to fix distribution problems only
- v0.2.13 - Default warmup period is now three seconds. Set
-w 0if you want no delay.
- v0.2.12 - Supports native M1. Other tweaks for package managers.
- v0.2.11 - Some documentation updates and preparing for better integration with package managers like Homebrew and MacPorts
- v0.2.10 - Fixed bug when showing Capturing image with xxx...snapshot.jpg
- v0.2.9 - When doing timelapse, sequence numbers will pick up where the last filename left off.
- v0.2.8 - Removed timestamp from filename when doing sequence of images with
- v0.2.7 - When specifying a device with the
-dflag, substrings are matched if an exact match is not found. Some cleanup in the code for modern Xcode versions. Verified on Mojave and Big Sur
- v0.2.6 - Unknown point release four years before v0.2.7 - I don't know what it was.
- v0.2.5 - Added option to delay the first snapshot for some time. Added a time-lapse feature (thanks, Bas Zoetekouw).
- v0.2.4 - Found bug that caused crash on Mac OS X 10.5 (but not 10.6).
- v0.2.4beta - Tracking bug that causes crash on Mac OS X 10.5 (but not 10.6).
- v0.2.3 - Fixed bug that caused all images to be saved as TIFF. Not sure when this bug was introduced.
- v0.2.2 - Added ability to output jpeg to standard out. Made executable lowercase imagesnap.
- v0.2.1 - Changed name from ImageCapture to ImageSnap to avoid confusion with Apple's Image Capture application.
- v0.2 - Multiple file formats (not just TIFF). Faster response.
- v0.1 - This is the initial release.
A Note About Public Domain
I have released this software into the Public Domain. That means you can do whatever you want with it. Really. You don't have to match it up with any other open source license — just use it. You can rename the files, do whatever you want. If your lawyers say you have to have a license, contact me, and I'll make a special release to you under whatever reasonable license you desire: MIT, BSD, GPL, whatever.