Skip to content

Commit

Permalink
update for responsive/flexbox HTML and jquery-enabled functionality
Browse files Browse the repository at this point in the history
  • Loading branch information
whatdoineed2do committed Sep 22, 2017
1 parent abf2ca8 commit 44c45b1
Showing 1 changed file with 5 additions and 2 deletions.
7 changes: 5 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,16 @@
# imgcat / imgprextr

## `imgcat`
## `imgcat` Image Cateloguer

This is a simple multi-threaded command line util that will recursively find image and video files, generating thumbnails for producing an index.html to allow easy browsing. Generated index will link to found files and can (using EXIF data) group equivalant files (ie a RAW file and a generated jpg) together under one image.

The intended use is for cataloguing large collections of images (particularly RAW files) to provide a single index in the form of a index.html; avoid the need for traditional file browsers to attempt to generate it's own thumbnails. This is particularly suited for DVD backups where the thumbnails (ie Windows .thumbs/ dirs) cannot be generated, with the generated index and catalogue being genreated and burned to the same backup. Instead of browsing the individual directories on the DVD (that would potentially cause redundant reads of each file to generate/extract thumbnails to display), we can browse the `index.html` and click through to required files.

For (Nikon NEF/Canon CR2/Fuji RAF) RAW files, the tool will extract the largest embedded thumbnails from the RAW file to generate thumbnail.

The (default) generated HTML is responsive and uses `flexbox` to fit rows of images to browser size with `jquery` providing functionality for navigation between index directories (via `j`/`k` or `left`/`right` arrows) and (XMP) rated files can be display-toggled via `r` or `0`-`5`.

#### Extending for other formats
To recognise other RAW formats, supported by Exiv2, update `main` and `DFLT_EXTNS` along with `ImgExifParser.cc` and the block that assigns `data.type = ImgData::EMBD_PREVIEW`

Sample RAW files available https://rawsamples.ch/index.php/en/
Expand All @@ -17,4 +20,4 @@ Sample RAW files available https://rawsamples.ch/index.php/en/
Command line util to extract largest thumbnail from (Nikon) RAW files; adds functionality not available in `exiv2` or `exiftool` in that this tool can extract the thumbnail and perform colour space conversions (Adobe to sRGB) and also resizing of the images before writing to disk

## Dependancies
Require `ImageMagick`, `exiv2` and `SampleICC` (local copy available) and `ffmpegthumbnailer` development libraries
Require `ImageMagick`, `exiv2` and `SampleICC` (local copy available) and `ffmpegthumbnailer` and `libavformat` (from `ffmpeg`) development libraries

0 comments on commit 44c45b1

Please sign in to comment.