picconv is a script for creating HTML thumbnail galleries, written in Ruby.
picconv can be used to create a HTML thumbnail gallery out of a directory containing images of any type. You only have to provide an input and an output directory, while picconv takes care of everything else. However, you may provide more options to get a customized output.
picconv requires a Ruby interpreter, the standard UNIX tool file and the tool convert from the ImageMagick package. If you want to use the option --use-exif you need the program exif.
picconv was tested with Ruby 1.8 under Linux only.
| Argument types | |
|---|---|
| STRING | A free-form string. May be surrounded by ' or ". |
| INT | An integer value. |
| DIR | Like STRING, but represents an exisiting directory. |
| SIZE | A string in the form INTxINT, i.e. 500x500. |
| HEXCOL | A hexadecimal color value, i.e. #123456 or #abcdef. |
| Required arguments | |
| --in-dir DIR | Directory where the original images reside. |
| --out-dir DIR | Output directory for newly created files. |
| Optional arguments | |
| --im-size SIZE | Size for newly created fullsize images. Default: 640x640. |
| --im-qual INT | Quality for newly created fullsize images. Default: 80. |
| --im-prefix STRING | Prefix for newly created fullsize images. Default: [empty]. |
| --im-suffix STRING | Suffix for newly created fullsize images. Default: [empty]. |
| --tn-size SIZE | Size for newly created thumbnail images. Default: 0 (no thumbnails are created). |
| --tn-qual INT | Quality for newly created thumbnail images. Default: 40. |
| --tn-prefix STRING | Prefix for newly created thumbnail images. Default: tn_. |
| --tn-suffix STRING | Suffix for newly created thumbnail images. Default: [empty]. |
| --gal-file STRING | Filename for the HTML file. Default: index.html. |
| --gal-title STRING | Title for the HTML gallery. Default: HTML Thumbnail Gallery. |
| --gal-desc STRING | Description for the gallery. Will be enclosed by p tags. Default: [empty]. |
| --gal-pprow INT | Pictures per row in the HTML gallery. Default: 5. |
| --gal-gzip INT | Defines if the gallery file should be compressed. Default: 0, interpreted as uncompressed. Other allowed values are 1 (compressed) and 2 (compressed and uncompressed). |
| --col-bg HEXCOL | Specifies the background color. Default: #cccccc. |
| --col-text HEXCOL | Specifies the text color. Default: #000000. |
| --col-link HEXCOL | Specifies the color of unvisited links. Default: #0000ff. |
| --col-alink HEXCOL | Specifies the color of active links. Default: #ff0000. |
| --col-vlink HEXCOL | Specifies the color of visited links. Default: #990099. |
| --comment STRING | Adds the given string to the comment field in the image. |
| --interlace | Creates interlaced images. |
| --use-exif | Fetches EXIF datetime information and displays it in the gallery. |
| --use-names | Use original names for newly created images instead of numbering. |
| --no-convert | Disables conversion of original images. |
| --conv-opts | Additional options for convert. |
| --conv-opts-fs | Additional options for convert (fullsize images only). |
| --conv-opts-tn | Additional options for convert (fullsize images only). |
| --quiet | Surpresses all messages going to STDOUT. |
picconv does overwrite files in out-dir.
picconv is released under the MIT license. See the file LICENSE included in the archive for details.
picconv is (c) 2003-2005,2006,2007 Robert Weiler.
The following current releases of picconv are available for download:
Older versions may be found in the release directory.
a digiGeek.net project