https://github.com/monkeydom/sightsnap
Command line utility to grab webcam images (also great for time lapse)
https://github.com/monkeydom/sightsnap
Last synced: about 1 year ago
JSON representation
Command line utility to grab webcam images (also great for time lapse)
- Host: GitHub
- URL: https://github.com/monkeydom/sightsnap
- Owner: monkeydom
- Created: 2013-03-29T18:50:45.000Z (over 13 years ago)
- Default Branch: develop
- Last Pushed: 2018-09-06T21:49:12.000Z (almost 8 years ago)
- Last Synced: 2025-04-01T16:55:53.891Z (about 1 year ago)
- Language: Objective-C
- Size: 183 KB
- Stars: 49
- Watchers: 7
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# sightsnap - an OS X command line utility to snap webcam images
## Design Goals
* no memory leaks - suitable for long time time lapsing
* add text overlays or timestamps
## Requirements
* Mac OS X 10.8 or higher, 64-bit only
## Download Binary
* [sightsnap v0.6](http://cl.ly/1Q2G1l0v1E2W/download/sightsnap.zip)
## Examples
### Lol-Commits including emojiis and repo information
* [lolcommit-hook.rb](https://github.com/monkeydom/sightsnap/blob/develop/examples/lolsnapcommit-hook.rb)
## What's new
* mp4 creation on time lapse (currently without additional text overlays)
* extended the --time option to take a total time for image sequence grabbing to make e.g. animated gifs
* updated the post commit hook example to make animated gifs using ffmpeg
## License
* [MIT](http://www.opensource.org/licenses/mit-license.php)
## Usage
```
sightsnap v0.6 by @monkeydom
usage: sightsnap [options] [output[.jpg|.png]] [options]
Default output filename is signtsnap.jpg - if no extension is given, jpg is used.
If you add directory in front, it will be created.
-l, --listDevices List all available video devices and their formats.
-d, --device Use this . First partial case-insensitive
name match is taken.
-t, --time Takes a frame every seconds and saves it as
outputfilename-XXXXXXX.jpg continuously. Stops after seconds if given.
-z, --startAtZero Start at frame number 0 and overwrite - otherwise start
with next free frame number. Time mode only.
-m, --mp4 Also write out a movie as mp4 with the timelapse directly. Time mode only.
-k, --skipframes Skips frames before taking a picture. Gives cam
warmup time. (default is 2, frames are @6fps)
-j, --jpegQuality JPEG image quality from 0.0 to 1.0 (default is 0.8).
-x, --maxwidth If image is wider than px, scale it down to fit.
-y, --maxheight If image is higher than px, scale it down to fit.
When and are given, the camera format used is optimized.
-p, --timeStamp Adds a Timestamp to the captured image.
-o, --onlyOneTimeStamp Freeze the TimeStamp to the first value for all images.
-T, --title Adds to the upper right of the image.
-C, --comment Adds to the lower left of the image.
-f, --fontName Postscript font name to use. Use FontBook.app->Font Info
to find out about the available fonts on your system
(default is 'HelveticaNeue-Bold')
-s, --fontSize Font size for timestamp in px. (default is 40)
-h, --help Shows this help.
To make timelapse videos use ffmpeg like this:
ffmpeg -i 'sightsnap-%07d.jpg' sightsnap.mp4
To make animated gifs use:
ffmpeg -r 10 -i Test3-%07d.jpg -vf 'scale=768:-1' test3.gif
```
**Special consideration**: if your texts might start with a '-' then you need to use the alternative syntax. E.g. for the comment area `-C='-text that starts with a hyphen'`
## Acknowledgements
* uses [ArgumentParser](https://github.com/NSError/ArgumentParser)
## Created by
@monkeydom [twitter](http://twitter.com/monkeydom) [adn](http://alpha.app.net/monkeydom)