The Konqueror Handbook

Pamela Roberts
Developers: The KDE Team

The Konqueror Handbook

Contents
1

Overview

Konqueror Basics

2.1

Starting Konqueror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2.2

The Parts of Konqueror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2.3

Tooltips and Whats This? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10

2.4
2.5

Left and Middle Mouse Button Actions . . . . . . . . . . . . . . . . . . . . . . . . .

Right Mouse Button Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10
11

2.6

Viewing Help, Man and Info Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

Konqueror the File Manager

13

3.1
3.2

Folders and Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

View Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.1 File Tip Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13
13
14

3.2.2 File Previews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.2.3 Information in the View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Folder View Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14
15
15

3.3.1

The View Properties Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16

Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16

3.4.1

Finding Files and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17

3.5

3.4.2 Removable Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Deleting Files and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17
18

3.6

Moving and Copying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18

3.6.1

Using Drag n Drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

19

3.6.2

Duplicate File or Folder Names . . . . . . . . . . . . . . . . . . . . . . . . . .

20

Selecting Items in the View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20

3.7.1

Selecting Items Using the Mouse . . . . . . . . . . . . . . . . . . . . . . . . .

20

3.7.2

Selecting Items Using the Keyboard . . . . . . . . . . . . . . . . . . . . . . .

20

3.7.3

3.3
3.4

3.7

Selecting Items Using the Menu . . . . . . . . . . . . . . . . . . . . . . . . .

21

Create New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing Names and Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21
22

3.9.1

Copy and Rename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

23

3.10 Configuring File Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

23

3.11 At the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

23

3.8
3.9

The Konqueror Handbook

Konqueror the Web Browser

25

4.1

Connecting to the Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

25

4.2

Surfing and Searching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

26

4.3

Tabbed Browsing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

27

4.4
4.5

Web Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Access Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

27
28

4.6
4.7

Browser Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Saving and Printing Web Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29
29

4.8
4.9

FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
URLs with Port Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30
30

Automatic Text Completion

32

Using Bookmarks

33

6.1

33

The Bookmark Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

The Sidebar

35

Saving Settings & Profiles

38

8.1

General Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

38

8.2

View Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

38

Plugins

40

9.1

Netscape Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

40

9.2

Konqueror Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

40

10 View Mode Extensions

10.1 FSView - the File System View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

46
46

10.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1.2 Visualization Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1.2.1 Item Drawing Options . . . . . . . . . . . . . . . . . . . . . . . . .

46
46
46

10.1.2.2 TreeMap Drawing Algorithms . . . . . . . . . . . . . . . . . . . . .

47

10.1.3 User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10.1.4 Credits and License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

47
47

11 Configuring Konqueror

48

11.1 Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.2 Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.3 Other Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

48
48
50

The Konqueror Handbook

12 Command Reference
12.1 Special Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12.2 The Menubar . . . . . . . . .
12.2.1 The File Menu . . . . .
12.2.2 The Edit Menu . . . .
12.2.3 The View Menu . . . .
12.2.4 The Go Menu . . . . .
12.2.5 The Bookmarks Menu
12.2.6 The Tools Menu . . . .
12.2.7 The Settings Menu . .

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

51
51

.
.
.
.
.
.
.
.

51
52
52
54
55
56
56
56

12.2.8 The Window Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12.2.9 The Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

57
58

13 Questions and Answers

59

14 Credits and License

61

A Installation

64

Abstract
Konqueror is KDEs advanced File Manager, Web Browser and Universal Viewing Application.

The Konqueror Handbook

Chapter 1

Overview
Pamela Roberts
Konqueror is an advanced file manager for the KDE Software compilation, providing file management functions ranging from simple cut/copy and paste operations to advanced local and
remote network file browsing. Folder contents can be displayed in a variety of text and icon view
modes, which can include thumbnail preview images of file contents. File and folder properties
can easily be examined and changed, and applications launched with a simple click of the left
mouse button.
In KDE SC 4 Dolphin is the default file manger. To change the default component for browsing
folders, open Default Applications in the System Settings and select Konqueror as file manager.
Konqueror is an HTML 4.01 compliant web browser with built in support for JavaScript (ECMA262), CSS (Cascading Style Sheets) and bidirectional scripts (such as Arabic and Hebrew). It provides support for the secure running of Java applets, Netscape plugins for viewing Flash,
RealAudio and RealVideo and SSL for secure communications. Advanced features include
automatic URL and form completion, the ability to import bookmarks from other browsers and
tabbed browsing.
Konqueror is also an excellent full featured FTP client.
Konqueror is a universal viewing application, capable of displaying images and documents without having to launch another application. It does this by embedding components (KDE Parts)
provided by other applications; from Gwenview; for image viewing, Okular for PDF, PostScript
and other documents.
Konqueror is a fully customizable application which anyone can configure to suit their own needs,
from changing the overall style and the sizes of text and icons to selecting which items appear in
the Menubar, changing the number and positions of the toolbars and even defining new shortcut
key combinations. Different configuration profiles can be saved for easy recall as needed.

The Konqueror Handbook

Chapter 2

Konqueror Basics
Pamela Roberts

I MPORTANT
Like all KDE applications, Konqueror is highly configurable. This document describes how Konqueror
behaves with the normal, default settings.
A three button mouse can be useful when you are running Konqueror or any other KDE application.
If your mouse only has two buttons then you should be able to set your system up so that you can
simulate a middle mouse button by pressing both buttons at the same time.
You can read more about mouse usage in Section 2.4
If you are used to having to double-click to perform an action, then take care, because in common with
the rest of KDE, Konqueror defaults to single-clicking.

2.1

Starting Konqueror

Being a combined File Manager and Browser, Konqueror will automatically switch between the
two modes as needed when it is running, but it is convenient to be able to choose which mode is
to be used when you start it up.
From the application launcher menu, select Internet Konqueror (Web Browser) to start it
as a browser.
Alt+F2 will open KRunner, enter a path to a folder and press Enter to start in file manager
mode, or just enter a URL such as http://www.konqueror.org to start Konqueror as a
browser.

N OTE
Click on the black arrow to the right of the Home Page icon to switch to your Home Folder in the file
manager mode and vice versa.
If Konqueror is the default file manager it also starts automatically when you left click on a
desktop icon that represents a folder, such as a hard disk drive or the Trash icon.

The Konqueror Handbook

2.2

The Parts of Konqueror

A brief look at the main parts of Konquerors window:

The Titlebar is the strip across the top of Konquerors window, and operates in the same way as
for other KDE applications. Right click on the central portion to bring up the neat Titlebar menu.
The Menubar is the strip containing the names of the drop-down menus. Left click on a name
to alternately show and hide that menu, or use Alt+the underlined letter in the name as a hot
key, for example Alt+E to show the Edit menu. The various menus are described in the Menubar
section of this document.
The Toolbar contains icons for commonly used operations. Left clicking on an icon will activate
it. A brief description of what that icon does will appear when you hover the pointer over it.
Some icons, for example the Up and Back icons in the previous screenshot, have a small black
arrow at the right. If you click with the left mouse button at this arrow a small dropdown menu
will appear.
Right clicking on the Toolbar will bring up the Toolbar Settings menu which you can use to
change the Toolbars appearance and position.
The Location Toolbar shows the path to the directory, URL or file being viewed. You can type a
path or URL here and press Enter or left click on the Go icon at the right hand end of the Location
Toolbar to go to it. The black icon at the right hand end of the Location Toolbar clears the text
entry box.
The Bookmark Toolbar is the area under the Location Toolbar in the previous screenshot. You
can add frequently used bookmarks here; see the Organizing Your Bookmarks section of this
document.
The Window is the main area of Konqueror and can show you the contents of a directory, web
page, document or image. Using the Window menu you can split Konquerors main window
into one or more separate views, useful for drag and drop operations, or set it to contain two or
more tabbed views.
The Status Bar runs across the bottom of the Konquerors window and often shows general information about whatever the mouse pointer is hovering over. If you have split the main window
into a number of views you will get a Status Bar for each view, and it will include a small green
light at the left hand end to show which is the active view. Right clicking on the Status Bar
brings up the Status Bar Right Mouse Button Menu.
9

The Konqueror Handbook

N OTE
Dont worry if your Konqueror doesnt look exactly like this screenshot; it is highly configurable. In
particular:
You can use the Settings menu to choose whether to show or hide the Menubar, Main Toolbar,
Location Toolbar and Bookmark Toolbar, or even to add an Extra Toolbar.

If the toolbars are unlocked, you can also drag them to a new position by left clicking on the handle
at the left hand end of a bar and move it around by holding the left mouse button down while you
drag it.

This screenshot does not show the optional Sidebar.

For more details of how to change Konquerors appearance, see the Configuring Konqueror section

2.3

Tooltips and Whats This?

You can find out a lot about how Konqueror works without needing to read this entire document
if you take advantage of Tooltips and the Whats This? feature.
When you hover the mouse pointer over a Toolbar or Sidebar tab button it should bring up a
terse description of what that button does.
Whats This? is invoked by the Menubar Help Whats This? item or by Shift+F1. It changes
the cursor to show a question mark alongside the arrow.
When this question mark is visible, a left mouse button click wont actually do anything until you
have clicked on a control (or the text alongside it) that supports Whats This?, in which case it
will display a reasonably comprehensive description of what the control does. Most of the dialog
boxes that Konqueror brings up support the Whats This? feature.

2.4

Left and Middle Mouse Button Actions

If you click the left mouse button on an item in Konquerors window, it will be activated. Thus
Left click on an icon in the Toolbar to perform the action that icon represents.
Left click on an item in the Menubar to make that menu drop down.
Left click on a menu item to do that thing.
Left click on an icon in the Bookmark Toolbar to open that URL.
Left click on a link in a web page to make Konqueror follow that link.
Left click on a folder icon or name and Konqueror will descend into (show the contents of) that
folder.
Left click on a file name or icon and Konqueror will do whatever it thinks appropriate, based
on the file type. In general this means opening HTML pages, or previewing text, image or
Okular documents, showing them within Konquerors window (Preview means that you can
see the file but not change it).
Konqueror decides what the file type is by matching the filename extension against a list of
known types. If that fails it tries to guess the type from the file contents. You can change the
list of known file types and associated actions with the File Associations page of the Settings
Configure Konqueror... dialog.

10

The Konqueror Handbook

Clicking the middle mouse button on a file or folder name or icon does essentially the same as
left clicking except that it usually does it in a new Konqueror window, unless the Open links in
new tab instead of in new window box has been checked in the General page of the Settings
Configure Konqueror... dialog. Konqueror can open links on pages and Bookmarks, as well
as the Home, Up, Back and Forward entries in a new tab or window.
Holding the Shift key down while pressing the middle mouse button will open the link in the
background.

2.5

Right Mouse Button Menus

Clicking the right mouse button on almost any part of Konquerors window will bring up an
appropriate context menu.

N OTE
If you have enabled the Right click goes back in history option in Konquerors configuration settings
a simple right click is equivalent to clicking on the Back button. In this case you can access the context
menu by moving the mouse with the right button held down.

