https://github.com/robflaherty/picture-show
Command line tool for sharing photo albums
https://github.com/robflaherty/picture-show
Last synced: 6 months ago
JSON representation
Command line tool for sharing photo albums
- Host: GitHub
- URL: https://github.com/robflaherty/picture-show
- Owner: robflaherty
- Created: 2019-09-17T15:28:27.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-09-07T16:27:03.000Z (almost 4 years ago)
- Last Synced: 2025-03-18T11:35:26.270Z (over 1 year ago)
- Language: SCSS
- Homepage:
- Size: 11.9 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Picture Show
A command line tool for generating a photo gallery from a folder of images.
[Demo Gallery](https://major9th.s3.amazonaws.com/picture-show/dyc56nxw2949/index.html)
## Installation
`npm install -g picture-show`
## Usage
Pass Picture Show a folder of images and tell it where to export the gallery to. Picture Show will resize the images to a set width (default is 1400px) and copy them into a new folder, named with a random string, along with the gallery HTML/CSS/JS. The original images will not be modified.
The image resizing library does not support HEIC so if exporting from Apple Photos make sure to export JPGs.
The script checks the Exif data for creation date (using `DateTimeOriginal`) and sorts by date.
`$ picture-show [source images dir] [export dir]`
Example: `$ picture-show ~/Desktop/photoFolder ~/Desktop`
### Options
`--show-date` : add this flag to display the photo creation date in the gallery
`-w [width in px]` : sets the width of the photos. default is 1400
Example with options: `$ picture-show ~/Desktop/photoFolder ~/Desktop -w 2000 --show-date`
### Credits
[blueimp Gallery](https://github.com/blueimp/Gallery) for the front end. [Sharp](https://github.com/lovell/sharp) for image resizing. [jpeg-exif](https://github.com/zhso/jpeg-exif) for reading exif data. [minimist](https://github.com/substack/minimist) for parsing command line arguments. [fs-extra](https://github.com/jprichardson/node-fs-extra) for file manipulation.