# &app; Manual V&manualversion;

2001
2002
2003
2004
2006
Paolo Bacchilega
GNOME Documentation Project

&legal;

Paolo
Bacchilega

     paolo.bacchilega@libero.it

Alexander
Kirillov
GNOME Documentation Project

     kirillov@math.sunysb.edu

&manualversion;
&date;

Paolo Bacchilega

GNOME Documentation Project

This is manual describes version &appversion; of &appname;

&app; is an image viewer and browser for the GNOME environment

## Introduction

&app; is an image viewer and browser written for the GNOME environment. It lets you browse your hard disk, showing you thumbnails of image files and view single images of many different formats.

The most common image formats are JPEG and GIF. The JPEG format is good for medium and big sized images because it has a high compression rate keeping a good image quality. The GIF format is used in Web pages for displaying little animations or little static images. Another important image format is PNG, this format is very common on Unix platforms and is considered a replacement of the GIF format.

&app; supports all this formats and many others, it also displays GIF animations.

&app; not only lets you view image files but has many other features such as add comments to images, organize images in catalogs, print images, view slideshows, set your desktop background, and more.

## Getting Started

This section provides information on how to start &app;, and describes the main window interface.

### To Start &app;

You can start &app; in the following ways:

Applications menu

  Choose Graphics gThumb.

Command line

  Type `gthumb`, then press Return.

If you start &app; from the command line you can specify the following options:

Command | Explanation
--- | ---
`gthumb folder` | Start &app; in the specified folder
`gthumb name.jpg` | View the image `name.jpg`.
`gthumb *.jpg` | View all the images with a `.jpg` extension.

### When You Start &app;

When you start &app; the following window is displayed:

#### The main window

The main window

The &app; window contains the following elements:

Menubar

  The menus on the menubar contain all of the commands that you can use in &app;

Toolbar

  The toolbar contains a subset of the commands that you can access from the menubar.

Locationbar

  The locationbar contains the current folder name.

Folder list

  The folder list shows the subfolders contained in the current folder.

Image list

  The image list which shows the images in the current folder.

Statusbar

  On the statusbar you can read:

  1. the total number of images contained in the current folder and their total size.

  2. the number of the selected images and their size.

  3. some properties of the currently focused image.

## Browsing Folders

Browser options can be found in the of the Preferences dialog.

Keyboard shortcuts to browse folders are described in .

### To Change Folder

If you want to change folder you have two ways:

1. click on the folder name in the folder list.

2. type the folder name in the location entry.

When using the location entry you can press TAB to try to automatically complete the folder name, this simplify the typing of long names. You can quickly give focus to the location entry pressing Ctrl L.

To go to a previously visited folder you can use the toolbar Back button.

Other navigation commands are located in the View Go menu.

### To Sort Images

To sort images in a different order use the Sort images submenu in the View menu, use Ctrl R to reload the current folder, type T to view or hide the thumbnails in the images list.

### To Add a Folder to the Bookmarks

Frequently used folders can be added to the bookmark list for rapid access. Just go to the folder you want to add to the bookmarks and press Ctrl D or use the command Bookmarks Add Bookmark. To remove or rearrange bookmarks in a different order use the Bookmarks Edit Bookmarks command.

## Working with Folders

&app; offers the functionalities to manage folders.

### WARNING

It's highly suggested to move and copy image folders with &app;. This is because if you move or copy folders with &app; image comments will remain attached to images as you expect, but if you move or copy folders with the file manager or other applications you will lose your comments.

### To Create a Folder

To create a new folder, perform the following steps:

1. Go to the folder where the new folder will be created.

2. Choose File New Folder to display the New Folder dialog.

3. Enter the new folder name.

4. Click on Create. &app; creates a new folder.

### To Open a Folder

To open a folder with the file manager, perform the following steps:

1. Go to the folder you want to open.

2. Choose File Folder Open with the File Manager. &app; opens the folder with the file manager.

### To Rename a Folder

To rename a folder, perform the following steps:

1. Go to the folder you want to rename.

2. Choose File Folder Rename to display the Rename Folder dialog.

3. Enter the new folder name.

4. Click on Rename. &app; renames the folder.

### To Delete a Folder

To delete a folder, perform the following steps:

1. Go to the folder you want to delete.

2. Choose File Folder Move to Trash. &app; moves the folder to the system trash.

### To Copy a Folder

To copy a folder to a different location, perform the following steps:

1. Go to the folder you want to copy.

2. Choose File Folder Copy to display the Copy Folder dialog.

3. The Copy Folder dialog is used to choose the destination folder. You can type the folder name in the Folder entry, or click on Browse to select a folder from your disk. The Recents list contains the list of recently specified destination folders, while the Bookmarks list contains the folders you have a bookmark for. Click on a folder in these lists to insert the folder name in the Folder entry.