On the Titlebar
Right clicking on any free area of the Titlebar brings up the Titlebar Menu, allowing you to
control the position of Konquerors window as well as the decoration applied to all KDE
program windows.
On the Main Toolbar
Right click on any free area of the Toolbar to bring up the Toolbar Menu. You can use it to
control whether the Toolbar is at the top, bottom, left or right of Konquerors window. You
can also use the Toolbar Menu to set the size of the buttons on the Toolbar, and whether
they are shown as icons, text or both.
On the Location Toolbar
Right click in the URL entry box area to perform Cut, Copy, Paste or Clear operations in
this area, or to change the automatic Text Completion features.
Within a View
If you right click on any free area of a view then you will get a menu that contains, among
other options, the Up, Back, Forward and Reload navigation commands.
On a File or Folder
This is a most useful feature. Right clicking on the name or icon of any file or folder not only
selects that item but also brings up a menu allowing you to Cut, Move, Copy or Remove
the item in various ways, open it with the program of your choice or preview it, rename it,
or edit the file type or properties.
On the Status Bar
Right click on the Status Bar at the bottom of a window or view to add or remove a view
within Konquerors window.

2.6

Viewing Help, Man and Info Pages

You can view KDE Help and UNIX Man and Info pages directly in Konqueror, without having
to start up KHelpCenter.

11

The Konqueror Handbook

To view a KDE Help page, enter help:/ application name (for example help:/kmail to
view the KMail documentation.) into Konquerors Location Toolbar window.
If you want to read UNIX Man pages Konqueror makes it easy. For example type man:/touch
or #touch into the Location Toolbar to see the page for the touch command.
To browse through UNIX Info pages, entering info:/dir takes you to Infos top level directory, then its just a matter of clicking on the right links to find the page you want. Alternatively,
use info:/ command name to go straight to the Info page you want.

N OTE
Unfortunately, KDE Help pages are stored in such a way that they cannot be viewed in other browsers.
If you really need to do this your only recourse is to go online and visit http://docs.kde.org.

12

The Konqueror Handbook

Chapter 3

Konqueror the File Manager

Pamela Roberts

3.1

Folders and Paths

In UNIX and Linux all folders are arranged in a simple hierarchy. Starting from a top level
folder (also called the root directory), the structure descends and branches containing various
files and subfolders. This means that you can get from any folder to any other by going up
until you reach a common point then down through the appropriate subfolders until you reach
your target.
The position of any file or folder in the structure (also called a directory tree) can be described by
its path, which is a simple list of the folders you would have to descend through to get to the
target folder or file. For example /home/pam is the subfolder pam of the subfolder home of the top
level folder, and /home/pam/words.txt is the file words.txt in that subfolder. The leading / in
these paths represents the top level folder.
Every folder accessible by your system including those on other hard disk partitions, a USB
device or CD-ROM will appear in the tree descending from /, their exact paths will depend
on how your system was set up (see also the section on Removable Devices).
Every user on a UNIX / Linux system has their own home folder to hold their personal files
and settings; for example /home/john and /home/mary. The symbol ~ is often used to represent
the users home folder, so that ~/letter.txt refers to the file letter.txt in my home folder.
Note that the term directory is often used instead of folder.

3.2

View Modes

In File Manager mode, Konqueror lists which files and subfolders are contained within a given
folder and can provide you with some information about them. The path of the current folder
is shown in the Location Toolbar. The way that Konqueror displays the files and folders depends
mainly on your choice of view mode which can be selected from the View View Mode sub
menu. The view modes Konqueror provides are outlined below.

N OTE
In File Manager mode, Konqueror uses an embedded Dolphin component.

13

The Konqueror Handbook

In the Icons view, which is the default, files will be represented by an icon that visualizes the
file type, and a folder icon will be shown for subfolders. The names of folders and files, and
the items enabled in View Additional Information, are displayed below the icons.
The Compact view shows the folder contents as icons with the name beside it and the items enabled in View Additional Information below the name. The items are grouped in columns
similar to the Short View in the KDE file dialog.
In the Details view, the folder contents are displayed as a detailed list which contains the name,
size and last modification time of each item. Additional columns can be added by clicking a
column header with the right mouse button.
In the context menu of the header line you can choose between custom or automatic column
width. Automatic width adjusts the width of all columns once to display the longest item in
the column completely, except for the Name column where the extension is replaced by ...
The order of columns can be changed by drag and drop of column headers, except for the
Name header, which is always the first column in this view.
The details view allows you to view the current directory in a tree-like fashion if Expandable
folders are enabled: Each subfolder of the current folder can be expanded or collapsed by
clicking on the > or v icon next to it.

All view modes support grouping by the sort type selected in View Sort by

3.2.1

File Tip Info

Checking the Show tooltips box in the File Management General page of the Konqueror
Configuration dialog causes a small pop up information window to appear when the mouse
pointer is hovered over a file or folder name or icon.

3.2.2

File Previews

The Previews tab of the File Management General settings page lets you enable file previews
for certain types of file.
14

The Konqueror Handbook

Generally this means that the files icon will be replaced by a small image showing the file contents.
Because Konqueror has to read much more data than just the file name to generate a preview, file
previews may not be appropriate when viewing files from a remote system. To disable previews
for remote files where reading the extra data would take too long set a file size limit at the bottom
of the Previews tab.

3.2.3

Information in the View

In all view modes Konqueror shows at least an icon and a name for each item. Using Additional
Information in the View menu or the context menu of the header in Details mode, you can select
more information for each item to be shown:
Size, Date, Type, Rating, Tags or Comment.
Depending on the file type, additionally, sorting criteria can be selected:
Document: Number of words and lines
Image: Size and orientation
Audio: Artist, album, duration and track
The Other submenu allows to select Path, Link Destination, Copied From, Permissions, Owner
or User Group.

3.3

Folder View Properties

The following settings control how the contents of a folder are displayed in the Konqueror view,
and are stored on a per-folder basis by default:
The view mode (Icons, Compact, Details)
The sorting of items, which is determined by the sort order (ascending, descending) and the
attribute (such as name, size,...) that the items are sorted by
Sorting of folders and files are folders shown first or not?
Previews are they shown instead of icons (based on the settings made in Previews tab of
Konquerors General settings) or not?
Are items shown in groups in the views?
Are hidden files shown?
What additional information (besides the name) is shown in the Icons or Details view?
The view properties can be configured in the View menu, some (such as the view mode) can also
be changed using toolbar buttons.

15

The Konqueror Handbook

3.3.1

The View Properties Dialog

The View Properties Dialog.

The View Properties dialog can be used to quickly modify several view properties at once. This is
done for the current folder, for the current folder including all subfolders, or even for all folders,
depending on the choice made in the Apply View Properties To section.
If Use these view properties as default is enabled, the chosen view properties will also be used
for all folders which do not have customized view properties yet.

3.4

Navigation

To get to a file with Konqueror you first need to navigate through the folder tree to find the folder
containing that file.
To move between folders you can simply step up and down the tree:
To descend into a subfolder left click on its name or icon -- or if you have already selected it
(see below) -- then just press Enter.
To go up the folder tree you can click on the Up button in the Toolbar, useAlt+Up, or use the
Menubar Go Up option.
To select a file or folder in the displayed folder without opening it in any way use the up and
down arrow keys to move through the items. The selected item will be highlighted and some
information about it will be displayed in the Status Bar.
Setting the View Mode to Details can help you locate folders in the tree below the current folder;
in this mode each folder is shown with a small box at the left. If the box contains a > sign, left
clicking on the box (not on the folder name or icon) will display a sub tree showing files and
subfolders contained in that folder. The small box will then change to show a v sign. Left click
on that to collapse the sub tree. Once you have found the folder you are looking for, left click on
the folder name or icon to open it.
16

The Konqueror Handbook

The Sidebar can also help you find your way around the file system.
You can go directly to any folder by switching with File Open Location or Alt+O to the Location Bar and typing its path. Konquerors Text Completion feature may be useful when you do
this. Dont forget that in Linux / UNIX file and folder names are case sensitive.
When you have moved to a new folder you can go back to your previous choice by using the
Toolbar Back button, the Menubar Go Back item, or Alt+Left. Once you have gone back you
can go forward. Use the Toolbar Forward button, the Menubar Go Forward item or Alt+Right.
Alternatively, you can also choose to enter the parent folder by clicking on the Toolbar Up, the
Go Up item, or with Alt+Up.

T IP
Click the checkmark at the right of the toolbar Up, Back or Forward buttons or selecting these items
in the Go menu brings up a submenu of recently visited locations.

3.4.1

Finding Files and Folders

If you dont know or cant remember where a file or folder is within your system, then use the
shortcut Ctrl+F or the Menubar Tools Find File... option. This starts the file finder application
KFind. See the KFind Handbook for help in using KFind.

N OTE
If the name of a file or folder begins with a period (dot), then it is a hidden file or folder, and will
not normally be shown by Konqueror. To see hidden files or folders use the Menubar View Show
Hidden Files option.
Another reason Konqueror may not show the file or folder you are looking for is that you may have the
View Filter plugin set to display only certain types of file.

3.4.2

Removable Devices

Any removable device (USB stick, floppy disk, CD drive or other hard disk partition that you
have on your system) will usually appear in the / , /media, /mnt or /auto folder, having a path
something like /mnt/floppy or /cdrom. The details will depend on how your system was set up.
UNIX / Linux requires that you mount a removable device when you have inserted it into the
drive, and mount other hard disk partitions when you want to access them. You also need to
unmount a removable device before removing it to register that it is no longer available.
How you do this will depend on your system setup:
Using the Device Notifier
In a KDE session the Device Notifier window will popup, when you insert a removable device
and allows you to select an appropriate application for this media or only mount the device.
If you use the Folder View layout for your desktop you may have icons for removable devices
on your desktop, in which case left mouse button click on the icon to mount it. Doing this
should also bring up a Konqueror window showing the contents of the device. To unmount,
right click on the icon and choose the Unmount item. Visit the section Create New... in this
Handbook to see how to create such an icon.

17

The Konqueror Handbook

Or you can do it the traditional way by typing into a text console window:
mount /mnt/floppy
to mount, for example, the floppy drive, and
umount /mnt/floppy
to unmount it (umount not unmount).

N OTE
Rather than having to open a text console to type the mount or umount commands, you may prefer
to use Konquerors Tools Execute Shell Command (Ctrl+E) feature.

3.5

Deleting Files and Folders

Konqueror gives you two ways to dispose of an unwanted file or folder:

You can move it to the Trash folder, which is the safest method as you can get it back if you
realize that you have made a mistake.
You can just plain Delete it, which removes the entry from the folder and adds the disk area
occupied by the file(s) to the systems list of free disk areas, in the same way as the rm command.
If you want to use this feature check the option Show Delete menu entries which bypass the
trashcan on the File Management settings page.
The simplest way to remove a file or folder is to position the mouse pointer over its name or icon
and press the right mouse button, which will bring up a menu containing the options Move to
Trash and Delete.
Or, if you have selected the item, the Menubar Edit menu will give you the choice of Move to
Trash and Delete options.
Del will move the selected item or items to Trash.
Shift+Del will really, truly and irrevocably delete the selected item or items.

N OTE
You wont be able to remove a file or folder if you dont have the necessary permissions.

3.6

Moving and Copying

To copy a file or subfolder between folders you can:

Position the mouse pointer over its name or icon and hold down the right mouse button, which
will bring up a menu containing the Copy option. Choose that.
Or if the item is selected you can use the Copy button on the Toolbar or the Menubar Edit
Copy item, or the Ctrl+C shortcut key combination. You can also select multiple files or
folders to copy/move as well.
Navigate to the folder you want to copy the item into then Paste the item into the new folder
by using the Toolbar Paste button or the Menubar Edit Paste option or the Ctrl+V shortcut,
or by moving the mouse pointer to a clear area of the window and holding the right mouse
button down to bring up a menu containing the Paste option.

