# Using &krusader;

## Controls

### General

This is a rather short but important section that will go into the details of controlling &krusader;. This section doesn't try to cover all the various key combinations for two reasons:

1. there are just too many of them

2. most of &krusader;'s actions are configurable in the &konfiglookandfeel_lnk;

We will only mention the most important keyboard shortcuts with the default configuration but keep in mind that most of the &keybindigs_lnk; are configurable. If you find that you use a certain command a lot and want to know the shortcut for this command, or you want to change this command shortcut, then check out the &keybindigs_lnk; tab at the &konfiglookandfeel_lnk;.

### Moving Around

By Moving Around we mean the transfer of the keyboard and mouse focus between the different parts of the &krusader; main window. The focus can be in one of five places: the Left or Right Panel, the Menu Bar, the Command Line or the Terminal Emulator. The panel that has the focus is called the Active Panel. An Active Panel will remain active until the other panel receives the focus (&ie;: if the Left Panel was active and you clicked on the Command Line - then the Left Panel remains the Active Panel). You must deliberately change which panel is active.

The most common way to transfer the focus to a specific panel is to use the mouse to click on that panel. But you should be aware of the following:

- Clicking on the Toolbar, the FN keys bar or the Status Bar does *not* change the focus.

- Pushing the "History" or the "Run in Terminal" buttons in the Command Line will not transfer the focus so you have click inside the Input Line.

- The Menu Bar can get the focus by choosing a menu but it keeps the focus until you choose a command, and then the focus returns to the previous owner.

There are, of course, ways to use the keyboard to change the focus

- The Key will switch panels if one of the panel has the focus, or rotate between all the commands in a menu if the Menu Bar is active.

- The &Ctrl;Down Arrow will take you from the Active Panel to the Command Line or Terminal Emulator, and the &Ctrl;Up Arrow will take you back from the Command Line to the Active Panel.

- The &Esc; Key will make the Menu Bar return the focus, if it has it, to the previous Active Panel.

- If you happen to be inside the Terminal Emulator, you can use the Key, or the mouse, to navigate to an Active Panel.

- Pressing &Alt;"Underlined Letter" from the Menu Bar will open that menu (unless this key combination is a "Reserved Key", used by one of &krusader;'s actions).

### Marking (Selecting)

&krusader; offers 4 &mouse_selection_modes_lnk;, only &krusader;'s Mouse Selection Mode is explained here.

Marking is a skill you need to master in order to get the most out of &krusader;. Since you can't select files in the Quick View Panel, and the Tree Panel only lets you select one directory at a time, this paragraph mainly explains how to select files in the List Panel filelist.

Moving the cursor is easy. Left-clicking on a file or directory (referred to herein as "elements" meaning, files AND directories) will select it. Here are some useful pointers that will make Krusader even easier to use: (assuming you're using &krusader;'s Mouse Selection Mode)

- The SPACE and Insert key will toggle the marking of the file under the cursor without affecting the marking of other files/directories, the cussor will go one position down.

- Pressing the SPACE on a Directory under the cursor will calculate occupied space without affecting the marking of other files/directories.

- Left Clicking on a file will select, or unselect, all previously marked files.

- &Ctrl;Left Clicking will toggle the marking of the file under the cursor without affecting the marking of other files/directories.

- &Shift;Left Clicking will select all the elements between the previous cursor location and the new one.

- &Shift;Home selects everything above the cursor (and unselect everthing below the cusror if marked).

- &Shift;End selects everything below the cursor (and unselect everthing above the cusror if marked).

- The ".." entry is not markable.

- The &editmenu_lnk; can offer more ways to select your files.

### Executing Commands

There isn't a lot to say here, all you need to do is select some files (if you don't &krusader; will operate on the file(s) or directory(s) that have the focus), choose a Command from the Menu Bar or use a Keyboard Shortcut (or the Right Click Menu) and the selected Command executes. See also Executing Files.

### Quicksearch

This feature will do a quick search for the file name in the Active List Panel.

There are two quick search methods:

- "Old Quicksearch": type foo (one character) to do a quick search in the Active List Panel for a file beginning with "foo".

