# &app; Manual V&manrevision;

## Introduction

The &app; application is a fast and powerful graphical file manager for the Gnome desktop environment, it has a "two-pane" interface in the tradition of Norton and Midnight Commander. &app; provides the following features:

- GTK-2 GUI with standard mouse interactions

- Gnome MIME types

- FTP using GnomeVFS ftp module

- SAMBA access

- Right click mouse menu

- User defined context menu

- Quick device access buttons with automatic mounting and unmounting

- Latest accessed folder history

- Folder bookmarks

- Plugin support

- Fast file viewer for text, images and image meta data (Exif and IPTC)

- Tools for advanced renaming of files, searching, quick file name search in current dir, symlinking, comparing directories

- Integrated command line

- Support for over 30 languages.

This is a note.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

- Choose Accessories GNOME Commander .

Command line

- To start &app; from a command line, type the following command, then press Return:

  `gnome-commander`

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; Start Up Window

Shows &app; main window. Contains titlebar, menubar, toolbar, display area, and scrollbars. Menubar contains File, View, Settings, and Help menus.

The &app; window contains the following elements:

Menubar.

- The menus on the menubar contain all of the commands you need to work with files in &app;.

Toolbar.

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

Statusbar.

- The statusbar displays information about current &app; activity and contextual information about the menu items.

## Usage

You can use the &app; application to perform the following tasks:

- gnome-commander-open-image

- gnome-commander-manipulate-view

- gnome-commander-scroll-image

- gnome-commander-close-image

### To Open an Image

To open an image, choose File Open Image . The Open Image dialog is displayed. Select the file that you want to open, then click OK. To open another image in a new window, choose File Create New Window . Choose File Open Image to select the file that you want to open. You can also drag an image from another application such as a file manager to the &app; window. If the &app; window is empty, the application displays the image in the window. If the window is not empty, the application starts a new window to display the file. The application displays the name of the image file and the size of the image in pixels in the titlebar of the window.

If you try to open an image file format that &app; does not recognize, the application displays an error message.

This is a caution.

### To Manipulate the View of an Image

You can use the following methods to resize the view of an image in the &app; window:

- To enlarge the view of an image, choose View Zoom In .

- To shrink the view of an image, choose View Zoom Out .

- To view the image at its actual size, choose View Zoom 1:1 .

- To enlarge or shrink the view of an image so that the image fits the &app; window, choose View Fit to Window .

- To enlarge or shrink the image to a specific zoom factor, choose View Zoom factor , then choose the appropriate zoom factor from the drop-down list.

- To display the image in full screen mode, choose View Full Screen . Full screen mode displays the image in a window that fills the full screen. The window does not contain a window frame, titlebar, menubar, or toolbar. To exit from this mode, press the Esc key or Ctrl W .

This is a tip.

### To Scroll an Image

To scroll around an image that is larger than the image window or full screen window, you can use the following methods:

- Use the arrow keys on the keyboard.

- Drag the image in the opposite direction to the direction in which you want to scroll. For example, if you want to scroll down the image, drag the image upwards in the window.

- Use the scrollbars on the window.

### To Close an Image

To close an image, choose File Close This Window . If the window is the last &app; window open, the application exits.

To quit &app; and close all of the windows that you opened in the current session, choose File Exit .

This is a warning.

## Settings

To configure &app;, choose Settings Preferences . The Preferences dialog contains the following tabbed sections:

- gnome-commander-prefs-display

- gnome-commander-prefs-viewers

### Display

Interpolation type

- Use this drop-down list box to specify the interpolation method that &app; uses when the application resizes images. Select one of the following options:

  - Nearest neighbor

    This method of interpolation takes a location in the original image and replicates the pixel that is nearest to this location. When you zoom in on an image, the pixels are replicated. When you zoom out of an image, the image loses some of its detail.

  - Bilinear

    This is a simple and fast method of interpolation. When you zoom in on an image, &app; uses up to four adjacent pixels to compute the colors of the new pixels. When you zoom out of an image, &app; averages regions of color in the existing image to compute the colors of the pixels.

  - Hyperbolic

    This is a high-quality, slow method of interpolation. The application performs interpolation on the image in the manner described in Digital Image Warping by George Wolberg.

  Default: Nearest neighbor.