18

The Konqueror Handbook

Moving a file or subfolder between folders can be done in the same way as copying, except
that you choose the Cut option or Ctrl+X instead of Copy. The item that you have Cut will be
removed from the original folder when you do the Paste into the new folder.
You can also copy or move selected item(s) to another folder by selecting Copy To or Move To
from the context menu you get when you right click on a file or folder name in the File Manager
window.
To enable this feature select Show Copy To and Move To commands on the File Management
Services page of the settings.

N OTE
You may not be able to copy or move a file or folder if you dont have the necessary permissions.

3.6.1

Using Drag n Drop

Konqueror also supports Drag and Drop copying and moving of files and folders.
You can do this by having two instances of Konqueror, one showing the folder you want to copy
from, the other showing the target folder. Position the mouse pointer over the item you wish to
copy or move, then, holding the left mouse button pressed, drag it to a clear space in the target
folder. Release the button and you will be presented with a menu choice of Copy Here, Move
Here or Link Here. Take care to drop the item into an empty area of the target folder view dropping it on top of a subfolder will copy or move the item into that folder.
You can also set up Konqueror to show more than one folder within its window and drag & drop
between them.

This screenshot illustrates the use of the Menubar Window Split View Left/Right option, also
available with the shortcut Ctrl+Shift+L, to split the main Konqueror window into two views,
each showing the contents of a different folder.
To be able to show different folders in each view they should not be linked; the little boxes at the
bottom right of each view should be empty.
The active view, that is the one whose path is shown in the Location Toolbar and which responds
to navigation and Menubar commands, is shown by the little green light in the bottom left corner.
To make a view active, left click on an empty area of the view or on its Status Bar.
19

The Konqueror Handbook

To remove an active view from Konquerors window use the Ctrl+Shift+W shortcut, or the
Menubar Window Close Active View option, or right mouse button click on the Status Bar
and choose the Close View option from the resulting menu.
If you use Konqueror tabs, you can drag and drop between tabs by dragging the file to the tab
label, without letting go yet. The destination tab will pop to the front, allowing you to continue
dragging and then to drop the file.

3.6.2

Duplicate File or Folder Names

If you try to paste a file or folder into a folder that already contains an item with the same name,
Konqueror will pop up a dialog box warning you that the item already exists. You can then
choose to:
Cancel the paste operation by pressing the Cancel button.
Give the item that is being copied a different name. You can do this by typing a new name into
the text entry box or get Konqueror to Suggest New Name. When you have done this press
the Continue button.
If you have copied multiple items, Skip the current item.
The Apply to All button can be used if you have copied multiple items.

3.7

Selecting Items in the View

There are several ways to select items in the view. Once a group of items is selected, all actions,
such as Cut, Copy, Move to Trash, and drag and drop operations, affect all selected items.

3.7.1

Selecting Items Using the Mouse

You can press the left mouse button somewhere in the view and draw a rectangle around a
group of items before releasing the button. This will select all items in the rectangle and clear
the previous selection. If the Shift key is pressed during the selection process, the previous
selection is kept.
If the Ctrl key is pressed while an item is clicked with the left mouse button, the selection state
of this item is toggled. If the Ctrl key is pressed while a rectangle is drawn around a group of
items as described above, the selection state of all items in the rectangle will be toggled.
If the Shift key is pressed while an item is clicked with the left mouse button, all items between
the previous current item and the clicked item will be selected.
If Show selection marker is enabled in the Behavior tab of the File Management General
section of the settings, a small + or - button appears in the top left corner of the item which
is currently hovered over with the mouse. Clicking this sign selects or deselects the item,
respectively.

3.7.2

Selecting Items Using the Keyboard

If an arrow key, Page Up, Page Down, Home, or End is pressed, the new current item is
selected, and the previous selection is cleared.
If the Ctrl key is held while one of the above keys is pressed, the selection remains unchanged.
20

The Konqueror Handbook

If the Shift key is held while one of the above keys is pressed, all items between the previous
current item and the new current item will be selected.
If Ctrl+Space is pressed, the selection state of the current item is toggled.
Ctrl+A selects all items in the view.
Ctrl+Shift+A toggles the selection state of all items in the view.
Select a file or folder by typing the first few letters of its name and the first matching item is
selected. To clear the selection and cancel the keyboard search press Esc or wait longer than
the timeout of 1 second.

3.7.3

Selecting Items Using the Menu

You sometimes want to delete, copy or move a number of files that are similar in some way.
For example you may wish to move all of the .png graphics files from one folder to another.
Konqueror makes this easy by letting you select multiple files based on similarities in their file
names.
Use the Menubar Edit Selection Select Matching Items... option or the shortcut Ctrl+S.
This brings up a little dialog box in which you enter a filename containing the wildcard characters
*, which matches any number of characters, and ? which matches a single character. Press OK
and Konqueror will highlight all files with matching names. For example:
flag*.png will select all filenames starting with the letters flag and ending with .png.
memo?.txt will select memo1.txt and memo9.txt but not memo99.txt.
When you have selected a range of files, you can narrow down the selection by using the
Menubar Edit Selection Unselect Matching Items... option to specify which of the selected
files should be removed from the selection.
Use the Menubar Edit Selection Unselect All option or just left mouse button click on a
clear area of the view to cancel the selection.
You can even invert the selection: that is, deselect all selected files and select those that
were previously unselected. Use the Menubar Edit Selection Invert Selection option or
Ctrl+Shift+A to do this.

3.8

Create New

When Konqueror is in File Manager mode, picking Create New from the Edit menu or from the
context menu you get by right mouse button clicking on a free area in a folder view gives you a
submenu letting you create any of the following in the current folder:
Folder...
An easy way of creating a new (sub)folder.
Text File...
Use this to create an ordinary, empty, text file. A dialog box will be opened for you to enter
the name of your new file.
HTML File...
Creates a skeleton HTML source file. When you type the new files name into the dialog
box it is probably best to give it a .html extension to avoid confusion.
Type of Document Document...

Depending on the installed applications and file associations several menuitems for different types of documents are displayed and enable you to create skeleton documents of the
selected type.
21

The Konqueror Handbook

Link to Location (URL)...

This lets you create an icon to open Konqueror at a particular folder or web page. As
with Link To Application... you can make the application icon appear on your desktop by
creating the link in your ~/Desktop folder or going to the Create New... sub menu by right
clicking on a free area of the desktop.
Basic link to file or directory...
Create a symbolic link for local files or folder.
Link to Application...
This option is most useful if you want to create an icon that will open a particular application. It opens a dialog box with several tabbed pages. The first, General, is where you
choose an icon and the text that will appear with it. The second page, Permissions, lets you
select who can use or modify the icon. In the Application page you must enter the Command that will run the application, for example, kwrite to start up the KWrite text editor.
kwrite /home/pam/todo.txt would open the file /home/pam/todo.txt in KWrite. Advanced options such as the file types which the application can open are also available from
this page.
To make the application icon appear on your desktop, create the link in your ~/Desktop
folder (this may be called something slightly different depending on how KDE was installed on your system) or get to the Create New... sub menu by right clicking on a free area
of the desktop instead of within Konquerors window.
If you have a lot of specialized application links and dont want to clutter up the desktop,
then why not create them in your Applications folder. You can get there in Konqueror
by choosing Go Applications. Then create a single icon on your desktop to open your
Applications folder, which is usually in ~/.local/share/applications.
To put an application link icon into the panel, first create it in the Applications folder then
drag the icon onto a clear area of the panel.
Link to Device
Use the options in this submenu to create an icon that will mount a device and open an instance of Konqueror showing its contents. To unmount the device when you have finished
with it right click on the icon and select Unmount. However, in most cases you will want
to create the icon on your desktop.

3.9

Changing Names and Permissions

The two easiest ways to change the name of a file or folder is to either right click on it and select
Rename, or select the file or folder and then press the F2 key.
To change the name or permissions of a file or folder right click on its name or icon and select the
Properties item, or if you have selected the file or folder, then you can use the Menubar Edit
Properties (Alt+Return) option.
This will bring up the Properties dialog box with several tabbed pages:
General, which gives you some information about the item and lets you change its name and,
for a folder, the associated icon.
Permissions, which shows you the items ownership and access permissions and lets you
change the permissions.

22

The Konqueror Handbook

3.9.1

Copy and Rename

If you want to make a copy of an existing file with a different name -- perhaps as a backup -- in
the same folder as the original file, do a normal Copy then when you Paste it a dialog box will
pop up complaining that the file already exists. Just type the new name into the dialogs text box
and press the Continue button (or if you are feeling lazy pressing the Suggest New Name button
will generate a new name for you).

3.10

Configuring File Associations

KDE provides many applications which can open many different types of file. Most of the time,
the defaults will work with no problems, but Konqueror provides a powerful system to allow
you to change the applications used to open each file type. For more details, choose the Settings
Configure Konqueror... menu item, select File Associations in the configuration dialog, and
click on Help.

3.11

At the Command Line

Although Konqueror is a very powerful and flexible GUI file manager, there are occasions when
the experienced Linux / UNIX user wants to get down to the basics and work at the text
command line level.
You can, of course, open an instance of Konsole, perhaps with Konquerors Menubar Tools
Open Terminal option or with F4.
If you only want to launch a program or view a URL, the Tools Execute Shell Command...
(Ctrl+E) option may be easier.
Tools Execute Shell Command... (Ctrl+E) opens a small command line dialog window where
you can enter a shell command such as ps -ax | grep kdeinit . Note that it does not
support full featured terminal control characters, so applications such as top and less will not
work properly, but it is available immediately without the delay involved in starting Konsole.
For more complex operations, Konqueror has another nice feature: the Menubar Settings
Show Terminal Emulator option, which opens up a terminal window as a new view within
Konqueror. As long as the link icon is visible at the bottom right corner of each view, the terminal
will follow any folder changes you make in the normal file manager view.

23

The Konqueror Handbook

24

The Konqueror Handbook

Chapter 4

Konqueror the Web Browser

Pamela Roberts

4.1

Connecting to the Internet

Once you are connected to the Internet you can use Konqueror to browse the Web just as easily
as you can use it to handle your local files. Just type a URL into the Location Toolbar window,
press Enter, and you are away!
If you use a dial-up modem connection, then you will be using KPPP or a similar dialer program to make the connection.
If your machine is connected to a local area network (LAN) that gives you a proxy connection
to the Internet then you will have to set Konqueror up for the proxy connection. This can be
done with the Web Browsing Proxy page of the Settings Configure Konqueror... dialog.

25

The Konqueror Handbook

If you are lucky enough to have a high speed cable connection, then the service provider will
probably give you an external cable modem which needs an ethernet connection to your machine. Unfortunately the details of how to establish the connection depend on the service
provider and to some extent on which Linux/UNIX distribution you are using. Some ISPs
connect their customers to the Internet through a proxy server, in which case you will have to
set up Konqueror to use it. You may find it useful to search the archives of your distributions
user group mailing list for help.

N OTE
An error message such as Unknown Host usually means that Konqueror cannot find a connection to
the Internet or that you have entered an incorrect URL.

4.2

Surfing and Searching