4. Click on Ok. &app; copies the folder to the destination folder.

### To Move a Folder

To move a folder to a different location, perform the following steps:

1. Go to the folder you want to move.

2. Choose File Folder Move to display the Move Folder dialog.

3. The Move Folder dialog is used to choose the destination folder. You can type the folder name in the Folder entry, or click on Browse to select a folder from your disk. The Recents list contains the list of recently specified destination folders, while the Bookmarks list contains the folders you have a bookmark for. Click on a folder in these lists to insert the folder name in the Folder entry.

4. Click on Ok. &app; moves the folder to the destination folder.

## Viewing Images

Keyboard shortcuts to view images are described in .

### To View an Image

In order to view an image just click on its thumbnail and the image will be visualized in the viewer pane. If the image doesn't fit the viewer pane you can give more space to the viewer hiding the browser, this can be accomplished double-clicking on the thumbnails or pressing the Return key, pressing it again the browser will be displayed again. Another way of viewing a big image is to view it in full screen mode, type F to activate/disactivate the full screen mode.

Mouse operations :

Holding down the left button and moving the mouse | move the image.
Left-click | Show next image.
Middle-click | Show previous image.
Right-click | Pop up the image menu.

Another way of moving images is by the navigation button : located in the right bottom corner of the viewer window when the images does not fit in the window. Clicking and holding this button will show you a preview of the image. Moving the mouse you will move the image to the desired position.

### To View the Image Properties

To view the image properties, perform the following steps:

1. Select the image.

2. Choose File Properties . &app; displays a Properties dialog.

### To View the Image EXIF Data

To view the exif data attached to an image, use the Properties dialog () or perform the following steps:

1. Select the image.

2. View the image pressing Return or double clicking on it.

3. Choose View View/Hide Image Comment or press I. &app; displays the exif data.

## Working with Images

### To Modify an Image

The current image can be modified in many ways. The commands used to modify an image are located in the Image menu.

Enhance | Enhance the image adjusting the color levels.
Resize | Change the image size performing a zoom in or out.
Crop | Crop the image.
Transform Rotate Right | Rotate the image 90 degrees clockwise.
Transform Rotate Left | Rotate the image 90 degrees counter-clockwise.
Transform Flip | Create a mirror image by reflecting the image scanlines in the vertical direction.
Transform Mirror | Create a mirror image by reflecting the image scanlines in the horizontal direction (as in a mirror).
Desaturate | View the image in black and white.
Negative | View the image negative.
Color Balance | Change the color balancement.
Hue-Saturation | Change the image hue, lightness and saturation level.
Redeye Removal | Remove red eyes caused by poor flashes. See for more information.
Brightness-Contrast | Change the image brightness and contrast.
Posterize | Reduce the number of colors.
Auto Equalize Histogram | Enhance the image equalizing its histogram.
Auto Normalize | Automatically normalize the contrast.
Auto Stretch Contrast | Automatically stretch the contrast.

When an image is modified the label "[modified]" is displayed near the image filename.

#### NOTE

Please note that this modifications do not change the image file. If you want to view the original image just click on its thumbnail again or use the File Revert command.

You can save modified images, see for more information.

#### Redeye Removal

Many inexpensive cameras have a flash that is too close to the camera lens. As a result, the light from the flash may travel from the camera and be partially reflected by a subject's retina right back into the camera lens. This causes "redeye".

&app; provides a tool to remove this unwanted redeye. When viewing an image with redeye, select Image Redeye Removal. A new window will be launched. Move the mouse pointer over top a redeye region, and click on or near it. This should remove the red region, replacing it with a blacker region. If you are unhappy with the result, simply click Undo to revert the previous change (or changes). (Clicking Cancel will abandon all changes and close the window.) Once you are satisfied with the result, you can click on more redeye regions, or click Save or Apply to close the window.

If you click Apply, the image must be re-saved in the usual manner after using Image Redeye Removal. See for more information.

Zoom In, Zoom Out, Actual Size, and Zoom to Fit buttons are provided to allow you to zoom to and from regions of interest. The mouse wheel can also be used to zoom in and out.

### To Save an Image

To save an image, perform the following steps:

1. Display the image.

2. Modify the image (described in ). Of course this step is optional.

3. Choose File Save As.

4. Choose the filename and click on Ok.

5. &app; displays the image format dialog from which you can choose specific file format options. Once you are ok with the options click on Ok. &app; saves the image.

### To Open a Series of Images with Another Program

To open a series of images with another program, perform the following steps:

1. Go to the folder or catalog where the images are.

2. Select the images and choose File Open With to display the Open dialog.

3. Select an application from the Available applications list, or from the Recent applications list; or type a command in the Application entry.

4. Click on Open. &app; opens the images.

### To Rename an Image

To rename an image filename, perform the following steps:

1. Go to the folder or catalog where the image is.

2. Select the image and choose Edit Rename.