Transparency type

- Use this drop-down list box to specify how &app; displays transparent or partially opaque backgrounds in images. Select one of the following options:

  - Dark checks

    This option displays black and dark gray checks.

  - Midtone checks

    This option displays dark gray and light gray checks.

  - Light checks

    This option displays light gray and white checks.

  - Black only

    This option displays solid black.

  - Gray only

    This option displays solid gray.

  - White only

    This option displays solid white.

  Default: Dark checks.

Check size

- Use this drop-down list box to specify the size of the checks to use to display transparent or partially opaque backgrounds in images. This option is only relevant if you choose Dark checks, Midtone checks, or Light checks from the Transparency type drop-down list box. Select one of the following options:

  - Small

  - Medium

  - Large

  Default: Small.

Dither type

- Use this drop-down list box to specify the dithering method to use to display images. Dithering is a technique that is used to simulate colors in the original image file but that your system can not display. Select one of the following options:

  - None

    This option does not use dithering.

  - Normal (pseudocolor)

    This option performs dithering on pseudocolor displays, which use a limited palette of colors.

  - Maximum (high color)

    This option performs dithering on pseudocolor and high color displays.

  Default: None.

Two-pass scrolling

- Select this option to render an image in two passes when you scroll the image quickly. The first pass renders a low quality version of the image. The second pass renders a full quality version of the image over the low quality version. Two-pass scrolling enables you to view at least a low quality version of the image at all times regardless of how quickly you scroll the image.

  Default: unselected.

### Viewers

You can set the following viewer preferences:

- gnome-commander-viewer-prefs-image-window

- gnome-commander-viewer-prefs-full-screen

#### Image Windows

The Image Windows group contains the preferences that you can set to view images in image windows.

Use scrollbars

- Use this drop-down list box to specify when to use scrollbars to scroll through an image. Select one of the following options:

  - Never

    This option never displays scrollbars. You can use the arrow keys on the keyboard or the mouse to scroll through the image.

  - Only if image does not fit

    This option displays scrollbars when the image is larger than the image window.

  Default: Never.

Pick window size and zoom factor automatically

- Select this option to resize the image window to fit the image or to resize the image to fit the image window. If the image is small, &app; resizes the image window to fit the image. If the image is large, &app; resizes the image to fit the image window.

  Default: unselected.

Open images in a new window

- Select this option to open a new &app; window each time you open an image. If you do not select this option, &app; replaces the existing image with the new image when you open an image.

  Default: unselected.

#### Full Screen

The Full Screen group contains the preferences that you can set to view images in full screen mode.

Use scrollbars

- Use this drop-down list box to specify when to use scrollbars to scroll through an image. Select one of the following options:

  - Never

    This option never displays scrollbars. You can use the arrow keys on the keyboard or the mouse to scroll through the image.

  - Only if image does not fit

    This option displays scrollbars when the image is larger than the full screen.

  Default: Never.

Use 1:1 zoom factor

- Select this option to use the 1:1 zoom factor when you open an image. The 1:1 zoom factor displays the image at its actual size.

  Default: selected.

Use same zoom factor as image window

- Select this option to use the same zoom factor that the application uses to display the image in an image window.

  Default: unselected.

Fit all images to screen

- Select this option to resize images to fill the full screen when you open the images in full screen mode.

  Default: unselected.

Fit standard-sized images to screen

- Select this option to automatically resize images that are the same size as standard screens so that the images fill the full screen when you open them in full screen mode. If you select this option, &app; ignores the settings for the previous three options when you open an image that is the same size as a standard screen. Examples of standard screen sizes are 640 x 480 pixels, 1024 x 768 pixels, and so on.

  Default: unselected.

Put a bevel around the edge of the screen

- Select this option to display a 3D beveled border around the full screen view of an image.

  Default: unselected.

## Keyboard mappings for &app;