Once you have a connection to the Internet, you can surf with Konqueror just as you can with
any other browser.
Type a URL into the Location Toolbar window, press Enter or left click on the Go button at the
right hand end of the Location Toolbar, and Konqueror will download and display that page. If
you have visited the page before, Konquerors Automatic Text Completion feature can help you
type the URL a second time, or you could look through the History page in the Sidebar. If you
want to use one of the webs search engines, Konquerors Web Shortcuts feature can make this
easier.
Left click on a link in a page to open that link.
To open a link in a new instance of Konqueror, leaving the old page still visible, right mouse button click on the link and select the Open in New Window option. Alternatively, you might want
to Open in New Tab. Tabbed Browsing will let you hold a number of pages in one Konqueror
window and quickly switch between them with a single mouse click.
You could also select multiple view modes with Window Split View Left/Right
(Ctrl+Shift+L) / Window Split View Top/Bottom (Ctrl+Shift+T) option which will let you
see different pages at the same time. This can be useful if you are looking through a complicated
set of HTML pages, but make sure the little link box at the bottom right hand corner is empty
when you are doing this.
To go back to the previous page use the Alt+Left shortcut, the Back button on the Toolbar, or the
menubar Go Back option.
Similarly, once you have gone back you can go forward by using Alt+Right, the Forward button,
or the menubar Go Forward option.
There are multiple ways of scrolling the viewing area. One is to use the Up Arrow and Down
Arrow keys. You may also use the scrollbar, your mousewheel or the Page Up and Page Down
keys.
If you want to read a long webpage use the automatic scrolling feature of Konqueror. Start automatic scrolling with Shift+Down Arrow or Shift+Up Arrow. Then use these keys to increase and
decrease the scrolling speed. You can start or stop automatic scrolling temporarily by pressing
the Shift key; pressing any other key deactivates this feature.
Automatic scrolling works only in the view mode KHTML.
If you want to stop a download for any reason then use the Esc key, the Toolbar Stop button or
the Menubar View Stop item.
When you are viewing a web page with the HTML Toolbar enabled you should see two new
and
. Use these to adjust the size of the text in the page if
icons in the toolbar
you find it difficult to read. How well this works will depend on how the web page has been
constructed.
26

The Konqueror Handbook

4.3

Tabbed Browsing

By using this feature you can make Konqueror load multiple web pages in the same window, and
switch between them using tabbed pages. This way, you can preload a page in the background
while you carry on reading another.
To use tabbed browsing, right click on a link and choose Open in New Tab from the drop down
menu or middle mouse button click. The page will be downloaded and displayed as normal, but
with tabs across the top of the view, one tab for each page. left mouse button click on a tab to
view that page, or you can use the shortcuts Ctrl+, and Ctrl+. to cycle through the tab pages.
Alternatively, you can scroll through the tabs using the mouse wheel while the mouse pointer is
over the tab bar (presuming that your mouse has one). Also, double-clicking over the empty tab
bar space will open a new tab.
Using the Open new tabs in the background option in the General page of the Settings dialog,
clicking on a link downloads the page and shows a new tab for it, but the new page will not be
displayed until you left click on the tab.
If you check the Open links in new tab instead of in new window box in the General page of
the Settings Configure Konqueror... dialog, middle mouse button clicking on a link will open
it in a new tab page and if you hold the Shift key down while clicking the middle mouse button
the link will be opened in a background tab page.
Right clicking on a tab will bring up a menu with the following options:
New Tab (Ctrl+T)
This opens a new, blank, tabbed page view. You can then download a web page into it by
typing the URL into the Location Bar or by making a selection from the Bookmark Toolbar
or the Sidebar history page.
Duplicate Tab (Ctrl+D)
To create a duplicate tabbed page.
Reload Tab (F5)
Reloads the content of the current tab.
Other Tabs
Displays a submenu showing all other tabs. Choosing a tab from this list makes it the active
tab.
Other Tabs Reload All Tabs (Shift+F5)
Reloads the content of every tab.
Other Tabs Close Other Tabs
To close all but the selected tab page.
Detach Tab (Ctrl+Shift+B)
This option removes the selected tabbed page from the current Konqueror window and
opens it in a new instance of Konqueror.
Close Tab (Ctrl+W)
To close the selected tab page.

4.4

Web Shortcuts

If enabled, Konquerors Web Shortcuts feature lets you submit a query directly to a search engine
or similar web site without having to visit the site first.

27

The Konqueror Handbook

For example, entering gg:konqueror into the Location Bar and pressing Enter will ask
Google to search for items related to Konqueror.
To see what Web Shortcuts are available, and perhaps add your own, use Settings Configure
Konqueror... and open the Web Shortcuts page.
Once there, to make a new Web Shortcut select New... and you will now have a new dialog
requesting the options and specifications of your new Web Shortcut. The first field is for the
human readable name of the search provider; that is, simply the name of the Search provider.
For example, Google.
In the next field you should enter the URI that is used to do a search on the search engine. The
whole text to be searched for can be specified as \{@} or \{0}. The recommended version is
\{@} since it removes all query variables (name=value) from the resulting string whereas \{0}
will be substituted with the unmodified query string.
You can use \{1} ... \{n} to specify certain words from the query and \{name} to specify
a value given by name=value in the user query. In addition it is possible to specify multiple
references (names, numbers and strings) at once, like (\{name1,name2,...,string}).
The first matching value (from the left) will be used as substitution value for the resulting URI.
A quoted string can be used as the default value if nothing matches from the left of the reference
list.
To make a basic Web Shortcut here however, all that is required is the URI that is used to do a
search on the search engine. Following our previous example with Google, we would enter ht
tp://www.google.com/search?q=\{@}&ie=UTF-8&oe=UTF-8. You can often easily find
where to place the \{@} by doing a search on the search engine in question, and then analyzing the URL address. For example, doing a Google search for Konqueror produces the URL:
http://www.google.com/search?q=konqueror&ie=UTF-8&oe=UTF-8. Now you need to merely
replace Konqueror with \{@} in this example to find the appropriate URI to be entered.
In the third field you need to enter the URI shortcut. For example, the gg in gg:konqueror. In
the next option the drop-down menu you have the option to select the character set that
will be used to encode the search query. Once you have entered all the options correctly to your
satisfaction, press Enter and your new Web Shortcut should now be available in Konqueror.

4.5

Access Keys

Konqueror has full support for the accesskey HTML attribute in forms and links. Access keys
allow you to use the keyboard keys for functions which would perhaps normally be done with
the mouse, such as following links. The benefit of this is, quite simply, that users can interact
with a page with devices other than a pointing device.
This feature has to be enabled by checking the Enable Access Key activation with Ctrl key option
on the Web Browsing settings page.
To activate the access keys in Konqueror, press and release Ctrl. Once this is pressed, if a particular link on the website has the accesskey attribute in the given link, then the character(s) should
appear over the link, identifying what needs to be pressed. Then, you can enter the character(s)
associated with the link as an alternative to following the link with the mouse. To disable the
access keys once activated you can press Ctrl again.

N OTE
The proper use of this feature requires that the web designer of the page has specifically assigned,
using the accesskey attribute, an access key for the link. Many web designers might not include
the accesskey in their links and forms, and consequently this feature will be unusable on the given
webpage.

28

The Konqueror Handbook

4.6

Browser Identification

When Konqueror connects to a web site it sends some brief browser identification information,
known as the User Agent string. Many web sites use this information to customize the pages
that they send back, based on the strengths and weaknesses of different browsers.
Unfortunately, some badly designed sites refuse to work properly unless you are using a browser
that the site recognizes as a valid one, even though if given a chance, Konqueror will work
satisfactorily with the vast majority of web pages.
To overcome this problem you can change the browser identification information that Konqueror
sends for specific sites or domains by selecting Web Browsing Browser Identification page
of the settings dialog.

N OTE
Problems with getting a web page to work properly may also be due to its use of Java or JavaScript.
If you suspect that this may be the case check that they have been enabled in the Java & JavaScript
section of the settings dialog.

N OTE
Install the UserAgent Changer extension from the Konqueror Plugins and enable it in Settings
Configure Extensions. This extension adds a Change Browser Identification item to the Tools
menu. Using this item lets you quickly switch between different User Agent strings.

4.7

Saving and Printing Web Items

When you are viewing a web page you can save it (or at least the basic HTML or similar source
text) to your local disk with File Save As.... If the page you are viewing uses frames, then you
will also be given the File Save Frame As... option. Left click in the frame you want to save
first.
If the page uses a background image, you can get and save that with the File Save Background
Image As... option.
But if what you really want is that glorious picture of the latest Ferrari, then right clicking on the
image will give you a drop-down menu with a Save Image As... option. Be sure to respect the
owners copyright, and ask for permission before using any pictures saved this way for anything
other than your own viewing pleasure.
If you right click on a link (which may be a picture) and select Save Link As... from the pop up
menu the basic HTML or similar source text will be downloaded and saved on your local disk.
Right clicking on a link (which may be a picture) and choosing Copy Link Address will copy the
URL of the link to the clipboard so you can then paste it into, say, an e-mail to a friend telling her
about this wonderful new site.
Right clicking on a picture and choosing Copy Image copies the URL of the picture to the clipboard.
To save a complete web page, including images, select Archive Web Page... from the Tools
menu. Note that this feature is provided by a plugin and may not have been installed on your
system. The web page will be saved as a single file with a .war extension and can be opened by
left clicking on the filename in Konqueror running in File Manager mode.
Printing a copy of the page you are viewing is easily done with the Menubar File Print... or
Print Frame option or with the Toolbar Print button.

29

The Konqueror Handbook

4.8

FTP

FTP, or File Transfer Protocol, is one of the earliest, and still perhaps the best, way of transferring
files between computers over the Internet.
With FTP you can see files and folders on the distant computer just as if they were on your
own system, download them onto your computer using Konquerors normal Copy and Paste or
Drag n Drop methods and, if allowed, upload files from your machine to the other computers
filesystem. To try it, type the URL
ftp :// ftp . kde . org / pub / kde

into the Location Toolbar and press Enter. As long as you are connected to the Internet, and
as long as the KDEs FTP site is not too busy, you should end up seeing the /pub/kde folder at
ftp://ftp.kde.org/pub/kde/

N OTE
Although, strictly speaking, FTP URLs should be entered starting with ftp:// and WWW URLs
starting with http:// Konqueror is usually smart enough to figure out what is meant, and insert
these characters for you if you leave them out.
When you access an FTP site it will usually need some form of username and password from
you. To simplify things, most FTP sites that offer files for free downloading will accept the word
anonymous as a username and your email address as a password, and to make your life even
easier Konqueror will automatically supply these without troubling you.

N OTE
If you try to access an FTP site that does not need a proper username or password but which is too
busy to accept any more connections, Konqueror often interprets the busy message as a request for
a name and password and will therefore pop up a dialog box asking you to supply them.
Sites that are more concerned with security will need a proper username and password, in which
case Konqueror will ask you for them or you can include the username in the URL you type into
the Location Toolbar, as for example
ftp :// username@ftp . cia . org

Konqueror will then prompt you for the password.

Konqueror can also support automatic logins as specified in a .netrc file. Details of how to
enable this feature are given at http://www.konqueror.org/faq.html#netrc

4.9

URLs with Port Numbers

If you specify a port number in your URL, as in for example http://intranet.corp.com

