Simple tool for for image indexing and organization.
The program scans the filesystem for image files and stores information about found images in CouchDB database. It identifies duplicate images using md5 sum and groups them together.
It can also
- Copy files to target directory, organized by image creation date
- Remove source file - provided copy exist
- Place a link to target directory in place where source file was
This is still work in progress, use at own risk.
Image organizer requires exiftool to analyze images.
Install
npm install -g image-organizer
Run
image-organizer <parameters>
| Short | Long | Type | Default | Description |
|---|---|---|---|---|
| -a | --address | url | - | Database URL |
| -c | --copy | flag | false | Copy documents to destination |
| -r | --remove | flag | false | Remove Source Files |
| -l | --links | flag | false | Create Source Links |
| -u | --update | flag | false | Update mode |
| -x | --skip-scan | flag | false | Disable Scan Mode |
| -t | --target | path | - | Target directory |
| -p | --paths | glob[] | - | Paths to scan |
| -m | --mime | pattern[] | ['image/**] | Mime types of files to process |
| -v | --verbose | flag* | 0 | Verbosity mode |
The image organizer is constructed from series of simple streams which process file records in turn.
Fetches documents matching supplied path from CouchDB and emits one message per matching file. Step enabled by update mode.
Prints path of the processed file. Enabled on verbosity 1 and greater.
Checks if file is still present on the disk and if it is a symlink.
Lists files matching supplied path. Step enabled by scan mode.
Calculates md5sum of file.
Determines exif data of file using exiftool.
Rejects files not matching specified mime types.
Looks for file in CouchDB by md5sum. If not found initializes new document.
Calculates target file location using creation date and original file name.
Copies file to the target location. Acts only if source file exist and target file does not exist. Step enabled by copy flag.
Removes source file. Acts only if source file exist and target file exist. Step enabled by remove flag.
Creates link to target file in original location. Acts only if source file does not exist and target file exist. Step enabled by link flag.
Updates file status in document.
Updates document in CouchDB. In case of conflict merges changes.