3. Enter the new filename and click on Rename. &app; renames the image filename.

### To Delete a Series of Images

To delete a series of images, perform the following steps:

1. Go to the folder or catalog where the images are.

2. Select the images and choose Edit Move to Trash. &app; deletes the images moving them to the system trash.

### To Copy a Series of Images

To copy a series of images, perform the following steps:

1. Go to the folder or catalog where the images are.

2. Select the images and choose Edit Copy to display the Choose the destination folder dialog.

3. Select a folder from the Recents list, or from the Bookmarks list; or type a folder name in the Folder entry.

4. Click on Ok. &app; copies the images.

### To Move a Series of Images

To move a series of images, perform the following steps:

1. Go to the folder or catalog where the images are.

2. Select the images and choose Edit Move to display the Choose the destination folder dialog.

3. Select a folder from the Recents list, or from the Bookmarks list; or type a folder name in the Folder entry.

4. Click on Ok. &app; moves the images.

### To Print a Series of Images

To print a series of images, perform the following steps:

1. Go to the folder or catalog where the images are.

2. Select the images and choose File Print.

3. In the Print dialog there are two tags: Layout and Paper Details.

   From the Layout tag you can

   - Choose the number of images per page.

   - Include the image comment.

   - Rotate an image by clicking on it.

   - Move an image by clicking on it with the left mouse button and dragging it.

   - Resize the image.

   - Recenter the image on the page using the Center on Page button.

   From the Paper Details tag you can

   - Choose the paper format.

   - Choose the paper orientation.

4. When you are ready to print click on Print. &app; prints the images.

## Comments

Comments are pieces of information attached to images.

### WARNING

Comments are not embedded in image files, they are saved separately. This means that if you move images or folders with other programs you will lose the comments.

### FOR EXPERTS

The image comment is saved in a subfolder of the image folder named `.comments`.

### To Add a Comment

To add a comment to an image select the image and choose Edit Edit comment or type C.

Comments are structured in various parts :

- Comment: a free text describing the picture.

- Place: the place the picture represents.

- Date: the date the picture was taken.

Image comments are displayed in the image list in italic text above the image filename. If the comment is too long the simbol "[..]" is appended to the displayed part of the comment to signal you that the comment is not entirely visible, to view the whole comment use the image properties dialog that can be displayed using the File Properties command or pressing I.

#### An image comment

An image comment

#### To Add a Comment to Many Images

To add a comment to many images, select the images and choose Edit Edit comment or type C.

The Comment dialog will fill in the fields that have the same value for all the images leaving all other fields empty.

You can activate the Save only changed fields option (which is active by default) to change one or more fields of many comments leaving all other fields unchanged.

### To Remove Comments

To remove comments, perform the following steps:

1. Go to the folder or catalog where the images are.

2. Select the images and choose Edit Remove comment. &app; removes the comments.

### To View an Image Comment

To view an image comment, use the Properties dialog () or perform the following steps:

1. Select the image.

2. View the image pressing Return or double clicking on it.

3. Press I or choose View View/Hide Image Comment. &app; displays the image comment.

## Categories

Categories are keywords assigned to images and can be used to perform fine grained searches as described in .

### WARNING

Categories are not embedded in image files, they are instead saved separately. This means that if you move images or folders with other programs you will lose your comments.

### FOR EXPERTS

Categories are saved in the subfolder `.comments` of the image folder and in the same file where the image comment is saved.

### To Assign Categories to a Series of Images

To add categories to a series of images, perform the following steps:

1. Select the images and choose Edit Categories . &app; shows the Categories dialog.

2. Check the categories in the Available Categories List. You can create new categories clicking on the New button, and delete categories from the list clicking on the Remove button.

3. Click on Save. &app; assigns the catories to the images.

### To Assign Categories to a Folder

Instead of assigning categories to single images you can assign them to a folder, this is equivalent to assign the categories to all the images contained in the folder and in all of its subfolders.

To add categories to a folder, perform the following steps:

1. Go to the parent folder in order to visualize the folder name in the folder list pane, right-click on the folder name and select the Categories command; alternatively go to the folder and select the File Folder Categories commands. In both cases &app; shows the Categories dialog.

2. Check the categories in the Available Categories List. You can create new categories clicking on the New button, and delete categories from the list clicking on the Remove button.

3. Click on Ok. &app; assigns the catories to the folder.

### To Remove Categories from an Image or a Folder

To remove categories from a series of images or a folder perform the same steps as described above an uncheck the categories you want to remove, the click on Ok to confirm the operation.

## Catalogs

Catalogs lets you organize images without moving them from a folder to another, think of them as "playlists" for images.

Catalogs can be organized in libraries. A library is like a folder that can contain catalogs and other libraries.

### WARNING

Catalogs are not updated when you move images, if you want a more flexible catalog you can use the searches described in , searches are catalogs with search criteria attached, after moving images you can redo the search to get the catalog updated.