:1080, you might get the error message Access to restricted port in POST denied. This is done
for security reasons. If you nevertheless need to access a server on this port, just add a key line
OverridenPorts = CommaSeparatedListOfAllowedPorts

to $KDEDIR/share/config/kio_httprc or ~/.kde/share/config/kio_httprc.
For example
OverridenPorts =23 ,15

30

The Konqueror Handbook

(it should not include any embedded spaces).

Konqueror will reject the following ports (the list is hardcoded in kdelibs/kio/kio/job.cpp):
1, 7, 9, 11, 13, 15, 17, 19, 20, 21, 22, 23, 25, 37, 42, 43, 53, 77, 79, 87, 95, 101, 102, 103, 104, 109, 110,
111, 113, 115, 117, 119, 123, 135, 139, 143, 179, 389, 512, 513, 514, 515, 526, 530, 531, 532, 540, 556,
587, 601, 989, 990, 992, 993, 995, 1080, 2049, 4045, 6000, 6667

31

The Konqueror Handbook

Chapter 5

Automatic Text Completion

Pamela Roberts
You can get Konqueror to help you enter a path or URL into the Location Toolbar by enabling one
of the Text Completion features. To do this right click on a clear part of the Location Toolbar text
entry box and select Text Completion from the pop up menu. This will let you choose between
the following options:
None
What you get is what you type.
Manual
When you have typed part of a path or URL, pressing Ctrl+E or Tab will complete the entry
if it is possible to do so unambiguously.
Automatic
As you type into the Location Toolbar window Konqueror will automatically extend what
you type to complete one possible path or URL, highlighting the characters it has added.
Continue typing if thats not what you wanted or press Enter to accept it.
Dropdown List
A drop-down window will appear as you type, showing the possible matches to what you
have typed so far. When the path or URL that you want appears in the window click on
it with the left mouse button. You can also use the Down Arrow or Tab and Up Arrow or
Shift+Tab keys to select it then press Enter.
Short Automatic
This is like Automatic mode except that it only extends what you have typed as far as the
next / symbol in the path or URL. Press Ctrl+E or Tab to accept the suggestion, Enter when
the complete path or URL is shown.
Dropdown List & Automatic
This is a combination of both options described above.
Default
This item appears at the bottom of the submenu and enables you to switch to the default
behaviour Dropdown List.
You should try out these different modes and pick the one that suits you best.
The history of recently visited URLs that Konqueror uses for the Text Completion function can
be viewed and edited in the History page of the Sidebar.

32

The Konqueror Handbook

Chapter 6

Using Bookmarks
Pamela Roberts
Although you can use Konquerors bookmarks to record the locations of your own files and
folders, they are most useful when you are surfing the Web, letting you build up a list of useful
sites.
To open the Bookmarks menu left click on the Bookmarks menu. Once the list is visible, you can
navigate through it with the arrow keys or with your mouse, then press Enter or left click to visit
the selected location.
To add a new item to the list use Bookmarks Add Bookmark or Ctrl+B or right click on a clear
space in the web page or folder view and select Bookmark this Page / Bookmark this Location
from the pop up menu.
The Bookmarks list can contain subfolders containing other bookmarks, you can create these
with Bookmarks New Bookmark Folder... To add a bookmark into a subfolder rather than
into the main Bookmark list, select the folder from within the Bookmarks list and use the Add
Bookmark item in that folder.
You can also access your bookmarks from the Sidebar or from the Bookmark Toolbar.
If you enter bookmarks:/ in the location bar the bookmarks home page with an overview of
all bookmarks and folders is shown.

6.1

The Bookmark Editor

The Bookmarks Edit Bookmarks option opens the Bookmark Editor.

This shows a tree view of your bookmarks and bookmark subfolders. As is usual for tree views
in KDE, subfolders are shown with a small > arrow at the left of the folder name; left clicking on
it will expand the view to show the contents of that subfolder and the > arrow will change to v;
left clicking on the v arrow will collapse the subfolder view.
To select an item in the list you can left click on it, or you can navigate through the list by using
the Up arrow and Down arrow keys to move around, Right arrow to expand a subfolder and
Left arrow to collapse it.
You can move an item to a different place in the list by using the normal Drag and Drop or Cut
and Paste methods. The order in which the items appear in the Bookmark Editor is the order
they will appear in the Bookmarks drop down list. The Folder Insert Separator option can
be used to insert separating lines into the list wherever you wish.
A new subfolder can be created at the selected point in the list by using the New Folder... option
in the Folder menu or from the drop down menu you get when you right click on an item in the
main part of the window, or with Ctrl+N
33

The Konqueror Handbook

To change the name of a bookmark or folder select it then press F2 or choose the Rename item
from the Edit menu or the pop up menu that appears when you right click on the item. Similarly,
you can edit the URL by pressing F3 or choosing the Change Location menu item.
The Bookmark Editor lets you import bookmarks from a range of other browsers into Konquerors bookmark list, putting them into a new folder or replacing all current bookmarks. To
do this select Import from the File menu. The File Export option can be used to export Konquerors bookmarks to a Netscape or Mozilla browser.
To select which bookmark subfolder is used to hold the Bookmark Toolbar items select the subfolder then choose Set as Toolbar Folder from the Folder menu.
If you are tidying up your bookmarks and have forgotten what a particular web page is, you can
easily open it from within the Bookmark Editor by right clicking on the item and selecting Open
in Konqueror from the pop up menu. If you just want to check that the URL is still valid select
Check Status instead.

N OTE
All your changes are automatically saved if you close the Bookmark Editor.

34

The Konqueror Handbook

Chapter 7

The Sidebar
Pamela Roberts
The Sidebar appears as a separate view at the left of Konquerors window. It can be invoked with
Settings Show Sidebar or toggled on and off with the F9 key.

It contains a number of tabbed pages; left click on a tabs icon to view that page. Left clicking on
the icon for the visible page will collapse the Sidebar so that only the tab icons are visible.
Bookmarks
This page shows a tree view of your Bookmarks. Left click on an item to open it in the main
view.
History
This page shows a tree view of your browsing History. Left clicking on an item will open
it in the main view, or you can open it in a new Konqueror window by right clicking and
selecting Open in New Window from the pop up menu.
You can remove an item from the history by right clicking on it and selecting Remove Entry.
Selecting Clear History will clear out the entire history.
The pop up menu you get when you right click on any entry in the History page also gives
you the option of choosing whether the entire history is sorted by name or by date.
35

The Konqueror Handbook

Selecting Preferences... from this pop up menu brings up the History Sidebar control module. This can be used to set the maximum size of your history and set a time after which
items are automatically removed. You can also set different fonts for new and old URLs.
The Detailed tooltips checkbox controls how much information is displayed when you
hover the mouse pointer over an item in the history page.
Home Folder
This page shows a tree view of the subfolders of your home folder. Note that hidden
folders (those with names beginning with a dot) are not shown. Left click on an item to
open it in the main view, or right click to display a pop up menu allowing you to open the
subfolder in a new window or as a new tab page of the main view.
Network
This page is intended to show a tree view of your important network connections, although
local folders can also be included. Again, you can left click on an item to open it in the main
view or right click to bring up a menu with a wider range of possibilities.
The folders shown in the Network page are held in the folder ~/.kde/share/apps/konq
sidebartng/virtual_folders/remote/ , and you can make new ones just as you would
make any other subfolder. The items within these folders are held as .desktop files and can
be created with Konquerors Create New Link to Location (URL)... option in the Edit
menu.
Root Folder
The Root Folder tree has the path / , and is the base folder of your systems local files.
If you expand the Root folder you will find another folder called root. This belongs to
the system administrator or Super User and is her home folder. You will also find a folder
called home, in which you should be able to find your own Home folder again.
Services
This page provides quick access to the following services:
Applications, Audio CD Browser, Fonts and Video DVD Browser.
Places
The Places panel is located at the left of the window by default. The Places panel shows any
locations you have bookmarked. It also shows any disk or media attached to the computer.
The easiest way to add a folder to the Places panel is to drag it and drop it in the panel.
Moreover, you can click inside the panel with the right mouse button and choose Add
Entry... from the context menu.
The Sidebar configuration can be changed by right clicking on the empty area below the bottom
tab icon or by left clicking on the Configuration Button icon, which is enabled in the context
menu. Doing this brings up a menu with the following options:
Add New
This option lets you add a new tab page to the Sidebar. The new page can contain different
Sidebar modules or a new Folder tree view. The last option in this submenu allows you to
rollback to system default.
Multiple Views
Selecting this option splits the Sidebar so that two tab pages can be seen at once.
Show Tabs Left, Show Tabs Right
This option lets you choose whether the tab icons are shown at the left or right of the Sidebar.
Show Configuration Button
Use this option to show or hide the Configuration Button icon.

36

The Konqueror Handbook

Right clicking on a tab icon brings up a menu with the following options:
Set Name
This option lets you change the Name of that page.
Set URL
This option lets you change the URL (path) of the folder viewed in that page.
Set Icon
To change the tab icon.
Remove
To remove the tab page from the Sidebar.
Configure Sidebar
The last item shows the Sidebar configuration submenu as described above.

37

The Konqueror Handbook

Chapter 8

Saving Settings & Profiles

Pamela Roberts

8.1

General Settings

When you close down Konqueror your current View menu settings (such as the View Mode, Use
index.html and Show Hidden Files items) are not automatically saved as the default options;
however, you can have Konqueror remember these settings by selecting Settings Save View
Profile As... and the current setting will become the default option to be used the next time
Konqueror is started.
But you can also specify different View menu settings for an individual folder. To do this select
View Adjust View Properties..., change the View settings in the dialog to whatever you want.
Then apply the view properties to the Current folder. Doing this creates a .directory file in
that folder to hold the folder View settings. Use this dialog again to remove the folder specific
settings (or just delete the .directory file).

N OTE
One nice use of this feature is if you have a folder full of pictures, you can set that particular folder to
display thumbnails of the pictures (by choosing the View Mode Icons and Preview from the View
menu) when you open it, while not displaying images as thumbnails in other folders.

8.2

View Profiles

Konqueror can save a whole set of options as a View Profile. Some view profiles are part of the
standard Konqueror installation, such as Web Browsing, File Management, KDE Development,
Midnight Commander and Tabbed Browsing; but you can add your own, too.
To modify a view profile (say, the Web Browsing profile), load the profile with Settings Load
View Profile Web Browsing, and change the Konqueror settings to whatever you want. Now
select Settings Save View Profile As... . In the dialog which appears, you can change the name
of the profile, which will create a new profile with that name, or you can leave the name as it is
to modify the current profile. If you select Save URLs in profile, the current URL will be loaded
when you load that view profile. This functions in a similar way to the Home Page in many
web browsers. If you want Konqueror to start up with an empty window enter about:blank
into the location bar before saving the profile.

38

The Konqueror Handbook

N OTE
You can create a desktop icon to start Konqueror with your new profile. First create a desktop icon by
clicking with the right mouse button onto the Konqueror entry in the application launcher menu. Then
select Add to Desktop in the context menu. Open the settings dialog of the new icon on your desktop
by clicking on the Tools icon. Change Command in the Application tab page to kfmclient ope
nProfile MyNewProfile, MyNewProfile being what you called the new profile. Then change
the name to something like MyNewProfile .

39

The Konqueror Handbook

Chapter 9

Plugins
Pamela Roberts

9.1

