GIMP Indexprint/Contactsheet plugin

What is indexprint/contactsheet?

Quick overview Indexprint

Examples of Indexprint usage

Default indexprint. Images are complete printed	Indexprint used as a mosaicprint
Indexprint with ratio 1:1 choosen. Images are cropped.	Indexprint with ratio 16:9 choosen. Images are cropped.
Indexprint with ratio 16:9 and rotate images checked. Images are cropped.	....

Download section

Known problems and limitations

1. Printing with GIMP (windows version) gives a rightshift of the indexpage for unknown reasons. Use Gutenprint plugin instead. This is not directly related to the indexprint plugin. Remember indexprint print option uses only the standard printerdriver from Gimp not Gutenprint.
2. LIMITATION v3.21: don't use ONLY spaces in the header/title text, indexprint will stop. Keep it empty/blank if you don't want a title.
3. LIMITATION v3.xx: Window will not resize when you are working with a screen height of 800 px or less use v2.xx or use contactsheet-smallscreen instead (only downloadable from my website).

1. Printing with GIMP (windows version) gives a rightshift of the contactpage for unknown reasons. Use Gutenprint plugin instead. This is not directly related to the contact sheet plugin. Remember contactsheet print option uses only the standard printerdriver from Gimp not Gutenprint.
2. If you are working with a white foreground in your work your text will not be displayed because the background is also white. A possible work around is to disable the WHITE_FILL line in the code or use v3.xx instead.
3. Fixed Bug "type-error" encoutered when working with newer software. This apllies also to contactsheet-smallscreen.

Version history

1. Wish: sorting on exif information
   
2. Necessary: main window changing to notebook to overcome screenproblems
   

1. ADDED: added focal length (19 aug).
   
2. ADDED: JPEG XR (.wdp;.hdp;.jxr) support added (aug). Install XR plugin needed.
   
3. Fixed: type error on Linux (Ubuntu): int expected got float
   

1. ADDED: added capabilities for RAW formats. To make use of it install UFRAW v1.18 for Gimp: http://registry.gimp.org/node/31
   The following RAW formats are supported although not all tested.
   
   • Panasonic: RW2 fully tested
   • Canon: CRW, CR2 (CR2 tested by Andre Kroon)
   • Nikon: NEF
   • Pentax: PEF
   • Sony: SR2, ARW
   • Fuji: RAF
   • Samsung: PEF
   • Adobe: DNG
   Remember if Gimp can read the raw format so can indexprint. Please drop a line if your camera (and extension) is not metioned in the above list but recognized by Gimp I have to add the raw format extension(s) for your camera.
   Raw formats are big so it will take time to make an indexprint be patient.

1. ADDED: more exif information: iso, speed and F-number
2. CHANGE: version w/o exif and w exif now combined. If no exif support is installed 'include exif' tab will be grayed out.
3. Fixed: header cannot contain spaces only without chrashing
4. Fixed: not correct working switch
5. Fixed: several typos

1. Fixed: In version 2.30 "you get an error if you leave the Header blank." Put at least a character in this line. Read also the known limitations.

1. ADDED: exif date and time (pyexiv2 should be installed!!).
2. ADDED: title on each page.
3. ADDED: background color can be changed.
4. CHANGE: pagenumber from top to bottom; you can give a start pagenumber.
5. CHANGE: new Dutch translations.
6. Fixed: "not reading foreign characters" now also for Linux users.
7. Fixed: "not remembering last state for Linux users" now also for Linux users.
8. Fixed: custom papersize is now working.

1. Changed structure for easier installation: now one step installation.
2. 29/10: Released Dutch manual revision 1.1.
3. Added remember plugin setting between sessions.
4. Fixed "not reading foreign characters".
5. Fixed no problems with non-image files with image extensions (i.e. readme.jpg); error are reported in an error.log
6. Pagecounter now equal to filecounter (request G.Sprik)
7. Now possible to select on a piece of the filename (request G.Sprik)
8. Added a config dir for storing the configuration.
9. Added a errorlog dir, necessary for windows because print doesn't work.
10. New dutch translation file
11. Several other small changes has been made