### FOR EXPERTS

Catalogs are saved in the `$(HOME)/.gnome2/gthumb/collections` folder.

### To View the List of Catalogs

To view the list of catalogs, perform the following step:

1. Press Alt 2 or choose View Catalogs.

### To View a Catalog

To view the content of a catalog, perform the following steps:

1. Set the catalogs view (described in ).

2. Select the catalog clicking on the catalog name.

If you want to go to the image folder, select the image and use the View Go Go to the image folder command or press Alt End. &app; will display the image folder and will scroll the image list in order to make the image visible.

### To Add Images to a Catalog

To add a series of images to a catalog, perform the following steps:

1. Select the images you want to add to the catalog and choose Edit Add to Catalog.

2. Select an existing catalog or create a new one.

3. Choose Ok. &app; adds the selected images to the catalog.

### To Remove Images from a Catalog

To remove images from a catalog, perform the following steps:

1. Set the catalogs view (described in ).

2. Select the catalog.

3. Select the images you want to delete and choose Edit Remove from Catalog. &app; removes the images from the catalog.

### To Create a Catalog

To create a catalog, perform the following steps:

1. Set the catalogs view (described in ).

2. Choose File New Catalog.

3. Enter the catalog name and click on Ok. &app; creates the catalog.

### To Rename, Remove or Move a Catalog

To rename, remove or move a catalog, perform the following steps:

1. Set the catalogs view (described in ).

2. Select the catalog.

3. Choose the corrisponding command in the File Catalog menu, or use the context menu that can be displayed pressing the right mouse button on the name of the catalog in the catalog list.

### To Create a Library of Catalogs

To create a library of catalogs, perform the following steps:

1. Set the catalogs view (described in ).

2. Choose File New Library.

3. Enter the library name and click on Ok. &app; creates the library.

## Finding Images

### To Find Images

To find images on your hard disk choose Edit Find. &app; displays the Find dialog.

#### To Do a Simple Search

From the Find dialog you can specify a file name or a pattern in the File name entry.

Examples:

Value | Explanation
--- | ---
`foo.jpg` | &app; searches for images named `foo.jpg`
`*.png` | &app; searches for images with the `png` extension.
`*.gif; *.jpg` | &app; searches for images with the `gif` or `jpg` extension.

Click on Search to start the search. Once the search has finished you will see the list of images that matches your search, if you want to see these images click on View, if you want to make another search click on New Search.

If you choose to view the images, a catalog named Search Results will be created and visualized automatically. A catalog created in this way has a special icon, a magnifier, this is because on this type of catalogs you can perform two more operations: Edit Search and Redo Search .

These operations can be selected from the File Catalog menu, or from the menu that pops up when pressing the right mouse button on the catalog name.

The Edit Search command lets you re-edit the search rules, while Redo Search lets you restart the search, at the end of the search you can decide whether to save the result in the catalog or not.

#### Other Search Options

Start at

  The folder where the search will start from.

Include subfolder

  Whether to search even in the sub folders.

Comment

  A list of phrases the comment of the image must contain.

  Examples:

  Value | Explanation
  --- | ---
  `paolo` | &app; searches for images that have "paolo" in the comment.
  `my birthday` | &app; searches for images that have "paolo" in the comment.
  `holiday ; rome` | &app; searches for images that have "holiday" OR "rome" in the comment.
  `holiday in rome; my birthday` | &app; searches for images that have "holiday in rome" OR "my birthday" in the comment.

Place

  A list of phrases the place field of the comment must contain.

  Examples:

  Value | Explanation
  --- | ---
  `rome` | &app; searches for images that have "rome" in the place field.
  `paris; rome; london` | &app; searches for images that have "paris" OR "rome" OR "london" in the place field. place field.

Date

  The criteria the date field of the comment must respect:

  - any: the date field is ignored.

  - before, equal to, after: the date must be less recent, equal to or more recent than the date specified.

Categories

  The list of categories an images must belong to. Categories can be added to images using the Edit Categories command or pressing K.

  You can choose to search for images that belongs to all the specified categories or at least to one of them, checking the corresponding option.

  Examples:

  Value | Explanation
  --- | ---
  `family` | &app; searches for images with "family" as one of their keywords.
  `me; family` | &app; searches for images with "family" and/or "me" in the keywords list.

##### NOTE

If you use more than one criteria images must respect all of them.

##### NOTE

The search is always case insensitive.

### To Find Duplicated Images

To find duplicated images, choose Edit Find Duplicates.

## Slide Shows

You can start a slide show of the images in the current folder by pressing s or selecting the View Slide Show menu item. To stop the slide show press S again.

If the current selection contains two or more images the slide show will be done only with the selected images, otherwise all of the images in the current folder or catalog will be showed.

