Webnail Documentation

Webnail outputs images as thumbnails

Download

webnail.sh is here; it's released under the GPL v3 license.

What is it

Webnail is a bash script (ie a Gnu/linux program) that also depends on ImageMajick, which will come preinstalled on most linux systems. It has three main areas of use:-

1. It can produce a page to be displayed by a web server
2. It can keep track of a collection of images on a desktop machine
3. It provides a quick way to prepare you photos for use by the PhotoAlbum web app.

In the second case the links are specified as absolute rather than relative paths and these are displayed as hovertips to aid location of the image on disc.

Features

• Many options - configured by editing the variables at the top of the webnail.sh script or by copy and pasteing the variable section from the script into a webnailrc file in the working directory.
• Very simple to install - just copy the file to /usr/local/bin and make sure it's executable.
• Simple to use - webnail.sh <directory with images>.
• The thumbnails can link to scaled quality/size images for quick loading or to the original image, or you can have both links, ie thumbnails to scaled and a text link to original image
• The software can create info files which you can edit in a wysiwyg fashion (no mark up needed). There is an example of a page using info files here.
• To caterlogue images on a local machine ("B" above). the software can recurse into sub directories to a specified depth.
• can work with most image formats jpg, png, bmp, ico and gif

Options

These are the configurable variables:-
A local webnailrc file (in the working directory) overrides settings in the script; create this by copying the marked section from the script into a new file named "webnailrc", located in the top level directory with the images.

• TNROW set the number of thumbs per row
• quality and size options for thumbs and medium sized images
• filename and title, background and foreground colours of the html page
• INFO - uncomment this to get .info files
• SCALE and FULL uncomment one or both of these to get links to scaled and original images
• DEPTH - this must not be uncommented for a page to be displayed by a web server; this ensures relative rather then absolute paths and no hovertips of file locations
• DEPTH must be uncommented for a local page - set to desired recurse level (0 = no sub directories to be searched)

Bugs

Please let me know.

webnail.sh is also part of the PhotoAlbum project, the main feature of which is a java web app. It can be seen in action here.