Shortcut | Mapping
F1 | Help
F2 | Refresh files in the active file list
F3 | View files
F4 | Edit files
F5 | Copy files
F6 | Rename or move files
F7 | Create directory
F8 | Delete files
F9 | Search
F10 | Quit
ALT+1 | Change left connection
ALT+2 | Change right connection
ALT+F3 | View with external viewer
ALT+F7 | Search
ALT+F8 | Opens the history list for the command line
SHIFT+F2 | Compare directories
SHIFT+F2 | View with internal viewer
SHIFT+F4 | Edit a new file
SHIFT+F5 | Make a copy a file in the current directory.
SHIFT+F6 | Rename a file
SHIFT+F10 | Bring up the context menu for the selected files.
CTRL+F3 | Sort by name
CTRL+F4 | Sort by extension
CTRL+F5 | Sort by date/time
CTRL+F6 | Sort by size
CTRL+F7 | Unsorted
CTRL+SHIFT+F5 | Create symbolic link
= | Select files using a pattern
NUM + | Select files using a pattern
NUM - | Unselect files using a pattern
NUM * | Invert selection
NUM / | Restore selection
CTRL+= | Select all files
CTRL+- | Unselect all files
ALT+NUM + | Select all files with the same extension
ALT+NUM - | Unselect all files with the same extension
BACKSPACE LEFT CTRL+PageUp | Change to parent directory (cd ..)
TAB | Switch between left and right file list
ENTER | Change directory or execute command line if not empty
SHIFT+ENTER | Execute command line in the defined terminal and leaves the terminal window open
RIGHT CTRL+PageDown | Change directory
ALT+LEFT | Go back to the last visited directory
ALT+RIGHT | Go forward to the next visited directory
INSERT | Select file or directory
SPACE | Select file or directory (as INSERT). If SPACE is used on an unselected directory under the cursor, the contents in this directory are counted and the size is shown in the "full" view instead of the string DIR.
ALT+ENTER | Show properties for the selected file
ALT+SHIFT+ENTER | The contents of all directories in the current directory are counted. The sizes of the directories are then shown in the "full" view instead of the string DIR.
DELETE | Delete files
CTRL+C | Copy files to clipboard (not a global one yet)
CTRL+X | Cut files to clipboard (not a global one yet)
CTRL+V | Paste from clipboard to current dir (not a global one yet)
CTRL+A | Select all files
CTRL+SHIFT+A | Unselect all files
CTRL+D | Open favorite directories (bookmarks)
CTRL+M | Multi-Rename-Tool
CTRL+T | Multi-Rename-Tool
CTRL+U | Swap file lists
CTRL+R | Refresh the active file list
CTRL+G | FTP Quick Connect
CTRL+F | Connect to FTP server
CTRL+SHIFT+F | Connect from FTP server
ALT+Letter(s) CTRL+ALT+Letter(s) | Quick search for a file name (starting with specified letter) in the current directory
Letter | Redirect to command line, cursor jumps to command line
ESC | Clears the command line
CTRL+K | Delete to the end of line
CTRL+W | Delete the word to the left of the cursor
CTRL+T | Delete the word to the right of the cursor
CTRL+P | The full path of the current directory is added to the command line
CTRL+ENTER | The file name under the cursor in the source directory is added to the end of the command line
CTRL+SHIFT+ENTER | The file name under the cursor including its path is added to the end of the command line
CTRL+DOWN ALT+F8 | A list with the latest command lines (history list) is opened. Use the UP and DOWN cursor keys to select an entry. By pressing the LEFT or RIGHT key, you can edit the command line. This automatically closes the list.
CTRL+. | Copy the current working directory from the inactive file-list to the active one.
CTRL+SHIFT+. | Copy the current working directory from the active file-list to the inactive one.

## About &app;

&app; was primarily written by the former maintainer - Marcus Bjurman, who where the one that initiaded this project publicly in 2001 and developed it up to version 1.1.6 in 2004. Currently &app; is being developed by Piotr Eljasiak (epiotr@use.pl) and Assaf Gordon (agordon88@gmail.com) with additional help of Magnus Stålnacke (jemamo@telia.com) and Micha (codejodler@gmx.ch). To find more information about &app;, please visit the GNOME Commander homepage.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.