Switching on/off the full screen mode does not stop the slide show. If the Switch to full screen option is on then the slide show is started in fullscreen mode and exiting from the fullscreen mode will stop the slide show.

The slide show is interrupted when you change folder or re-load the current one.

With the slideshow tool and the fullscreen mode you can do presetations. There are two types of presentations: automatic presentations and manual presentations.

### How To Do an Automatic Presentation

To do an automatic presentation, perform the following steps:

1. Go to the folder or catalog containing the images you want to present.

2. Select the images you want to view in the slideshow, or select none to view all the images in the current folder or catalog.

3. Press S or choose View Slide Show . &app; starts an automatic presentation of the images.

To stop the presentation press S or Q or Esc.

The slide show behaviour can be personalized from the Preferences dialog in the

### How To Do a Manual Presentation

To do a manual presentation, perform the following steps:

1. Go to the folder or catalog containing the images you want to present.

2. Select the image from which you want to start the presentation.

3. Press F. &app; displays the image in fullscreen mode.

4. Press Space or N. &app; displays the next image.

5. Press BackSpace or B. &app; displays the previuos image.

To stop the presentation press Q or Esc.

## Advanced Tools

### To Set the Desktop Wallpaper

If you want to set an image as desktop wallpaper, select the image and choose the menu Tools Set Image as Wallpaper. This menu contains the following items:

- Centered: The image will be centered on the screen.

- Tiled: The image will be duplicated on the screen as tiles on the floor.

- Scaled: The image will be scaled to fill the screen mantaining the aspect ratio.

- Stretched: The image will be scaled to fill the screen changing proportions if needed.

If you want to restore the old wallpaper choose Tools Set Image as Wallpaper Restore .

### To Rotate Images Without Loss of Quality

Usually if you want to rotate an image you have to open the image with an editor, rotate the image, and then save it. This works well for image formats such as PNG or GIF, but results in a loss of quality for JPEG images. (The rotation functions in Image Transform operate this way - with loss.)

If you want to rotate JPEG images without losing image quality, select the images you want to rotate and choose Tools Rotate Images. &app; displays the Rotate Images dialog.

Click on Apply to apply the changes. The files are automatically saved after clicking Apply.

If you check the Apply to all images option, the rotation is applied to the currently displayed image as well as to all the remaining images you have selected; otherwise, once the rotation has been performed on the current image, the next image in the selection is displayed, and you can choose another type of rotation.

#### NOTE

If the selection contains some non-JPEG images, they are rotated as well. (Not all file formats are supported, however.)

In general, there are two ways to rotate a JPEG image. The first way is to re-arrange the pixels inside the image file, using a "physical" transform. The second way is to leave the image data alone, and simply change the value of the Exif orientation tag inside the header of the JPEG file. Not all JPEG files have Exif tags however, and not all applications support them. If your image does not have Exif tags, the pixels will be re-arranged inside the image file automatically, since that is the only possible method.

If your image has an Exif orientation tag, and the Apply physical transform checkbox is enabled, the physical transform will be used to re-arrange the image data, and the Exif orientation tag will be reset to its default value of "top left".

If your image has an Exif orientation tag, and the Apply physical transform checkbox is not enabled, then only the orientation tag will be changed. The raw image data itself will not be transformed.

#### NOTE

For maximum compatibility with other applications, it is recommended that the Apply physical transform checkbox normally be enabled in both the rotation and import dialogs.

The physical transform of pixel data inside the JPEG file will not degrade image quality (that is, it is lossless) under most conditions. However, if the image dimensions (height and width) are not both multiples of 8, some data corruption will occur along one or two of the edges of the image. If there is an Exif orientation tag, you can avoid this problem by disabling the Apply physical transform checkbox. If you must use the physical transform approach with images whose dimensions are not multiples of 8, &app; will allow you to proceed despite with possible image distortion, but it will also ask if you would like the trim the image slightly (by up to 7 columns and/or rows of pixels) to remove the problem areas.

### Resetting the Exif Orientation Tag

The previous section describes how JPEG images can be rotated using two methods (physical transforms or Exif orientation tag changes). &app; supports both methods properly as of version 2.9.0. Some previous versions of &app; auto-rotated images improperly when importing, by performing a physical transformation without resetting the Exif orientation tag to "top-left". These previous versions ignored the orientation tag when displaying the images, so no problem was apparent (although the problem was visible if other image viewers were used to view the same images). Versions 2.9.0 and later respect this tag, so the incorrect rotation will be visible.

The Reset Exif orientation tag tool is provided to fix this problem. Simply select the affected images, and apply the Reset Exif orientation tag tool. This will reset the Exif orientation tag to "top-left".

### To Convert the Image Format

To convert the image format, select the images you want to convert and choose Tools Convert Format.

The Convert Format dialog offers you the following options:

- Image type: this is the format you want to convert images into.

