Konqueror
Konqueror
Pamela Roberts
Developers: The KDE Team
The Konqueror Handbook
2
Contents
1 Overview 6
2 Konqueror Basics 7
2.1 Starting Konqueror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2 The Parts of Konqueror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.3 Tooltips and What’s This? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.4 Left and Middle Mouse Button Actions . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.5 Right Mouse Button Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.6 Viewing Help, Man and Info Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
6 Using Bookmarks 30
7 Saving Settings 31
8 Plugins 32
8.1 Konqueror Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
10 Configuring Konqueror 39
10.1 Other Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
11 Command Reference 41
11.1 Special Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.2 The Menubar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.2.1 The File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
11.2.2 The Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
11.2.3 The View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
11.2.4 The Go Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
11.2.5 The Bookmarks Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
11.2.6 The Tools Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
11.2.7 The Settings Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
11.2.8 The Window Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
11.2.9 The Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4
Abstract
Konqueror is KDE’s advanced File Manager, Web Browser and Universal Viewing Applica-
tion.
The Konqueror Handbook
Chapter 1
Overview
Pamela Roberts
Konqueror is an advanced file manager, providing file management functions ranging from sim-
ple 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 Applications Dolphin is the default file manager. 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 (ECMA-
262), CSS (Cascading Style Sheets) and bidirectional scripts (such as Arabic and Hebrew). It pro-
vides 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 with-
out 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.
6
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.
• 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.
7
The Konqueror Handbook
The Titlebar is the strip across the top of Konqueror’s 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 Toolbar’s 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 Konqueror’s 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 Konqueror’s window and often shows general infor-
mation 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.
8
The Konqueror Handbook
N OTE
Don’t worry if your Konqueror doesn’t 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.
For more details of how to change Konqueror’s appearance, see the Configuring Konqueror section
• 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 Konqueror’s 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.
9
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.
N OTE
If you have enabled the Right click goes back in history option in Konqueror’s 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 Konqueror’s 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 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.
Unlock the toolbar and you can move it to the top, bottom, left or right of Konqueror’s
window.
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
and lock or link views within Konqueror’s window.
10
The Konqueror Handbook
You can view KDE Help and UNIX® Man and Info pages directly in Konqueror, without having
to start up KHelpCenter.
To view a KDE Help page, enter help:/ application name (for example help:/ kmail to
view the KMail documentation.) into Konqueror’s 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 Info’s top level direc-
tory, then it’s 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.
11
The Konqueror Handbook
Chapter 3
Pamela Roberts
N OTE
In File Manager mode, Konqueror uses an embedded Dolphin component.
12
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 en-
abled 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
13
The Konqueror Handbook
Generally this means that the file’s icon will be replaced by a small image showing the file con-
tents.
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.
The view properties can be configured in the View menu, some (such as the view mode) can also
be changed using toolbar buttons.
14
The Konqueror Handbook
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.
15
The Konqueror Handbook
You can go directly to any folder by switching with File → Open Location or Alt+O to the Loca-
tion Bar and typing its path. Konqueror’s Text Completion feature may be useful when you do
this. Don’t 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.
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 → Hidden
Files option.
Another reason Konqueror may not show the file or folder you are looking for is that you may have the
Directory Filter plugin set to display only certain types of file.
16
The Konqueror Handbook
N OTE
Rather than having to open a text console to type the mount or umount commands, you may prefer
to use Konqueror’s Tools → Execute Shell Command (Ctrl+E) feature.
N OTE
You won’t be able to remove a file or folder if you don’t have the necessary permissions.
N OTE
You may not be able to copy or move a file or folder if you don’t have the necessary permissions.
17
The Konqueror Handbook
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.
To remove an active view from Konqueror’s 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.
18
The Konqueror Handbook
The Apply to All button can be used if you have copied multiple items.
• 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.
• If an arrow key, PgUp, PgDn, 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.
• 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.
19
The Konqueror Handbook
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.
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 file’s 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 differ-
ent types of documents are displayed and enable you to create skeleton documents of the
selected type.
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.
20
The Konqueror Handbook
Link to Application...
This option is most useful if you want to create an icon that will open a particular appli-
cation. 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 Com-
mand 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. Ad-
vanced 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 in-
stalled on your system) or get to the Create New... sub menu by right clicking on a free area
of the desktop instead of within Konqueror’s window.
If you have a lot of specialized application links and don’t 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 in-
stance of Konqueror showing it’s 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.
• 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 item’s ownership and access permissions and lets you
change the permissions.
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 dialog’s 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).
21
The Konqueror Handbook
22
The Konqueror Handbook
Chapter 4
Pamela Roberts
• If you use a dial-up modem connection, then you will be using KPPP or a similar dialer pro-
gram 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.
23
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 ma-
chine. 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 distribution’s
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.
Type a URL into the Location Toolbar window, press Enter or left click on the Go but-
ton at the right hand end of the Location Toolbar, and Konqueror will download and display
that page. If you have visited the page before, Konqueror’s Automatic Text Completion feature
can help you type the URL a second time. If you want to use one of the web’s search engines,
Konqueror’s 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 but-
ton 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 and Down keys. You
may also use the scrollbar, your mousewheel or the PgUp and PgDn keys.
If you want to read a long webpage use the automatic scrolling feature of Konqueror. Start auto-
matic scrolling with Shift+Down or Shift+Up. 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
icons in the toolbar and . 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.
24
The Konqueror Handbook
25
The Konqueror Handbook
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.
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.
26
The Konqueror Handbook
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 clip-
board.
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.
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 Konqueror’s normal Copy and Paste or
Drag n’ Drop methods and, if allowed, upload files from your machine to the other computer’s
filesystem. To try it, type the URL
ftp :// ftp . l10n . kde . org
into the Location Toolbar and press Enter. As long as you are connected to the Internet, you
should end up seeing the ftp folder of the l10n server.
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 . l10n . kde . org
27
The Konqueror Handbook
28
The Konqueror Handbook
Chapter 5
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 that’s 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 or Tab and Up 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.
29
The Konqueror Handbook
Chapter 6
Using Bookmarks
Pamela Roberts
Although you can use Konqueror’s 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 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.
If you enter bookmarks: in the location bar the bookmarks home page with an overview of all
bookmarks and folders is shown.
If you want to edit your bookmarks use the Bookmark Editor
30
The Konqueror Handbook
Chapter 7
Saving Settings
Pamela Roberts
You can 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.
31
The Konqueror Handbook
Chapter 8
Plugins
Pamela Roberts
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. Don’t base important decisions on things you have read
from a Google translated page, without confirming that the translation is indeed accurate.
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.
32
The Konqueror Handbook
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.
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
Auto Refresh (KHTML view only)
This works on any readonly part (though currently it only plugs into khtmlpart). It lets
you tell Konqueror to refresh a page automatically after a specific period. This is useful for
things like news pages, and should be very nice for people using Kiosk mode
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
The Look dialog is for adjusting the appearance of the gallery page.
33
The Konqueror Handbook
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 which folders are used.
34
The Konqueror Handbook
FILENAME2 :
Description
T HUMBNAILS
The thumbnails dialog is used for adjusting the properties of the thumbnails in the gallery.
35
The Konqueror Handbook
36
The Konqueror Handbook
Chapter 9
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.
9.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 children’s metrics must be equal to or smaller than the parent object’s
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 auto-
matic 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.
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.
37
The Konqueror Handbook
The color of a rectangle, switchable via menu item View → Color Mode can be either represen-
tative 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.
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 isn’t 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.
38
The Konqueror Handbook
Chapter 10
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.
When KDE is newly installed, Konqueror’s window contains a Menubar, Main and Location
Toolbars and possibly a Bookmark Toolbar.
For detailed information how to modify toolbars and shortcuts please read the sections about
Toolbars and Shortcuts in the Fundamentals.
39
The Konqueror Handbook
Pressing the Help button will give you detailed instructions about how to use each of these
sections, or you can use the What’s This? feature.
40
The Konqueror Handbook
Chapter 11
Command Reference
Pamela Roberts
N OTE
The shortcut key combinations shown in this chapter are the default ones. They can of course be
changed.
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.
41
The Konqueror Handbook
42
The Konqueror Handbook
N OTE
Some items in the Menubar Edit menu can also be found by right mouse button clicking on a free area
of a view.
43
The Konqueror Handbook
44
The Konqueror Handbook
Go → Up (Alt+Up)
Go up a level in the folder hierarchy or select a folder in the hierarchy from the submenu.
Go → Back (Alt+Left)
Go back to the previous view or select a previously visited item from the submenu.
Go → Forward (Alt+Right)
You can only go forward if you’ve 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/.
45
The Konqueror Handbook
N OTE
See the section Using Bookmarks in this manual for a fuller description of these menu items.
46
The Konqueror Handbook
If you have Konqueror plugins installed there will be additional entries in the Tools menu. See
the Konqueror Plugins chapter for further details.
Apart from the common KDE Settings menu items described in the Settings Menu chapter of the
KDE Fundamentals Konqueror has these application specific menu entries:
47
The Konqueror Handbook
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.
48
The Konqueror Handbook
Chapter 12
Pamela Roberts
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.
49
The Konqueror Handbook
50
The Konqueror Handbook
Chapter 13
Pamela Roberts
Konqueror. Program copyright 1999-2003, the Konqueror developers:
51
The Konqueror Handbook
52
The Konqueror Handbook
53