- "New Quicksearch": type foo to open the small quick search dialog box below the Active List Panel. Type the first few characters of the desired filename (more than one character allowed), the cursor will jump to that filename (if it exists), ⪚ type "ab" to search for a file which begins with "ab". The Up/Down Arrow will jump to the next or previous match. &Esc; will close the quicksearch line. The cursor will stay on the last Quicksearch file found.

If you press &Alt;foo, the key binding shortcut will be executed. If there is no configured key binding, the remaining letter foo will used for the quick search.

Use &konfiglookandfeel_lnk; to change from the default configuration.

### Context Menu

&krusader; has many Context menus that allow you to do fast operations with the mouse, usually a Right-Click will open the Context menu (depending on your &mouse_selection_modes_lnk; settings). This list gives an overview of the most important Context menus, use them to discover the available commands.

- &main_toolbar_lnk; (orientation, text position , icon size)

- &list_panel_lnk; on a file or directory

- &cmdline_lnk; (undo, paste, text completion, ...)

- &termemu_lnk; (send signal, font, history, ...)

- &foldertabs_lnk; (new, duplicate, close)

- KruSearcher Search results file list (F3 View, F4 Edit)

- &mountman_lnk; (unmount, format, ...)

- &syncdirs_lnk; File List

- &useractions_lnk;

- &konqueror; Right-Click actions are shown in &krusader;

- Show/hide Column Headers

- ...

## Basic File Management

### Executing Files

You can only execute files in the Active List Panel. To execute a file just (double-)click on it or press Enter when it is under the list cursor. &krusader; will open it in the default application for this file type (picture, textfile, ...) or the file will be executed (script, binary, ...). If you want to use another application to open the file, then Right-Click on the file and go to the "open with" sub-menu which will offer more options. &krusader; is compatible with &kde; default file-manager for all file types except archives that are opened inside the &krusader; panel and not in an external application. See the archives page in Konfigurator for details.

### Copying and Moving

To copy or move files/directories just select them and press F5 to copy or F6 to move them. If checked the Preserve attributes (only on local targets) option, &krusader; will try to preserve all attributes (time, owner, group) of the local files according to the source depending on your permissions:

- User preserving if you are root

- Group preserving if you are root or member of the group

- Preserving the timestamp

Using this option might slow down the copy/move process. A dialog will appear and allow you to choose the operation destination, the default destination is the other-panel browsed directory. If you enter a partial &URL; &krusader; will use the current panel directory as the &URL; base.

### Deleting

Deleting files/directories is done by marking them and pressing F8 or Delete. By default it will be moved to &kde;'s Trash, &Shift;Delete will delete the file permanently. A dialog will ask for your confirmation and will warn you when deleting non-empty directories. Of course only operations that you are permitted to do by the Operating System will be performed - you will be notified otherwise. If you don't wish to see the confirmation dialogs, you can disable them in the Konfigurator advanced tab.

### Renaming files, Creating Directories, and Link Handling

Rename the file under the cursor with the F9 key or with two single mouseclicks. If only the filename needs to be renamed and not the extension you can configure this in the &konfiglookandfeel_lnk;. Create a new directory with the F7 key. Right-clicking on a regular file will give you the option "New Symlink", a dialog will prompt you to enter a symlink name. That name will point to the file/directory you Right-Clicked on. If the file you Right-Clicked on is a symlink you will also be presented with the "redirect link" option that will allow you change the link target.

### Viewing and Editing files

KrViewer has a chapter of its own.

## Archive Handling

### Browsing Archives

The &vfs_lnk; allows to browse archives as it was a directory. &krusader; supports currently the following archives types: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip and supports the next passworded archives: arj, ace, rar and zip. Passwords can be stored in &tdewallet;. Please note that the archive support first needs to be properly configured in Konfigurator. To open the archive use &Enter;, (double-)click or the Right Arrow. &krusader; supports also hidden archives, these are renamed archives with a *wrong* extension. ⪚ &openoffice; uses zip archives with the next extensions: odt, sxw and odw. &Enter; will open the &openoffice; document and the Right Arrow will open the archive. An other example is J2EE where the rar extension means a zip archive. &krusader; will open with Right Arrow the archive even if it has an other mime type, since &krusader; autodetects the supported archive types. Please note that browsing archives has a few limitations:

- Not all functions are supported by all archive types. (&ie;: you can't delete files in ace or rar archives)

- The permissions you have inside the archive are the same as the permissions you have for the archive.

- The command line (if visible) will not follow you inside the archive but will point to the archive directory.

- Before any action is performed on files/directories inside the archive they must be extracted. The archive will be repacked when you leave it or when &krusader; detects that extracted files have changed.

- Packing and un-packing are "blocking operations" that display a Progress Dialog. Though, this might change in the future since we are planning to create more background operations.

### Unpack Files

There are 2 ways to extract files from archives:

If you want to unpack a whole archive(s), browse to the archive location, select the archive(s) and select File Unpack or &Alt;U. &krusader; will ask you where to put the extracted files, the default location is the inactive panel directory. If you don't cancel the operation, &krusader; will try to unpack all the selected files in the inactive panel.

If you only want to extract part of the archive, then browse the archive and copy the files you want to extract to their new location just as you would copy "normal" files. Note that unpacking from a browsed archive takes more time (file by file unpack) compared to unpacking a whole archive with the first method.

### Packing Files

If you want to create a new archive, begin by marking the elements you want to pack in the active panel and select File Pack or &Alt;P. A dialog will pop-up, prompting you to select the archive name and location, you select the packer by selecting one of the supported filename extensions.

To add files to an existing archives, open the archive in one panel and the files to be copied in the other panel, then simply copy the files into the archive in exactly the same way you copy files into a "normal" directory.

### Testing Archives

Krusader will not handle corrupted archives since it may result in data loss. If you receive an error message when opening an archive, or if you suspect that there something wrong with the archive you should test it before use. To test an archive, browse (navigate) to the archive location, select the archive. Next select File Test Archive or &Alt;E. &krusader; will test the archive file and inform you if the archive passed or failed the file integrity test.

## More features

### Virtual file systems (VFS)

A basic OFM feature is VFS, this an abstracted layer over all kinds of archived information (ZIP files, FTP servers, TAR archives, NFS filesystems, SAMBA shares, ISO cd/dvd images, RPM catalogs, etc.), which allows the user to access all the information in these divergent types of filesystems transparently - just like entering an ordinary sub-directory! &krusader; supports several VFS:

- Remote connections VFS: provides the capability of working with a remote connection session (FTP, NFS, Samba, FISH, SFTP) like with local filesystems. It's perfect for complex remote operations and almost as powerful as most standalone GUI remote clients.

- Archive VFS: allows to browse archives in VFS as it was a directory (ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip).

- Search VFS: Feed to listbox will place the search results in VFS.

- Synchronizer VFS: places the synchronizer results in VFS.

Actions you perform on the files in VFS are performed on the 'real' files. You don't just delete files from the VFS - you delete them from your hard drive. Limitations: you can't create directories inside in a VFS.

### Compare

&krusader; contains several compare functions: Compare by content, Compare Directories and the Synchronizer compare function.

#### Compare by Content

Select in each panel one file, and use File Compare by content. &krusader; will open a external graphical difference tool that is configured, right now &kompare;, &kdiff3_url; and &xxdiff_url; are supported.

#### Compare Directories

Compare the files of each panel by using Mark Compare Directories. By default newer and single files will be selected in each panel, this behaviour can be changed in the Compare Setup menu.

The files are not compared by content but by their names and dates only.

Mark Compare Setup

- Configures the Compare Directories function.

  - Mark Newer and Single (default)

  - Mark Single

  - Mark Newer

  - Mark Different and Single

  - Mark Different

### Calculate Occupied Space

There are two ways to calculate the occupied space of files/directories.

- Pressing the SPACE on a directory under the cursor instantly calculates the occupied size. Pressing SPACE a second time will toggle the marking of the directory without affecting the selection status of other files/directories.

- To calculate how much disk space is occupied by the marked files and directories in the active panel select File Calculate Occupied Space. After a (hopefully) small delay, a dialog box will be displayed with total occupied space and the number of files and directories you selected. The space occupied by every selected directory will be shown as if the user just pressed SPACE on that directories. If the active panel is browsing an archive, the numbers will apply to the *unpacked* size of the selected files and directories, not their compressed size. After the calculation the marking state will toggle and the cusor will move one position down.

Calculating the occupied space on remote filesystems is supported.

Performing this operation on a very large filesystem (thousands of files) may be time consuming. You can always cancel the calculation process at any time by clicking on the Cancel button.

### File Splitter

This function splits one (big) file up into multiple smaller files so that they can be placed on several smaller media (⪚ zip-drives, ...) or sent by e-mail. The multiple files can be combined again to recreate the original file. &krusader; and &tcmd; split/combine functions are compatible. To split a file choose File Split or &Ctrl;P A Split dialog will open to confirm the operation.

If the name of the original file is `foo`, then the name of the smaller files will be `foo.000 foo.001 foo.002` &etc; There is no theoretical limit in the number of smaller files, but it is recommended to limit the number to a max of 1023 files. &krusader; creates a `foo.crc` file. This file contains the name, size and the crc checksum of the original file. It's possible to combine the file without the `foo.crc` file but in this case &krusader; can't check if the the original file was recreated correctly.

An example of a `foo.crc` file:

    filename=foo
          size=432998467868
          crc32=21EB719A

To combine the multiple files choose, select a partial file `foo.xxx` and choose File Combine files or &Ctrl;B. The target directory is the unactive panel and can be changed. The file names must be numbered in ascending order: `foo.001, foo.002, foo.003` &etc; or have letters in ascending order: ("``split` `-b`` letter method") `fileaa, fileab, fileac` &etc; If the file `foo.crc` is found in the same directory as the partial files, &krusader; will use this file to check the combined file for errors.

### Checksum creation-verification

File Create Checksum : &krusader; checks which tools you have and if those tools allow recursive operation (in case you selected folders), you choose the type of checksum (md5, sha...) and it is generated. You can then save the checksum to a file, usually called checksum.md5 (or .sha1 or whatever).

File Verify Checksum : &krusader; checks if you have a tool that supports the type of checksum you need (from your specified checksum file) and displays the files that failed the checksum (if any).

The nice thing is that the system abstracts over different checksum mechanisms and different binaries. Right now, it supports md5, sha1, sha256, tiger, whirlpool and cfv. You probably have md5sum and sha1sum already, external supported tools are md5deep (sha256, tiger, whirlpool) and cfv.

### Send Files by e-mail

Select a file and use Right-Click menu Send by Email. Selecting this option will open a new &kmail; window with the file already attached. Just fill in the subject and recipient(s) and send it. Of course, &kmail; must be properly configured.

### Shred Files

When you delete files in your local system they are not completely erased and the information stored in them can be recovered using special software and hardware tools. If you want to erase a file without recoverable traces, select the file and use Right-Click menu Shred.

## Profiles

With profiles you can save and restore your favorite settings. Several features supports profiles, you can have ⪚ different panel profiles (work, home, remote connectios, &etc;), search profiles, synchroniser profiles, &etc;

### Panel Profiles

A panel profile contains: all the tabs paths (left/right), the current tab (left/right), the active panel (left or right), all this information is stored in the &krusaderrc_lnk; file. You can have several Panel profiles ⪚ file-managment, ftp-managment, home, work, etc. The panel profile can be saved and restored in the Commands menu. The default startup profile will be used when starting krusader, with a commandline option you override the default startup profile.

### Color Profiles

Colormaps can be saved and restored with Color Profiles. &krusader; Colormaps are available at &kde_files_url;.

### Key-binding Profiles

Keymaps can be saved and restored with Key-binding Profiles. &krusader; Keymaps are available at &kde_files_url;.

### Search Profiles

When you regularly perform the same search operation, than you can save the search settings (⪚ include files, exclude files, &etc;) in a Search Profile.

### Synchroniser Profiles

When you regularly perform the same synchronise operation, than you can save the synchronise settings in a Synchroniser Profile.