- Overwrite mode: a converted image has the same name of the original image except for the extension which is determined by the new format, so an image with the new name can already exist in the destination folder. This option lets you decide what to do when such a case occurs. If you choose skip the new image won't be created; rename will ask you to specify a new name; ask will ask you whether to overwrite the old image or not and overwrite will overwrite the old image without asking.

- Remove original: lets you remove the original image. If an image is not converted because of an error it will not be removed.

To perform the conversion click on Convert.

### To Scale a Series of Images

To scale multiple images downwards in size, select the images you want to scale and choose Tools Scale Images.

The Scale Images dialog offers you the following options:

- Width: The desired maximum width of the scaled images.

- Height: The desired maximum height of the scaled images.

- Keep aspect ratio: If this checkbox is not enabled, the image may be stretched by different factors in the horizontal and vertical directions, in order to achieve both the specified width and height. This may result in a distorted image. If this checkbox is enabled, the image will be scaled by the same factor in both directions. The scaling factor will be calculated such that the output width and height are both equal to or less than the values specified in the Width and Height boxes, respectively.

- Image type: this is the format you want to save the scaled images as.

- Overwrite mode: a scaled image has the same name of the original image except for the extension which is determined by the new format, so an image with the new name can already exist in the destination folder. This option lets you decide what to do when such a case occurs. If you choose skip the new image won't be created; rename will ask you to specify a new name; ask will ask you whether to overwrite the old image or not and overwrite will overwrite the old image without asking.

- Remove original: lets you remove the original image. If an image is not converted because of an error it will not be removed.

To perform the scaling click on Scale.

### To Rename a Series of Images

To rename a series of images specifing a name template, choose Tools Rename Series.

The name template is simply a name that must be used for all of the images, furthermore you can use some special characters to make the new names differ each other:

Symbol | Description
--- | ---
# | This symbol will be replaced with the value of a counter that increments itself by 1 passing from one image to another. If you specify this symbols in sequence you'll get leading zeros if the counter value has a lesser number of digits, for example ### will produce the sequence: 001, 002, 003, etc..
%f | This symbol will be replaced with the image original name, excluding the extension.
%e | This symbol will be replaced with the image original filename extension.
%d | This symbol will be replaced with the image modified date.
%s | This symbol will be replaced with the image dimensions.

The list at the bottom of the dialog displays how the filenames will be renamed.

To rename the images click on Rename.

If the renaming of an image can overwrite an already existing image you will be asked how to proceed, five options are available: overwrite the image; do not overwrite the image; always overwrite; never overwrite; specify a new name.

### To Change Images Date

If you want to change the last modified date of a series of images, select the images and choose Tools Change Date.

Select the new date.

Click on Ok. &app; changes the date.

### To Create an Index Image

An index image is an image that contains small previews of a series of images. If you want to create an index image select the images you want to insert and choose Tools Create Index Image.

### To Create a Web Album

To create a web album, view a folder or a catalog and select the images that you want to include in your album. (The usual selection methods apply - you can click to select one image, shift+click or shift+arrow to expand the selection continuously, ctrl+click to add images one at time, ctrl+A to select everything.) Then use the Tools Create Web Album function.

The web album will be generated in the Destination folder. The starting page of the album will be given by the Index file setting - "index.html" is typically used.

All web albums will consist of one or more "index pages" (which show a series of small thumbnail images) and one or more "image pages" (which show a single image at a time). If the Copy originals to destination checkbox is enabled, the photo shown in the image pages will link to a copy of the original image. If you click this link, the raw image will be loaded in your browser (with no accompanying HTML).

If desired, images can be scaled down if they exceed a certain size defined in the Resize if larger than box.

The number of thumbnail images shown on each index page of the web album is controlled by the Size row and column boxes. Alternatively, all images can be forced onto a single index page by enabling the use a single index page checkbox.

Most themes will respect the row and column settings that you specify, because they are based on HTML tables. However other themes (the BestFit theme for example) use Cascading Style Sheets that automatically space the images to make the best possible use of space. (If you resize the browser window, the images will re-position themselves!) These themes will not respect the row and column settings, but they will keep the total number of images per index page to a maximum of ROW x COLUMNS (unless the use a single index page checkbox is enabled).