Netscape Plugins

Currently, Konqueror supports Netscape plugins.

Selecting Settings Configure Konqueror... opens the configuration dialog. Select the Plugins
page, where you find two tabs: Global Settings to enable plugins and configure how they are
used in Konqueror and Plugins which shows you the Netscape plugins that KDE has found
and allows you to scan for plugins.
For more information see the Browser Plugins help page.

9.2

Konqueror Plugins

KDE releases several useful plugins that interact with Konqueror in various ways. These are
explained briefly below.
Use Settings Configure Extensions... to open a dialog with all installed plugins and select the
ones you need. All plugins are accessible in the Tools menu.
Only plugins appropriate for the current mode (file manager or browser in KHTML/WebKit
view) are listed in the dialog.
B ROWSER M ODE
Web Page Translation
This uses the machine translation service provided by Google Translate to translate the
current HTML page to whatever language you want (within reason). It can be launched
with Tools Translate Web Page.
If you have a portion of the text on the page selected, that will be translated instead of the
entire URL.

I MPORTANT
Machine translation is not a perfect science! Google will at best give you a rough translation, and
at worst will give you a very funny read. Dont base important decisions on things you have read
from a Google translated page, without confirming that the translation is indeed accurate.
40

The Konqueror Handbook

N OTE
You may only translate web pages that are accessible on the world wide web. To translate any
other text, you should go directly to the Google site itself, where you are able to paste in text for
translation.
DOM Tree Viewer (KHTML view only)
The DOM Tree Viewer allows a developer to view the styles, attributes and elements of a
web document.
Selecting Tools Show DOM Tree opens a new window which displays the document
object model (DOM) of the current HTML page.
By default the display starts at the root node of the document, example: documentElement, all other nodes that you will see are children or descendants of the root node.
If you wish to manipulate the DOM tree in any way you will have to use an external script
to do so.
Web Page Validator
This plugin uses the W3C HTML validator to validate the current page, very useful when
creating web pages.
Validate HTML (by URI) / Validate HTML (by Upload)
The validate HTML option allows you to compare your HTML document to the defined syntax of HTML and reports any errors found. Validating your HTML will ensure that your pages display properly on all browsers.
Validate CSS (by URI)
Allows you to validate your CSS style sheet that is embedded in an HTML or XHTML
document. Having valid CSS is critical to ensuring that your web site maintains a
consistent look regardless of the browser that is being used.
Validate Links
Allows you to confirm that the links on your site contain no redirects or broken links.
This tool recursively checks all links on a site.
Validate Page
Validates the current page but does not show the result in another window or tab as
the previous actions. Using this item enables the action View Validator Report to
display a summary of the validation.
Configure Validator
The configure validator item allows you to view the preset validators you can use to
validate your HTML and CSS.
HTML Settings
Select Tools HTML Settings to enable or disable a number of HTML settings without
going through the Settings dialog.
JavaScript
Allows you to turn the use of JavaScript in Konqueror on or off.
Java
Allows you to turn the use of Java in Konqueror on or off.
Cookies
Allows you to turn the use of Cookies in Konqueror on or off.
Plugins
Allows you to turn the use of the Konqueror plugins you have installed on or off.
Autoload Images
Allows you to turn on or off the loading of images in web pages.
41

The Konqueror Handbook

Enable Proxy
Allows you to enable or disable the use of a proxy in the Konqueror browser.
Enable Cache
Allows you to enable or disable the use of a cache in the Konqueror browser.
Cache Policy
The Cache Policy submenu provides you with a way to configure how Konqueror uses
a cache. The possible uses include:
Keep Cache in Sync
Use Cache if Possible
Offline Browsing Mode
User Agent Changer
Select Tools Change Browser Identification to get a menu that allows you to change the
User Agent string without going through the Settings dialog procedure.
The plugin allows you to change the Browser and Operating System identification on a
domain-by-domain basis. This is useful when browsing websites that limit access to those
using a particular web browser.
Default Identification
The
default
User
Agent
header
for
Konqueror
is
Mozilla/5.0(compatible;Konqueror/4.7)(KHTML/4.7, like Gecko). If you come across
a site that refuses this browser access, change your User Agent to one of the options
below.
Browser submenu
The following menu items show a list of popular browsers such as Firefox, Internet
Explorer, Netscape Navigator, Opera, Other, and Safari.
Apply To Entire Site
This option allows you to specify that the defined User Agent applies across every
page on the site you are visiting.
Configure
Selecting Configure opens the settings dialog and allows you to fine tune the amount
of information you wish to reveal about the browser and operating system being used.
Archive Web Page (KHTML view only)
Invoked with Tools Archive Web Page, this tool creates an archive (.war ) file containing
the web page being viewed including the images. Left click on the archive file name to view
the saved page.
F ILE M ANAGER M ODE
Directory Filter
This is controlled by Tools Show Filter Bar (Ctrl+Shift+I) and allows you to choose
which types of item are displayed in a folder.
Image Gallery
In File Manager mode, you can select Tools Create Image Gallery or use Ctrl-I to create
an HTML page with thumbnails of all the images in the current folder. By default the
HTML page is called images.html and the thumbnails are put into a new images folder.
When you start the Image Gallery plugin a dialog opens allowing you to adjust the way the
gallery is created.
PAGE L OOK

42

The Konqueror Handbook

The Look dialog is for adjusting the appearance of the gallery page.

Page title
The Page title option has a text input box for changing the title of the image gallery
page.
Images per row
The Images per row option has a slider and a spin box for adjusting the number
of thumbnails that are in a single row in the gallery.
Show image file name
The Show image file name check box allows you to choose whether to display
filenames below the gallery thumbnails.
Show image file size
The Show image filesize check box allows you to choose whether to display filesizes below the gallery thumbnails.
Show image dimensions
The Show image dimensions check box allows you to choose whether to display
image dimensions in pixels below the gallery thumbnails.
Font name
The Font name combo box provides you with a choice of which font to use in
creating the gallery.
Font size
The Font size spin box is for changing the size of the font you selected.
Foreground color
The Foreground color option has a selector for choosing the foreground color of
the gallery, this includes the text areas.
Background color
The Background color option has a selector for choosing the background color of
the gallery.
F OLDERS
The Folders dialog is used for choosing where to save the gallery. This dialog is also used to configure wh

43

The Konqueror Handbook

Save to HTML file

The Save to file selector allows you to decide where you want to save your
image gallery html page.
Recurse subfolders
The Recurse subfolders check box enables recursing of subdirectories. If the
check box is enabled, a slider and spin box are enabled to select the recursion
depth.
Copy original files
The Copy original files check box creates an image folder storing copies of the
original images used in the gallery.
Use comment file
The use comment file check box enables a file selector to choose a comments
file to use with your gallery. The comment file contains the subtitles for the
images.
The format of this file is:
# this is a comment , lines starting with # are ignored
FILENAME1 :
Description
FILENAME2 :
Description

T HUMBNAILS
The thumbnails dialog is used for adjusting the properties of the thumbnails in the gallery.

44

The Konqueror Handbook

Image format for the thumbnails

The image format combo box allows you to choose which format is used for
the thumbnail images.
Thumbnail size
The thumbnail size option provides a slider and spin box for adjusting the size
of the thumbnails used in the gallery.
Set different color depth
The set different color depth check box enables a combo box for changing the
color depth of the thumbnails if you wish to use a different color depth to that
used in the original image.
Search Bar
Provides a text box for easy access to search engines such as Google. Clicking on the icon
on the left side of the search box opens a menu to select and enable different search engines
and configure their Web Shortcuts.
Shell Command Plugin
This plugin enables you to execute a shell command in the current folder and view the
output in a separate window.

45

The Konqueror Handbook

Chapter 10

View Mode Extensions

Konqueror provides additional views in View View Mode in file manager and browser mode,
if the corresponding applications and plugins are installed.
The file manager mode has the additional views Radial Map from the application Filelight and
the Konqueror plugin File Size View.

10.1

FSView - the File System View

10.1.1

Introduction

The FSView Plugin for Konqueror is another view mode for objects of mimetype inode/direct
ory for local files. It can be viewed as an alternative to the various iconviews and listviews for
browsing the content of your local file system.
The unique property of FSView is its ability to show whole nested folder hierarchies using a
so-called tree map for graphical visualization. Tree maps allow for displaying metrics of objects
in nested structures: each object is represented by a rectangle whose area is proportional to its
metric. The sum of the childrens metrics must be equal to or smaller than the parent objects
metric.
For FSView, sizes of files and folders are chosen as the metric, where the size of a folder is defined
to be the sum of the sizes of its subitems. This way, big files even deep down in the folder
hierarchy can be spotted easily be looking for large rectangles. So FSView can be looked at as a
graphical and interactive version of the UNIX du command.
The integration of FSView as part of Konqueror allows it to use the standard features such as
context file menus, and mime type sensitive actions. But it was chosen not to implement automatic update by watching file system changes: if you delete a file shown in FSView outside of
Konqueror, you have to update manually by e.g. pressing F5 to see the change. The reason for
this decision is the potentially huge number of files which would have to be watched for changes,
and thus, could put an unreasonable pressure on system resources for a small feature.

10.1.2

Visualization Features

This section explains the graphical visualization of FSView in detail.

10.1.2.1

Item Drawing Options

In FSView, an item of the tree map visualization is a rectangle representing a file or folder of your
file system. For easier navigation, rectangles have meaningful coloring and labeling options.
46

The Konqueror Handbook

The color of a rectangle, switchable via menu item View Color Mode can be either representative of Depth, for easy detection of nesting, or a color mapping of different file attributes such
as name, owner, group, or mime type.
A rectangle can be labeled with the various attributes of the corresponding file or folder. For each
attribute, you can choose whether it should be shown at all, only if space is available, or if space
should be taken from children (thus introducing errors to pure tree map drawing constraints).
Additionally, you can choose the relative location of the label in the rectangle.
10.1.2.2

TreeMap Drawing Algorithms

For drawing algorithms in tree maps, the rule that the area is proportional to the metric of an
item should hold true. With the tree map in FSView, this goal isnt always met: we draw borders
to show the nesting of items, and this border takes space for an item which is possibly lost for the
areas of child items. Note that less space is lost for the border if the rectangle is quadratic.
Similarly, it is better for a good overview to let each rectangle at least have its name as a label. It is
an option to always force space for labels, or only to draw labels when empty space is available.
In the latter case, the tool tips appearing when the mouse is held over an item can help a lot. They
show information for the item the mouse is currently over, together with its parent folders up to
the root item of the tree map.
How the space of an item is split into subareas for children is left to the implementation. It is
always better to try to split areas in such a way that rectangles are as quadratic as possible, both
for labeling and less space lost by borders. The best methods in this regard are Rows, Columns,
or Recursive Bisection.
You can choose the minimal area of items to be drawn via the menu item View Stop at Area.
Instead, a hash pattern will be drawn over the parents area to signal that this space is in fact
occupied by a child or children.

10.1.3

User Interface

FSView supports multiple selection of items, similar to the iconview and listview. This allows for
actions to be done simultaneously to a set of files. A simple mouse click always selects a single
item below the mouse pointer. Use a mouse click in combination with pressing the Shift key for
range selection or the Ctrl key for selection toggle. Note that by selecting an item, subitems can
no longer be selected. Selecting an item will also clear the selection of all its parent items before.
Keyboard navigation is available in tree maps: use Left Arrow and Right Arrow keys to move
the current item between siblings, and the Up Arrow and Down Arrow keys to go up and down
the nesting hierarchy. Space selects the item; in conjunction with Shift does range selection; and
with the Ctrl key held down simultaneously, toggles selection of the current item. Press Return
to run the open action on the current item.