1. This is the initial release.
2. Same features as contactsheet v2.xx and more.
3. Dutch translations available (you can't use the translations from v2.xx).
4. Solved the smallscreen problem: plugin has is own GUI.
5. Uses Python v2.6 and GTK+ 2.16 or above. It's possible that you have to install it.
6. Uses tooltips for easy help.
7. Dutch manual available.

1. Fixed Bug "type-error" encoutered when working with newer software. This applies also to contactsheet-smallscreen.

1. Fixed "not reading foreign characters". Now also for Linux users

1. Fixed "not reading foreign characters".
2. Fixed no problems with non-image files with image extensions (i.e. readme.jpg).
3. Pagecounter now equal to filecounter (request G.Sprik)

1. Added several new papers including two bannertypes.

1. Added option to disable the extension to print. Useful if you wish only a name to the photo. I used it to print a lot of passport photographs (classroom of my child) on a single sheet.
2. Added French language pack v1.0. Thanks to Hervé for the French translation.
3. Updated Dutch language pack v1.4.
4. Updated localization file.

1. Added .bmp support.
2. Updated Dutch language pack v1.3.
3. Updated localization file.

1. Added simple printing capabilities. You have to experiment with your printer for the best results. Very important: the plugin uses the default Gimp builtin printer driver (will be changed in future releases). Unfortunatly I cannot set any of the parameters (pagesize, margin, etc) you have to set the parameters of your printer first :(. Set margins in your printerdriver to zero and choose your correct papersize.
2. Added .ps/.eps support. The special .ps/.eps version of contactsheet has been removed. Remember to add ghostview/ghostscript to GIMP if you want to select an .eps/.ps type image otherwise contactsheet refused to work. For this reason selecting "all registered types" in imagetypes will exclude .ep/.eps types of images.
3. Fixed: "Under certain conditions it was possible that not all possible rows were placed on contactsheet". Problem has been solved.
4. Code has been partly rewritten.

1. Fixed: "It is possible that not all possible rows are placed on the contactsheet. These rows are placed on the next contactsheet." A miscalculation has been corrected. It was only visible when a large number of images per row was choosen without the filename option.
2. Margin round the image can now be changed in tenth of a mm.
3. Maximum number of images per row has been increased to 256.
4. Maximum number of rows has been increased to 256.
5. Maximum number of DPI has been increased to 1000.

1. A little 'error' (a testlog command has not been set to off) has been corrected, nothing else has been changed. Look for "../tmp/gimp.log" on your system, delete this file.

1. Fixed: "Set topmargin at least 5 mm otherwise contactsheet page will not be visible." Topmargin can now be as low as possible. It is the user responsebility to take care of the printable margin. For instance my printer (HP CP1700d) the left-right margin should be set at least 5mm otherwise that part of the image wil not be printed.
2. Fixed: "Textfile (if option is checked) is not emptied wih each batch run so it will grow to infinity. You have to manually empty/delete this file." Textfile is now emptied before information is written.

1. Margin round the image can now be changed from zero on.
2. Added "sorted images" as option.
3. Updated Dutch language pack to v1.2.
4. Updated localization file.
5. Fixed: "Files with an extension .j .jp .jpe .p .pc .t .ti .x .xc .pn , will be seen as images. If it is not a imagefile the plugin stops. Remove/move/rename all files with those extensions." It is not longer necessary to remove these files.

1. Margin round the image can now be changed.
2. Font size can now be choosen. Be aware that fontsize automatically will be scaled down to fit the image width.
3. Added .XCF support.
4. Added a choice to save a text filelist from the printed images with the directory name where the image is located. Useful if you have a lot of images in several directory's. Name is the same as the contactpage name but with the .TXT extension.
5. Code has partly been rewritten.

1. Dutch language pack added.

1. Now possible to make contactsheet of a whole directory including subdirs.
2. Two radiobuttons replaced by option buttons.
3. Added several paperformats, including lettersized papers.
4. Images are sorted in the way the systems sort the images.
5. Added extension in the filename.
6. Added support for pcx format.
7. Added making contactsheets of all registered formats in one batch.
8. Number of rows is now limited to paperheight (automatic scaled down if necessary).
9. Images are automatically scaled and symmetrically placed within square minipages.
10. Contactsheet modified to work also on Gimp version 2.6.

1. Robin Gilham has made his final release of contactsheet only working up to Gimp version 2.4. From this version I (Elmar) have build version 2.xx

Installation notes

Windows XP users

• First install Python
• Restart system.
• Install pygtk, pygobject, pycairo.
• Restart system, on most systems not necessary.
• (Re)install GIMP
• Install language pack (contactsheet.mo) into the GIMP locale directory ([drive]:\Program Files\GIMP-2.0\share\locale\[your language dir]\contactsheet.mo
• Install your plugin into: [drive]:\Documents and Settings\[user]\.gimp-2.6\plug-ins\contactsheet.py. The plugin is now only available for you.
• It's possible that you have to set your LANG environment system variable. Open control panel -> system -> system properties -> environment Variables -> add system variables: LANG with value [your language code] (mine is 'nl').

• First install Python 2.6.6
• Restart system.
• Install pycairo-1.8.6-py26 (http://www.pygtk.org/downloads.html)
• Install pygobject-2.20.0-py26
• Install pygtk-2.16-0+glade.win32-py26 (there are two versions of it: one with and one without glade, use the one with glade: http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.16/)
• Restart the system, on most systems not necessary.
• (Re)install GIMP 2.6.10/11
• Unzip the contents of the zip file into: [drive]:\Documents and Settings\[user]\.gimp-2.6\plug-ins\ folder. The plugin is now only available for you.
• Copy "libglade-2.0-0.dll" in the Gimps bin folder or but not recommended put the file in the system32 folder (http://ftp.acc.umu.se/pub/gnome/binaries/win32/libglade/2.6/ or search it on your system).
• Restart Gimp.
• Enjoy indexprint.
• =====
• Optional: using ps/eps files install ghostscript/ghostview. You can find it here: http://www.ghostscript.com or http://pages.cs.wisc.edu/~ghost/
• Optional: using exif data install pyexiv2. Download it from http://tilloy.net/dev/pyexiv2/download.html --> windows section. But use only installer version 0.2.2 NOT 0.3.0 !!
• Optional: using RAW files UFRAW must be installed. Download UFRAW v1.18 for Gimp: http://registry.gimp.org/node/31 (For RW2 use v1.18 or newer).
• Optional: using JPEG XR you must first install the JPEG XR plugin from the registry (http://registry.gimp.org/node/25508).

Windows Vista users:

Windows 7 users:

LINUX users

• Install python (2.6.5/2.6.6)
• Copy the plug-in contactsheet.py to /home/[user]/.gimp-2.6/plug-ins/ or for all users: /usr/lib/gimp/2.0/plug-ins/
• Make the plug-in executable with chmod +x /home/[user]/.gimp-2.6/plug-ins/contactsheet.py or chmod +x /usr/lib/gimp/2.0/plug-ins/contactsheet.py or use a filemanager to make it executable.
• Copy language file (contactsheet.mo) in /usr/share/locale//LC_MESSAGES/ (i.e. /usr/share/locale/fr/LC_MESSAGES/ for French). Thanks to Luc Novales for a updated howto install.

• Install python (2.6.5/2.6.6)
• Unzip the contents of the zip file into /home/[user]/.gimp-2.6/plug-ins/ or for all users: /usr/lib/gimp/2.0/plug-ins/
• Make the plug-in executable with chmod +x /home/[user]/.gimp-2.6/plug-ins/indexprint.py or chmod +x /usr/lib/gimp/2.0/plug-ins/indexprint.py or use a filemanager to make it executable.
• =====
• Optional: using ps/eps files install ghostscript/ghostview. You can find it here: http://www.ghostscript.com or http://pages.cs.wisc.edu/~ghost/
• Optional: using exif data install pyexiv2. Download it from http://tilloy.net/dev/pyexiv2/download.html --> Linux distribution section. Ubuntu users should use the packagemanager.
• Optional: using RAW files install UFRAW v0.18.
• Optional: using JPEG XR you must first install the JPEG XR plugin from the registry (http://registry.gimp.org/node/25508).

MAC users

To Do/Wishlist

• Bugfixes only, no other plans.

• A French translation file: help will be grateful.
• A German translation file: help will be grateful.
• suggestion: adding more exif data but which ??
• From Vincent: adding focal length
• suggestion: adding a simple pageborder/photoborder ??
• Other suggestions
• From Vincent: sorting on date, focal length, exif information, etc.

Windows release of printer-help

Contact information