# photoanalysis

> Analyze a directory of photos for emotion, age, gender, and ethnicity. Output results to CSV.

Latest version **1.0.2** (published 2017-01-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install photoanalysis
pnpm add photoanalysis
yarn add photoanalysis
bun add photoanalysis
```

Provides the command `photoanalysis`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.2 |
| Published | 2017-01-31 |
| First published | 2017-01-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 11 |
| Known vulnerabilities | 0 (+63 in 2 direct dependencies) |
| Install scripts | no |
| Author | Chris Roth |
| Maintainers | cjroth |

## Links

- npm: https://www.npmjs.com/package/photoanalysis
- Repository: https://github.com/cjroth/photoanalysis
- Homepage: https://github.com/cjroth/photoanalysis#readme
- Issues: https://github.com/cjroth/photoanalysis/issues
- npm.io page: https://npm.io/package/photoanalysis

## Dependencies (11)

- [async](https://npm.io/package/async.md) ^2.1.4
- [dottie](https://npm.io/package/dottie.md) ^2.0.0
- [moment](https://npm.io/package/moment.md) ^2.17.1
- [big-csv](https://npm.io/package/big-csv.md) ^0.0.1
- [electron](https://npm.io/package/electron.md) ^1.4.15
- [minimist](https://npm.io/package/minimist.md) ^1.2.0
- [progress](https://npm.io/package/progress.md) ^1.1.8
- [username](https://npm.io/package/username.md) ^2.3.0
- [socket.io](https://npm.io/package/socket.io.md) ^1.7.2
- [webrtc-adapter](https://npm.io/package/webrtc-adapter.md) ^3.1.0
- [socket.io-client](https://npm.io/package/socket.io-client.md) ^1.7.2

## Recent versions

- 1.0.2 (latest) — 2017-01-31
- 1.0.1 — 2017-01-29
- 1.0.0 — 2017-01-29

## README

# Photo Analysis

![](screenshot.png)

This is Node.js command line tool that analyses a directory of photos of your face for emotion, age, gender, and ethnicity and outputs the result to a CSV file. Currently it uses [Affectiva](http://www.affectiva.com/) for analysis but I plan on adding support for [Microsoft's Emotion API](https://azure.microsoft.com/en-us/services/cognitive-services/emotion/) and possibly others in the future.

I originally built this as part of a larger project to analyze [Lifeslice](http://wanderingstan.github.io/Lifeslice/) photos and show emotional changes over long periods of time. If you are interested in hearing more about that project or helping out, I am actively looking for volunteers to contribute their CSV results! Contact me at [chris@cjroth.com](mailto:chris@cjroth.com) for more info.

It will work with any directory of photos - not just Lifeslice photos - you will just need to configure the filename formats to work with other patterns (see `analyzer.html`). It currently detects a photo's date from the filename pattern instead of the file's created-at date.

The tool works by launching a hidden [Electron](http://electron.atom.io/) window to run the Affectiva library in and render photos.

## TL;DR:

Input:
![](screenshot-photos.png)

Output*:
![](screenshot-csv.png)

\* No, Affectiva isn't trying to do some sort of weird affirmative action... it's just bad at detecting ethnicity... or I'm just a really funny looking white guy 👨

# Install

You must have Node >= 6.0.0 installed.

`npm install -g photoanalysis` (you may need to run this with sudo if you get a permission error)

# Run

Assuming you haven't changed Lifeslice's default photo directory, it will work out of the box and output a CSV file of results to your Desktop:

`photoanalysis`

Input directory:

`photoanalysis -i ~/custom/photo/directory`

Custom output file:

`photoanalysis -o ~/custom/output.csv`

Debug mode:

`photoanalysis -d`

If you stop the process and then start it again, it will pick up where it left off.

---
_Source: https://npm.io/package/photoanalysis · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