10.1.4

Credits and License

Originally, FSView was meant as a small test application and usage tutorial for the TreeMap
widget developed within KCachegrind.
Copyright by Josef Weidendorfer, licensed using GPL V2.

47

The Konqueror Handbook

Chapter 11

Configuring Konqueror
Pamela Roberts
In common with the rest of KDE, Konqueror is highly configurable, so you can really get the look
and feel that best fits your needs and wishes.

11.1

Toolbars

When KDE is newly installed, Konquerors window contains a Menubar, Main and Location
Toolbars and possibly a Bookmark Toolbar.
Maybe you dont need all these toolbars. To hide one of them, go into the Settings Toolbars
Shown menu and uncheck its box. To show a hidden toolbar, just check the box.
The Menubar itself can be toggled on and off with the shortcut key combination Ctrl+M.
If you right click on a Toolbar, you will get a menu to configure this bar. You can lock or unlock
the toolbar position and choose the text position, icon size and the orientation of unlocked bars.
If the toolbars are unlocked, on the left hand end of each bar you can see some handles. By left
mouse button clicking on them, you can drag a bar into a new position and even detach it from
the window and place it anywhere on your screen.
The icons shown in the various bars can be changed by using the Settings Configure Toolbars... option, which brings up the Configure Toolbars dialog box. The number and type of
these toolbars will depend on whether Konqueror is in Web Browser or File Manager mode and
whether you have Konqueror plugins installed.

11.2

Shortcuts

To change the shortcut key arrangements used by Konqueror select Settings Configure Shortcuts... . This will launch a dialog box as shown below.

48

The Konqueror Handbook

Use the search box to find the action you want to add or change the shortcut keys for and select
it by left clicking on the name.
After you have selected an action in the list you will notice that this item is highlighted and
you see two additional check boxes below this item in the list view. There you can configure a
combination of keys or maybe no key binding at all for the selected action.

Default: the selected action will be associated with KDEs default value. This is a good choice
for most actions, as KDE comes with reasonable key bindings we have thought about.
Custom: if this option is enabled, you can create a key combination for the selected action.
Click on the button labeled either None or labeled with the previously selected custom shortcut. Now the button label changes to Input. Then press any modifier key (i.e. Shift, Ctrl, or
Alt) and then normal key or a function key (e.g. F11) you want to assign to this key combination.
You can reset the shortcut to None by using this button:
49

The Konqueror Handbook

Clicking on the Alternate column of a row in the list allows to edit the second shortcut for the
action.

11.3

Other Settings

Selecting Settings Configure Konqueror... brings up a dialog box which you can use to control
most aspects of Konquerors behavior.
It contains these sections which are selected by left clicking on one of the icons at the left of the
dialog box:
General: Configure general Konqueror behavior
Performance: Configure settings that can improve Konquerors performance
Bookmarks: Configure the bookmarks home page
File Management: You can configure how Konqueror behaves as a file manager here
View Modes: Configure file manager view modes
Navigation: Configure file manager navigation
Services: Configure file manager services
General: Configure general file manager settings
File Associations: Configure file associations
Trash: Configure trash settings
Web Browsing: Configure the browser behavior
Proxy: Configure the proxy servers used
Appearance: Configure how to display web pages
AdBlocK Filters: Configure Konqueror AdBlocK filters
Web Shortcuts: Configure enhanced browsing
Cache: Configure web cache settings
History: Configure the history sidebar
Cookies: Configure the way cookies work
Browser Identification: Configure the way Konqueror reports itself
Java & JavaScript: Configure the behavior of Java and JavaScript
Plugins: Configure the browser plugins
Pressing the Help button will give you detailed instructions about how to use each of these
sections, or you can use the Whats This? feature.

50

The Konqueror Handbook

Chapter 12

Command Reference
Pamela Roberts

N OTE
The shortcut key combinations shown in this chapter are the default ones. They can of course be
changed.

12.1

Special Shortcuts

There are some useful shortcuts that are not shown in any of the menus:
F6
Sets the focus to the text entry box in the Location Toolbar.
Ctrl+.
Activate the next tab page.
Ctrl+,
Activate the previous tab page.

12.2

The Menubar

Note that some menu entries only appear when they are applicable to the file you currently have
open in Konqueror. For example, the Edit Find... item will not appear when you are viewing
the contents of a directory.
Konqueror has different menu items in file manager and browser mode. Only the items for these
two modes are described in this chapter.
If Konqueror is using embedded components (KDE Parts) such as Gwenview for image viewing,
Okular for PDF and PostScript documents etc. the menu items from these applications are
merged into Konquerors menu. Help for these additional menu items you find in the handbook
of the embedded application.

51

The Konqueror Handbook

12.2.1

The File Menu

File New Window (Ctrl+N)

Open another Konqueror window.
File New Tab (Ctrl+T)
Open another Konqueror tab, containing a blank page.
File Open Location... (Alt+O)
Sets the focus to the text entry box in the Location Toolbar.
File Open File... (Ctrl+O)
Open a file using the KDE file dialog.
File Sessions
Open a submenu to save the current session (open tabs and windows) for easy retrieval,
manage sessions and switch to previously saved sessions.
File Send Link Address...
Send an email containing a link to the current location.
File Send File...
Send an email containing the selected file as an attachment.
File Save Background Image As... (Browser mode)
Only applies if you are viewing a web page with a background image. Opens the Save As
dialog box to let you save the background image file to your own computer.
File Save As... (Browser mode)
Only applies if you are viewing a document or web page, uses the Save As... dialog box to
let you save a copy to your own computer.
File Save Frame As... (Browser mode)
Similar to Save As... but for use with a web site that uses frames.
File Print... (Ctrl+P)
Print.
File Print Frame (Browser mode)
Print selected frame of a Web page.
File Quit (Ctrl+Q)
Close down this instance of Konqueror.

12.2.2

The Edit Menu

Edit Undo: Action (Ctrl+Z)

Sometimes lets you reverse a mistaken action.
Edit Cut (Ctrl+X)
Puts selected item(s) into the clipboard. If you then paste the items they will be moved from
the original location to the new one.
Edit Copy (Ctrl+C)
Copy selected item(s) to the clipboard.
Edit Paste (Ctrl+V) (Browser mode)
Paste the clipboard content into the Location Bar.
52

The Konqueror Handbook

Edit Paste Clipboard Contents... (Ctrl+V) (File Manager mode)

Paste the currently copied/cut item(s) to the current folder. If the clipboard does not contain
files or folders, the clipboard contents (such as text or image data) will be pasted into a new
file.
Edit Select All (Ctrl+A) (Browser mode)
Selects all text in an HTML page or in a text page being previewed, you can then Copy it
and Paste it into a text editor.
Edit Create New (File Manager mode)
Creates a new object (such as a folder or a text file) in the current folder. See the Create
New... section for more details.
Edit Rename (F2) (File Manager mode)
Lets you rename a file or folder without having to open the Properties... dialog box.
Edit Move to Trash (Del) (File Manager mode)
Move selected item(s) to the Trash folder.
Edit Delete (Shift+Del) (File Manager mode)
Delete the selected item(s).
Edit Edit File Type... (File Manager mode)
Open the Edit File Type dialog box
Edit Properties... (Alt+Return) (File Manager mode)
Shows the properties dialog for the currently selected item(s).
Edit Selection Select Items Matching... (Ctrl+S) (File Manager mode)
Together with the Unselect Items Matching..., Unselect All and Invert Selection commands, this provides an easy and powerful way of selecting multiple files.
It brings up a simple dialog box where you can enter a file name using the wild card characters * and ?, for example entering *.html will select all files ending with .html while ?a*
will select all files which have the letter a as the second character in their filename.
Edit Selection Unselect Items Matching... (File Manager mode)
Unselect files or folders via a dialog similar to the one used by Select....
Edit Selection Select All (Ctrl+A) (File Manager mode)
Selects all items in a folder; you can then Copy or Cut them and Paste them into a different
folder.
Edit Selection Unselect All (File Manager mode)
Unselect all selected files or folders.
Edit Selection Invert Selection (Ctrl+Shift+A) (File Manager mode)
Invert current selection.
Edit Find... (Ctrl+F) (Browser mode)
Displays the search bar at the bottom of the current window. Start typing to find a text
string in a text page you are previewing or in an HTML page.
Edit Find Next (F3) (Browser mode)
Find the next occurrence of the text string in the text or HTML page.
Edit Find Previous (Shift+F3) (Browser mode)
Find the previous occurrence of the text string in the text or HTML page.

53

The Konqueror Handbook

12.2.3

The View Menu

View View Mode

In browser mode this submenu holds items to select embedded views like KHTML, Embedded Advanced Text Editor and more embedded views.
In file manager mode this submenu holds items to select Icon, Details, Compact, Terminal
Emulator and more view modes.
View Use index.html (File Manager mode)
If a selected folder contains a file index.html, it will be opened as a web page rather than
showing the folder as a list of files.
View Lock to Current Location
A locked view cannot change folders. Use in combination with Link View to explore many
files from one folder.
View Link View
Link current view to others in a multiple view window. A linked view follows folder
changes made in other linked views. This is especially useful with different types of views,
such as a folder tree with an icon view or detailed view, and possibly a terminal emulator
window.
View Reload (F5)
Reload.
View Stop (Esc)
Stop load (particularly useful when web browsing).
View Enlarge Font (Ctrl++) / View Shrink Font (Ctrl+-) (Browser mode)
Use these to adjust the size of the text in the page if you find it difficult to read. How well
this works will depend on how the web page has been constructed.
View View Document Source (Ctrl+U) (Browser mode - KHTML view)
View document source text.
Only available if you are viewing a document or HTML page.
View View Frame Source (Browser mode)
View frame source text
Only applies if you are viewing a web site that uses frames. Similar to View Document
Source.
View View Document Information (Ctrl+I) (Browser mode - KHTML view)
View document information, such as title, URL, and HTTP headers used in retrieving the
document.
Only available if you are viewing an HTML page.
View Set Encoding (Browser mode)
Allows you to choose the character encoding used to display HTML pages. Default is
usually the best choice.
View Sort By (File Manager mode)
Changes whether items are sorted by Name or other criteria described in Information in
the View.
Descending reverses the sort order. Folders First sorts folders before files.
View Additional Information (File Manager mode)
Displays additional information described in Information in the View.

54

The Konqueror Handbook

View Preview (File Manager mode)

Displays a symbolic preview of the file contents in the different view modes.
View Show in Groups (File Manager mode)
Displays the content of the current folder grouped by the option selected in Sort By (only
available in the Icons view mode).
View Show Hidden Files (Alt+.) (File Manager mode)
Shows all the hidden files and sub-folders within the current folder.
View Adjust View Properties... (File Manager mode)
Opens the View Properties Dialog.

12.2.4

The Go Menu

