JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 5
  • Score
    100M100P100Q60761F
  • License MIT

Present histograms (bars!) of images in a directory, including extras such as exif data from the camera.

Package Exports

  • chocolate-bars

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (chocolate-bars) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🍫 chocolate-bars readme

Present histograms (bars!) of images in a directory, including extras such as exif data from the camera. Star and move favorite images.

Electron based app - so, it runs on node.js.

status - stable

chocolate-bars is stable on Windows (Linux, Mac possible but not tested). Releases follow semantic versioning.

Travis node

Greenkeeper badge Dependencies Dev Dependencies

npm Package NPM Downloads

styled with prettier semantic-release

License: MIT Donate

why?

Histograms are useful for finding image defects such as:

  • over-exposure
  • under-exposure
  • low contrast

Also was curious how to implement this in node.js.

Also, I really miss the 'moved starred images' feature of good ole' Picasa

dependencies

  • Node 8.11.3 or higher

features

  • scan a folder of images and present a browsable summary
  • show image thumbnails and histogram
  • show additional image properties such as file size, image size
  • show exif tags where available (JPEG files)
  • 'star' images in a folder like in Picasa
  • move previously 'starred' images to a new folder

usage - as cli (command line tool)

1. Install dependencies

Install:

  • Yarn
  • Node 8.3.11 (or higher)

2. Get chocolate bars (histograms) of images

Screenshot

ways to run

You can run chocolate-bars in one of two ways:

  • a) as a globally installed command line tool
  • OR b) from the source code
a) install globally as a command line tool

npm i -g electron@4

npm i -g chocolate-bars@latest --production

To use:

chocolate-bars <path to image direcory>

b) from the source code
yarn

On Windows: use a bash shell like git bash.

To test your installation:

./test.sh

To check your images:

./go.sh <path to image direcory>

example:

./go.sh ../myPhotos

To see more detailed usage info:

./go.sh

keyboard shortcuts

When an image is expanded by clicking on the small orange box in the top-right, a number of keyboard shortcuts can be used:

Key Action
* or Enter Toggle the star for that image.
Left Arrow Show the previous image.
Right Arrow Show the next image.
Escape Close the expanded image.

references

electron starter

https://github.com/electron/electron-quick-start

electron and react boilerplate

https://github.com/iRath96/electron-react-typescript-boilerplate

https://github.com/electron-react-boilerplate/electron-react-boilerplate

sites

site URL
source code (github) https://github.com/mrseanryan/chocolate-bars
github page https://mrseanryan.github.io/chocolate-bars/
npm https://www.npmjs.com/package/chocolate-bars

developing code in this repository

see the contributing readme.

origin

This project is based on the excellent seeder project typescript-library-starter.

ORIGINAL readme (from the seeder project)

see here

authors

Original work by Sean Ryan - mr.sean.ryan(at gmail.com)

licence = MIT

This project is licensed under the MIT License - see the LICENSE file for details