A Header and Footer may be defined. These labels will appear at the top and bottom of every page in the album. HTML markup may be used in headers and footers, as long every '>', '<', and '&' character is preceeded by a backslash. For example, "<hr/>" must be written as "\<hr/\>". Also, the sequence "%d" will be replaced by the current date. To make a literal backslash ('\') or percent symbol ('%') appear in the output, it must be entered as "\\" or "%%" in the header or footer fields.

A Theme must be specified. The Theme controls the overall appearance of your web album. To select a Theme, press the ... button and select one from the list. The Thumbnail Caption and Image Caption dialogs allow you to specify what textual information (photo date, image size, camera model, etc) will be displayed next to each image in the index and image pages, respectively.

### To Import Photos from a Digital Camera

To import photos from a digital camera, choose File Import Photos .

Several options are presented in the File Import Photos dialog.

The destination folder can be selected through the Destination box. The photos will be imported into a sub-folder of the Destination folder. The name of the sub-folder is set by the Film box. If no "Film" folder is specified, a sub-folder name consisting of the import data and time will be automatically generated.

Categories can be specified for the imported photos using the Categories box.

If the Delete imported images from the camera checkbox is enabled, the photos will be deleted from the camera after they have been imported.

&app; will rename the images (in numerical re-order) when they are imported, unless the Keep original filenames checkbox is selected.

If the Rotate images physically checkbox is selected, and the imported photo contains an Exif orientation tag, the image data will be physically transformed (losslessly) so that the viewed image looks the same as before but the orientation tag is reset to "top left". If this checkbox is not enabled, the image data and the orientation tag are both left unchanged. The image will be displayed identically by gthumb for both possibilities, but for maximum compatibility with other applications this checkbox should be enabled.

#### Selecting the Camera Model

&app; should auto-detect your camera (if it is turned on) when you launch the File Import Photos dialog. If it does, a camera icon will be displayed in the dialog box. If not, a camera with an "X" through it will be shown.

If the wrong camera has been detected, click the camera icon to select a different one. A drop-down box listing all auto-detected cameras will be shown. If the Use manual selection instead checkbox is enabled, the user can manually set the camera model and port.

### To Write Images to a CD or DVD

To write a series of images to a CD or DVD, perform the following steps:

1. Select the images you want to write to and choose File Write to CD , &app; displays the Write to CD dialog.

2. Click on Current folder if you want to write all of the images in the current folder and its subfolders. Click on Selected images to write the current selection only.

3. Click on Ok. &app;, after preparing the images for CD/DVD writing, displays the `burn:///` location with Nautilus.

4. Click on the Write to CD toolbar button or choose File Write to CD . Images are written to the CD or DVD.

## Preferences

To configure &app;, open the Preferences dialog by choosing Edit Preferences .

This dialog contains four tabs described in detail below. At the bottom of the dialog window, you'll find the following buttons:

- Help: shows this manual.

- Close: closes the dialog.

Keep in mind that when you change an option it will automatically applied, this is why there is no Ok or Apply button.

### General Tab

This tab allows you to set the following options:

- Select the layout of &app; main window, i.e. the positions of directory list window, the image (thumbnail) list window, and the main image viewer window.

- The toolbar style

- Directory to show on startup

- Whether to ask confirmation when an image or a catalog will be deleted.

- Whether to ask to save a modified image.

### Browser Tab

In this tab, you can configure the following options:

Show filenames

  This option controls whether &app; should show image filenames.

Show comments

  This option controls whether &app; should show comments (including date and place) in the image list. By default, &app; shows the comment as a caption under the thumbnail.

Show thumbnails

  This option (which you can activate simply pressing T) controls whether &app; should show thumbnails.

Other

  Here you can choose whether to change folder by doing a single or a double click on the folder name. The single click can be useful if you are used to quickly browse your hard disk searching for images. The default behaviour is to follow the Nautilus file manager policy. Furthermore you can select whether &app; should determine image type by looking at the file extension or by looking at the file content. Determining file type from the content is more reliable (some applications may create files with extension not matching the actual file type) but slower. If you have a fast system, select Determine image type from content.

### Viewer Tab

This tab contains options for viewer window:

After loading an image

  Controls initial zoom level to use for an image.

Transparency type

  Controls the background used for partly transparent images. By default the transparent part of the image is replaced the window background color,that is the none option.

Zoom quality

  This controls the method used for showing rescaled image. Possible choices are high quality (slow on old machines or when viewing big images) and low quality (always fast).

Scrollbar positions after using Next/Previous

  Depending on the selected zoom level, your images may be larger than the display window. If this happens, vertical and/or horizontal scrollbars will be present, allowing you to view different areas of your image.

  When you navigate from one image to another using the Next/Previous controls, the positions of the scrollbars can be retained, or they can be reset to the default position.

  If you are viewing pages of scanned text, for example, you will probably want to set this to Reset to top-left of image, so that the top of the page is shown when you move to a new image.

  If you are trying to compare small areas on several large images (perhaps to compare similar images taken at different times, such as photos taken in a "continuous" mode on a digital camera, or satellite images of the same area at different dates) then the Keep same position mode is probably more appropriate for you.

### Slide Show Tab

This tab contains the options controlling slide show mode (which you can start by selecting Tools Slide Show or by using S shortcut). The options include direction (forward/backwards/random), and delay between images. You can also specify whether the slide show should wrap around (i.e., after showing the last image start again form the beginning) and automatically switch to fullscreen mode.

### Hot Keys Tab

This tab contains the shell script definitions that control the hot keys 0-9 on the numeric keypad.

When a user presses one of these keys, an external shell script will be launched. Certain codes can be including in the script. These codes will be replaced by &app; when the script is actually launched, as follows:

Code | Explanation
--- | ---
%F | all selected filenames on one line, space delimited
%f | a single filename, including path
%n | a single filename, including path, with no extension
%e | a single extension (starting with a period)
%p | the parent folder of the single file

Scripts with the %F code will be executed just once, regardless of the number of files selected. All other scripts will be executed once per selected file.

Several default scripts are provided. These can be replaced by the user, if desired. The default scripts are explained below:

- `gimp %F &`

  This script tells the GNU Image Manipulation Program (gimp) to open all of the select files. This is most efficient if we include all of the filenames on one line, rather than calling `gimp` once for each file, so we have used the %F code.

- `convert %f -font Helvetica -pointsize 20 -fill white -box '#00000080' -gravity South -annotate +0+5 ' Copyright 2007, Your Name Here ' %n-copyright%e`

  This script makes a copy of your image file, and adds a copyright notice to it. The "convert" command is part of the ImageMagick package. If the original file is named sample.jpg, the new file will be named sample-copyright.jpg.

- `mkdir -p %p/approved ; cp %f %p/approved/`

  This script creates a new sub-folder called "approved", if it does not exist already. It then copies the select files to the "approved" sub-folder.

- `uuencode %f %f | mail -s Photos your@emailaddress.com`

  This script encodes images files in a format suitable for email attachments, and then emails each photo to the specified address. One email per photo is sent.

- `rm ~/myarchive.zip; zip -j ~/myarchive %F`

  This script overwrites an existing zip file, if present, with a new zip file containing the selected images.

- `rm ~/myarchive.zip; zip -j ~/myarchive %F; uuencode ~/myarchive.zip ~/myarchive.zip | mail -s Photos your@emailaddress.com`

  This combines the previous two scripts, so that the selected images are combined into a single zip file, which is then emailed.

## Quick Reference: Keyboard Shortcuts

, , and provide a quick reference for all of the &app; keyword shortcuts. Look in the menus for other shortcuts.

### Keyboard shortcuts to navigate folders

Keyboard Shortcut | Description | Available in Fullscreen Mode
--- | --- | ---
n or Space or Page Down | View the next image. | yes
b or Backspace or Page Up | View the previous image. | yes
Home | View the first image. | yes
End | View the last image. | yes
Alt Home or h | Go to your Home folder. | no
Alt Left | Go to the previously visited folder. | no
Alt Up or u | Go up one level. | no
Esc | Interrupt thumbnails creation. | no
Ctrl D | Add the current location to the bookmarks. | no
Return | View/Hide the browser. | no
q | Change the image properties pane content or display the pane if it is not visible. | no
Ctrl 1 | Set the image preview as the image properties pane content or hide the pane if this content type is already visible. | no
Ctrl 2 | Set the image exif data as the image properties pane content or hide the pane if this content type is already visible. | no
Ctrl 3 | Set the image comment as the image properties pane content or hide the pane if this content type is already visible. | no
t | View/Hide the thumbnails. | no
F2 | Rename the current image. | no
o | Open the selected images with an application. | no
g | Open the selected images with the GIMP, if installed. | no
Delete | Delete the selected images. | yes

### Keyboard shortcuts to view images

Keyboard Shortcut | Description | Available in Fullscreen Mode
--- | --- | ---
v or f or F11 | Set/Unset the full screen mode. | yes
+ or = | Zoom in. | yes
- | Zoom out. | yes
1 or z | Actual size. | yes
x | Zoom to fit. | yes
l | Flip the image. | yes
m | Mirror the image. | yes
r | Rotate the image clockwise of 90 degrees without saving. | yes
e | Rotate the image counter-clockwise of 90 degrees without saving. | yes
] | Rotate and save the image clockwise of 90 degrees. The rotation is lossless for jpeg images. | yes
[ | Rotate and save the image counter-clockwise of 90 degrees. The rotation is lossless for jpeg images. | yes
a | Start/Stop the animation | yes
j | View the next frame of a stopped animation. | yes
Arrows | Scroll the image. | yes
Shift Arrows | Scroll the image faster. | yes

### Other keyboard shortcuts.

Keyboard Shortcut | Description | Available in Fullscreen Mode
--- | --- | ---
s | Start/Stop the slideshow. | yes
c | Add a comment to the selected images. | yes
k | Assign categories to the selected images. | yes
i | Hide/Show the image comment and properties | yes

### Keyboard shortcuts available exclusively in fullscreen mode

Keyboard Shortcut | Description
--- | ---
p | Pause/Resume a slideshow.
Escape or f or v or F11 or q | Exit the fullscreen mode.