Go Up (Alt+Up)
Go up a level in the folder hierarchy.
Go Back (Alt+Left)
Go back to the previous view.
Go Forward (Alt+Right)
You can only go forward if youve previously gone back.
Go Home Page (Alt+Home) (Browser mode)
Go to your home page as defined on the General page of the settings dialog.
Go Home Folder (Alt+Home) (File Manager mode)
Changes to the users home folder, e.g., /home/Peter/.
Go Applications (File Manager mode)
Open the folder holding your applications.
Go Network Folder (File Manager mode)
Network folders show up in a special location of Konqueror and Dolphin called a virtual
folder. You can find more information on how to use this folder in the KNetAttach Handbook.
Go Settings (File Manager mode)
Open a virtual folder with all System Settings modules in Icons, Details or Columns view.
Select an item to display the settings module in a separate dialog window.
Go Trash (File Manager mode)
Open your Trash folder.
Go Autostart (File Manager mode)
Open your Autostart folder.
Go Show History (Ctrl+Shift+H)
shows a tree view of your browsing history in a separate window. See Sidebar.
Go Most Often Visited
Displays a submenu showing the URLs you visit most often. Selecting one of these will
make Konqueror open that URL.

55

The Konqueror Handbook

Go Recently Visited
Displays a submenu showing the URLs you recently visited. Selecting one of these will
make Konqueror open that URL.
Go Closed Items
Displays a submenu showing the closed URLs you visit. Selecting one of these will make
Konqueror open that URL. Use Empty Closed Items History to clear the submenu.

12.2.5

The Bookmarks Menu

N OTE
See the section Using Bookmarks in this manual for a fuller description of these menu items.

Bookmarks Add Bookmark (Ctrl+B)

Add current selection to your bookmarks.
Bookmarks Bookmark Tabs as Folder...
Create a bookmark folder containing links to all of the URLs currently open in Konqueror
tabs.
Bookmarks New Bookmark Folder...
Create a new folder in your Bookmarks folder.
Bookmarks Edit Bookmarks...
Open the Bookmark Editor.

12.2.6

The Tools Menu

Tools Open Terminal (F4) (File Manager mode)

Open a Konsole terminal window.
Tools Find File... (Ctrl+F) (File Manager mode)
Open the KFind application.
Tools Select Remote Charset (File Manager mode)
Offers to choose the charset used by a remote connection manually.
If you have Konqueror plugins installed there will be additional entries in the Tools menu. See
the Konqueror Plugins chapter for further details.

12.2.7

The Settings Menu

N OTE
See also the section Saving Settings and Profiles.

Settings Toolbars Shown

Opens a submenu where you can choose to show or hide the various Toolbars.
56

The Konqueror Handbook

Settings Show Menubar (Ctrl+M)

Show/Hide the menubar.
Settings Show Terminal Emulator
Open a small text terminal view at the bottom of the main window.
Settings Show Sidebar (F9)
Toggles the display of the Konqueror sidebar. See chapter 7.
Settings Full Screen Mode (Ctrl+Shift+F)
Changes Konqueror to full screen mode, in which the Konqueror window takes up the
whole screen, and does not have the usual window decorations. To exit full screen mode,
click on the Exit Full Screen Mode icon on the toolbar, or press Ctrl+Shift+F.
Settings Load View Profile
Load the settings associated with a particular view profile.
Settings Save View Profile As...
Save the current settings to the current view profile.
Settings Configure View Profiles...
Lets you change an existing view profile or create a new one.
Settings Configure Extensions...
Opens a dialog with all installed plugins (e.g. from the KDE module extragear) and allows
you to select the ones you need. All plugins are accessible in the Tools menu.
Settings Configure Spell Checking...
Displays the spell checking configuration dialog box, in which you can change settings
associated with spell checking in Konqueror.
Settings Configure Shortcuts...
Lets you see and change Konquerors shortcut key bindings, i.e. the associations between
actions such as Copy and keys or combinations of keys such as Ctrl+V. If you do this take
care not to duplicate an existing shortcut.
Settings Configure Toolbars...
Lets you configure the Main, Extra and Location Toolbars. See the section Changing Bars.
Settings Configure Konqueror...
Lets you configure Konquerors behavior in file manager and browser mode.

12.2.8

The Window Menu

Window Split View Left/Right (Ctrl+Shift+L)

Split View Left/Right.
Window Split View Top/Bottom (Ctrl+Shift+T)
Split View Top/Bottom.
Window Close Active View (Ctrl+Shift+W)
Remove Active View.
Window New Window (Ctrl+N)
Open another Konqueror window.

57

The Konqueror Handbook

Window Duplicate Window (Ctrl+Shift+D)

Open another Konqueror window, duplicating the current one.
Window New Tab (Ctrl+T)
Open a new, empty, tab page.
Window Duplicate Current Tab (Ctrl+D)
Open a duplicate tab page.
Window Detach Current Tab (Ctrl+Shift+B)
Show the current tab page in a new instance of Konqueror.
Window Close Current Tab (Ctrl+W)
Close the current tab page.
Window Move Tab Left (Ctrl+Shift+Left)
Move the current tab one place left in the list of tabs.
Window Move Tab Right (Ctrl+Shift+Right)
Move the current tab one place right in the list of tabs.

12.2.9

The Help Menu

Apart from standard KDE Help menu items described in the section Help Menu of the KDE
Fundamentals you will have the menu entry Konqueror Introduction to revisit the introductory
pages that you got when Konqueror was first started.

58

The Konqueror Handbook

Chapter 13

Questions and Answers

Pamela Roberts
1. Can I run Konqueror from another window manager?
Just install Qt, kdelibs and kdebase, and from your favorite window manager, launch
Konqueror. It should work just fine, but if it doesnt (KDE developers dont test that case
often), report it to http://bugs.kde.org and try running kdeinit before running Konqueror;
it usually helps.
2. Where does Konqueror keep all its configuration data?
Generally in the ~/.kde folder (this may be ~/.kde4 on your system, depending on how
KDE was installed). Dont alter these files unless you really know what you are doing.
The ~/.kde/share/apps/konqueror/profiles folder holds individual files containing
settings for each of your profiles.
Your bookmarks are held in ~/.kde/share/apps/konqueror/bookmarks.xml
Cookies are held in ~/.kde/share/apps/kcookiejar/cookies
Your history, as used for the auto-completion feature, is in ~/.kde/share/config/konq_
history
In the folder ~/.kde/share/config/ the files konqiconviewrc, konqlistviewrc and kon
querorrc hold a whole lot of general configuration settings.
The folder ~/.kde/cache-hostname /http/ contains the browser cache.
The Sidebar uses the files and subfolders in ~/.kde/share/apps/konqsidebartng
Any folder specific view settings are put into .directory files in the individual folders.
3. How do I clear out the history file?
There are two histories:
One is used for text completion in the Location Toolbar text entry box. To clear this right
click on the text entry box and select Clear History .
The other is the log of visited locations. Select the History page in the Sidebar, right click
on an entry and choose Remove Entry (Del) to remove just that entry or Clear History
to delete all entries.

N OTE
You can also use the application Sweeper from the kdeutils module which allows you to clean up
cookies, favicons, web history and cache, form completion entries and cache policies of visited
websites.
59

The Konqueror Handbook

4. How do I enable, disable or clear the browser cache?

If you select Web Browsing Cache in the dialog launched by selecting Settings
Configure Konqueror... , you will be presented with a dialog box that lets you disable
the cache, clear it or set its size, and change the caching policy.
5. How can I change the timeout values used by Konqueror when web browsing?
In the System Settings category Network and Connectivity on the Network Settings
Connection Preferences page.
6. How do I set my home page - the page loaded on startup?
Konqueror has a Home Folder used in file manager mode and a Home Page used in
browser mode.
To change these settings launch Settings Configure Konqueror+General.
To set the Konqueror startup page in filemanager mode select Show Introduction Page,
Show My Home Page, Show Blank Page or Show My Bookmarks from the drop down
box labeled When Konqueror starts.
In browser mode Konqueror starts with the Home page entry.
7. I cant find the answer to my question here.
Take a look at http://www.konqueror.org/faq.html or http://www.konqueror.org/konqjava.html.
You may find further information in the KDE Community Forums or on Konquerors KDE
Userbase page.

60

The Konqueror Handbook

Chapter 14

Credits and License

Pamela Roberts
Konqueror. Program copyright 1999-2003, the Konqueror developers:
David Faure [email protected]
developer (parts, JavaScript, I/O lib) and maintainer
Simon Hausmann [email protected]
developer (framework, parts)
Michael Reiher [email protected]
developer (framework)
Mattias Welk [email protected]
developer
Alexander Neundorf [email protected]
developer (list views)
Michael Brade [email protected]
developer (list views, I/O lib)
Lars Knoll [email protected]
developer (HTML rendering engine)
Antti Koivisto [email protected]
developer (HTML rendering engine)
Dirk Mller [email protected]
developer (HTML rendering engine)
Peter Kelly [email protected]
developer (HTML rendering engine, JavaScript)
Waldo Bastian [email protected]
developer (HTML rendering engine, I/O lib)
Matt Koss [email protected]
developer (I/O lib)
Alex Zepeda [email protected]
developer (I/O lib)
61

The Konqueror Handbook

Stephan Kulow [email protected]

developer (HTML rendering engine, I/O lib, regression test framework)
Richard J. Moore [email protected]
developer (Java applet support)
Dima Rogozin [email protected]
developer (Java applet support)
Wynn Wilkes [email protected]
developer (Java2 manager support and other major improvements to applet support)
Harri Porten [email protected]
developer (JavaScript)
Stefan Schimanski [email protected]
developer (Netscape plugin support)
Carsten Pfeiffer [email protected]
developer (framework)
George Staikos [email protected]
developer (SSL support, Netscape plugins)
Dawit Alemayehu [email protected]
developer (I/O lib, Authentication support)
Torsten Rahn [email protected]
Graphics / icons
Torben Weis [email protected]
kfm author
Joseph Wenninger [email protected]
developer (navigation panel framework)
Stephan Binner [email protected]
developer (misc stuff)
Leo Savernik [email protected]
JavaScript access controls, per-domain policies extensions, HTML rendering engine
Germain Garand [email protected]
Developer (HTML rendering engine)
Zack Rusin [email protected]
Developer (HTML rendering engine)
Tobias Anton [email protected]
Developer (HTML rendering engine)
Lubos Lunak [email protected]
Developer (HTML rendering engine)
Maks Orlovich [email protected]
Developer (HTML rendering engine, JavaScript)

62

The Konqueror Handbook

Allan Sandfeld Jensen [email protected]

Developer (HTML rendering engine)
Apple Safari Developers
Developer (HTML rendering engine, JavaScript)
Koos Vriezen [email protected]
Developer (Java applets and other embedded objects)
Ivor Hewitt [email protected]
Developer (AdBlock filter)
Eduardo Robles Elvira [email protected]
Developer (framework)
Documentation copyright 2000-2003
Erwan Loisant [email protected]
Pamela Roberts [email protected]
Documentation updated for KDE 3.2 by Philip Rodrigues [email protected].
Documentation proofreading for KDE 4.11 by David Palser [email protected].
This documentation is licensed under the terms of the GNU Free Documentation License.
This program is licensed under the terms of the GNU General Public License.

63

The Konqueror Handbook

Appendix A

Installation
Konqueror is part of the kdebase package which is an essential part of KDE.
For instructions on acquiring KDE please see http://www.kde.org.
For further information about Konqueror you might like to visit http://www.konqueror.org.
This documentation is licensed under the terms of the GNU Free Documentation License.

64