Features

Twig is an image gallery program. You have a directory with subdirectory structure with images. Twig generates for each image 3 levels of diminished images and 3 level of thumbnails:

Level	Size
0	64x64
1	128x128
2	256x256
3	35%
4	50%
5	71%

Twig keeps a clickable structure of HTML files, each directory has an own HTML page with listing and each file has own HTML page with links to various sizes of the images under thumbnails and with EXIF information and image comment.

Twig can work with JPG and PNG images. Maybe also with GIFs but I am not sure ;-)

If you change anything in the gallery (add directories, files, change files, delete files), you just need to rerun the "regen" script. Twig automatically detects all changes and updated in the HTML structure. Thumbnails and scaled down images are automatically regenerated if needed. Most time-intensive work is however not done if not necessary.

Identifiers

Twig assigns every image an unique hexadecimal identifier. If an image is deleted, the identifier remains unused. Twig is written with 128 bits allocated for the identifier, so it is physically impossible to exhaust the identifiers.

The purpose of the identifiers is to allow simple linking of images from webpages with just specifying the identifier. The identifiers are stored in tns/database which is in GDBM format. Back up this file frequently as damage to it can destroy all the image links on your website.

Comments

JPEG comments of the JPEG images are parsed. The part of the comment up to first newline is displayed under the image thumbnail in directory listings. The whole comment is then displayed on the image's own HTML page. Newlines in the comment are replaced by paragraph separators.

Atomicity

Updating the gallery is atomic. If you run the update and break it in the middle, you don't get an inconsistent state. Regenerated thumbnails and downsized images are moved to the destination immediately, the rest is put into a directory aside and then moved at once.

Ronja

Twig was written for the Ronja website. If the directory name is "ronja" (now I don't remember if it works only for toplevel or also for lower levels), the HTML pages will be generated with a heading of Ronja and Twibright labs logo.

Download

Download twig.tgz.

Requirements

You need the following software to run Twig:

Linux or OpenBSD. You can try on different unix-like system and report errors if it doesn't work for you.
ImageMagick (works with 6.2.8) with PNG support - the "convert" and "identify" commands are used.
jhead (works with v2.2)
Idependent JPEG Group libjpeg - the "rdjpegcom" program is used.

Installation

Create a directory for your images (let's call it "grxmaster").
Put the Twig files into grxmaster: Makefile, data.c, data.h, findscript, foder.gif, index_template.html, manager.c, mvscript, regen, rmscript.
Rename index_template.html to index.html and perform changes you want.
Go into grxmaster and type "make". If the compilation blows up, complain to the author (see contact below).

Usage

Create directory grxmaster/images.
Put your images into grxmaster/images. You can create subdirectories inside the images directory and put some images into them if you want to organize your images into subdirectories.
Go into grxmaster and run the "regen" script. It can take some time.
Now load grxmaster/index.html into your web browser and you are already viewing your gallery
To link to a directory, first find the directory from index.html. The hexadecimal identifier will be in the heading of the directory, example: [1552]. To link to this directory, use .../grxmaster/tns/1552.html.
Link to images the same way as to a directory, just use the identifier from the image page where it is printed in the heading too.
To refer to thumbnails, use grxmaster/tns/lvl0/1552.html, where lvl0 can be replaced by lvl0-lvl5, depending on the size you want.

Author, contact

Twig was written by Karel 'Clock' Kulhavy, Write bugreports to this e-mail: Warning: Missing argument 2 for _insertimage(), called in /home/clock/www/twibright.com/ronja/utils/twig/index.php on line 117 and defined in /home/clock/www/twibright.com/ronja/obr.php on line 31 Notice: Undefined variable: alt in /home/clock/www/twibright.com/ronja/obr.php on line 33 Warning: getimagesize(/home/clock/www/twibright.com/ronja/grx/spam@spam.com): failed to open stream: No such file or directory in /home/clock/www/twibright.com/ronja/obr.php on line 20

Licence

Twig is under GPL.

Internal doc

Thumbnail directories

Thumbnail directory name	Size
lvl0	64x64
lvl1	128x128
lvl2	256x256
lvl3	35%
lvl4	50%
lvl5	71%

Twig program documentation