The Konqueror Handbook

The Konqueror Handbook

The Konqueror Handbook

Pamela Roberts

Developers: The KDE Team

Reviewer: Lauri Watts

Revision 3.00.00

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

Konqueror is KDE's advanced File Manager, Web Browser and Universal Viewing Application.

This document describes Konqueror version 3.0.0


Chapter 1. Konqueror Basics

Konqueror Basics

Chapter 1. Konqueror Basics

Important

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.

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.

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.

  • If you have a house shaped icon on the panel or desktop, then left mouse button click on it to open Konqueror as a file manager.

  • Or left mouse button click on world shaped icon on the panel or desktop to open Konqueror in browser mode.

  • From the K menu, select Internet-> Konqueror Web Browser to start it as a browser.

  • Alt+F2 will open a Run Command dialog box, type konqueror (lower case) and press Enter or the Run button to start in file manager mode, or just enter a URL such as http://www.konqueror.org to start Konqueror as a browser.

Konqueror is also started automatically when you left click on a desktop icon that represents a directory, such as the Trash icon, or a URL.

The Parts of Konqueror

The Parts of Konqueror

The Parts of Konqueror

A brief look at the main parts of Konqueror's window:

Here's a screenshot of Konqueror

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 you can 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. Hover the mouse pointer over an icon to see a brief description of what that icon does, left click to activate the icon. Click the right mouse button on a clear area of the Toolbar to change the appearance and position of the Toolbar.

The Locationbar 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 Locationbar to go to it. The black icon at the left hand end of the Locationbar clears the text entry box.

The Bookmark Toolbar is the area under the Locationbar in the previous screenshot. You can add frequently used bookmarks here, see the Organising Your Bookmarks section of this document.

The Window is the main area of Konqueror and can show you the contents of a directory, a 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.

The Status Bar runs across the bottom of the 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 an Status Bar for each view, and it will include a small 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.

Note

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, Toolbar, Locationbar and Bookmark Toolbar.

  • You can also ‘flatten’ the Toolbar, Locationbar and Bookmark Toolbar by left mouse button clicking on the vertical lines at the left hand end of the bars or move them around by holding the left mouse button down while you drag these bars around.

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

KDE Logo
Tooltips and What's This ?

Tooltips and What's This ?

Tooltips and What's 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 What's This? feature.

If Tooltips have been enabled in KDE (K menu Control Center->Look & Feel->Widget Settings, Enable Tooltips) then when you hover the mouse pointer over a Toolbar button it should bring up a terse description of what that button does.

What's This? is invoked by the Menubar Help->What's This ? item, by Shift+F1, or by just left mouse button clicking on the question mark near the top right hand corner of Konqueror's window. It changes the cursor to show a question mark alongside the arrow.

When this question mark is visible, a left mouse button click won't actually do anything until you have clicked on a control (or the text alongside it) that supports What's This ?, in which case it will display a reasonably comprehensive description of what the control is supposed to do. Most of the dialog boxes that Konqueror brings up support the What's This? feature.

KDE Logo
Left and Middle Mouse Button Actions

Left and Middle Mouse Button Actions

Left and Middle Mouse Button Actions

If you click the left mouse button on an item in Konqueror's window that item will be “activated”. Thus

  • Left click on an icon in the Toolbar to do whatever that icon is supposed to do.

  • 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 directory icon or name and Konqueror will descend into (show the contents of) that directory.

  • 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 KOffice files, 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 and add new types, see the section File Associations.

Clicking the middle mouse button on a file or directory name or icon does essentially the same as left clicking except that it does it in a new Konqueror window.

KDE Logo
Right Mouse Button Menus

Right Mouse Button Menus

Right Mouse Button Menus

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

Note

If you have enabled the Right click goes back in history option in the Konqueror Browser 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 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 Konqueror's 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 Locationbar

Right click in the URL entry box area to perform Cut, Copy, Paste or Clear operations in this area, or to change the automatic path completion features.

On the Bookmark Toolbar

If you have the Bookmark Toolbar showing, then right click on any free part of it to bring up the Bookmark Toolbar Menu which lets you change its position and whether items are shown as text, icons, or both.

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 as well as the Create new option from the Edit menu.

On a File or Directory

This is a most useful feature. Right clicking on the name or icon of any file or directory not only ‘selects’ that item but also brings up a menu allowing you to Cut, Move, Copy or Remove the item in various ways, add it to your Bookmarks, 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 Konqueror's window.

KDE Logo
KDE Logo
Chapter 2. Konqueror the File Manager

Konqueror the File Manager

Chapter 2. Konqueror the File Manager

Note

In UNIX® and Linux® all directories are arranged in a simple inverted tree structure descending and branching down from from a single top level directory. This means that you can get from any directory to any other by going “up” until you reach a common point then “down” through the appropriate sub-directories until you reach your target.

The position of any file or directory in the tree can be described by its “path”, which is a simple list of the directories you would have to descend through to get to the target directory. For example /home/pam is the subdirectory pam of the subdirectory home of the top level directory, which is represented by the leading “/”.

Note that every accessible drive on your system, including other hard disc partitions and your floppy and cdrom, will appear in the tree descending from /. Their exact paths will depend on how your system was set up, but will usually be something like /mnt/floppy and /mnt/cdrom. See also the section on Floppy and CD-ROM Drives.

Navigation

Konqueror is an excellent file manager, and as such will display the names of the files and sub-directories held in a directory. The “path” of the directory you are looking at is shown in the Titlebar and also in the Locationbar.

Sub-directories are usually displayed with an icon that looks a little like a folder, although some special directories, such as Trash and Desktop, may have different, distinctive, icons. Files have their own icons, which may indicate what type of file it is - or at least what Konqueror thinks it is.

You can “select” a file or sub-directory by using the keyboard arrow keys to move through the displayed items. The appearance of the selected item will change and some information about it will be displayed in the Status Bar.

To move between directories you can simply step up and down the tree:

  • To descend into a sub-directory left mouse button click on its name or icon, or if you have “selected” it then just press Enter.

  • To go up the directory tree, click on the Up button in the Toolbar, or use Alt+Up Arrow, or use the Menubar Go->Up option.

You can also go directly to any directory by typing its path into the Locationbar window or into the dialog box invoked by the Menubar Location->Open Location item or by Ctrl+O. Don't forget that in Linux® / UNIX® file and directory names are case sensitive.

Once you have moved to a new directory then you can go back to your previous choice by using the Toolbar Back button, the Menubar Go->Back item, or Alt+Left Arrow.

Once you have gone back you can go forward. Use the Toolbar Forward button, the Menubar Go->Forward item or Alt+Right Arrow.

Tip

Holding the left mouse button pressed while the mouse pointer is over the Toolbar Up, Back or Forward buttons brings up a menu of recently visited locations.

Automatic Path Completion

You can get Konqueror to help you when you are typing a path into the Locationbar by enabling one of the Text Completion features. To select how Konqueror does this right click on a clear part of the Locationbar text entry box and select Text Completion. This will let you choose between the following possibilities:

None

What you get is what you type.

Manual

Seems to be the same as None.

Automatic

As you type into the Locationbar window Konqueror will automatically extend what you type to complete one possible name, highlighting the characters it has added. Continue typing if that's not what you wanted or press Enter to accept it.

Drop-down List

A drop-down window will appear as you type, showing the possible matches to what you have typed so far. When the path that you want appears in the window then double click on it with the left mouse button. Or you can use the Down Arrow and Up Arrow keys to select it then press Enter.

Short Automatic

This is like the Automatic mode except that it restricts itself to more sensible suggestions.

You should try out these different modes and pick the one that suits you best.

The Navigation Panel

If you want a better view of the directory structure, or easy access to your Bookmarks, History and Network, then the Window->Show Navigation Panel option adds a new view at the left of the window as shown above. (For this screenshot the Menubar View->View Mode... and View->Show details... options have been used to get a text listing of the directory contents in the right hand view rather than one using icons.)

With the Navigation Panel

The Navigation Panel has a number of tabbed pages, containing tree views of your:

  • Bookmarks.

  • History.

  • Home directory.

  • Remote (web or ftp) sites.

  • The root directory.

When Konqueror is showing more than one view, there will be a small box at the bottom right of each view. Left clicking on the box toggles an almost invisibly small icon on and off. Views showing this icon are linked. By linking the Navigation Panel and main views left clicking on any item in the Navigation Panel view will automatically show its contents in the other view.

To navigate through the items in a Navigation Panel page using your mouse, left click on a + symbol to show any subdirectories, left on the - symbol to collapse a sub-tree, and once you can see the wanted item, left click on its name or icon to open it in the other window.

Or you can navigate from the keyboard using the Up and Down Arrow keys to move up and down, the Right Arrow key to descend into a directory and the Left Arrow key to collapse a sub-directory. Once you have reached the wanted item then Enter will open it in the other view.

The Bookmarks tree contains your bookmarks, just as displayed by the Bookmarks menu.

The History tree contains URLs for the most recently visited web sites.

The Home Directory tree shown in the Navigation Panel is actually your personal home directory, which will have a path such as /home/pam2 if your username is ‘pam2’.

The Remote page tree shows details of files or web pages you can reach over your network (if you are connected to one).

The Root Directory tree has the path /, and is the base directory of your system's local files. If you expand the ‘Root’ directory you will find another directory called root. This belongs to the system administrator or Super User and is her home directory. You will also find a directory called home, in which you should be able to find your own ‘Home’ directory again.

There is also a Services page in the Navigation Panel, containing entries for audio CD, LAN (Local Area Network) and Print System browsers.

Finding Files and Directories

If you don't know or can't remember where a file or directory is within your system, then use the Toolbar Find file button or the Menubar Tools->Find File... option. This will embed the file finder application KFind into Konqueror's window. See the ‘Finding Your Lost Files’ section of the KDE User's manual for more details about KFind.

Note

If the name of a file or directory begins with a period (dot), then it is a “hidden” file or directory, and will not normally be shown by Konqueror.

To see the hidden files or sub-directories use the Menubar View->Show Hidden Files option.

Floppy and CD-ROM Drives

Any floppy disk or CD drive that you have on your system will usually appear in the /mnt directory, having a path something like /mnt/floppy or /mnt/cdrom, the details will depend on how your system was set up.

Linux® requires that you mount a floppy disk or CD-ROM when you have inserted it into the drive, so that Linux® can see what's on it. You also need to unmount it before removing the disk so Linux® can register that it is no longer available.

How you do this will depend on how your system:

  • You may have an Automount facility, in which case you don't have to bother about explicitly mounting and unmounting, although you may find that the CD-ROM occasionally starts up by itself for no apparent reason.

  • You may have Floppy and CD-ROM icons on your desktop, in which case left mouse button click on the icon to mount a disk. Doing this should also bring up a Konqueror window showing the contents of the floppy or CD-ROM. To unmount right click on the icon and choose the Unmount item. Visit the section Create New... to see how to create such an icon.

  • 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. Type umount not unmount.

    Note

    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.

Deleting Files and Directories

Deleting Files and Directories

Deleting Files and Directories

Konqueror gives you three ways to dispose of an unwanted file or directory:

  • You can move it to the Trash directory, which is the safest method as you can get it back when you realise that you have made a mistake.

  • You can just plain Delete it, which removes the entry from the directory and adds the disk area occupied by the file(s) to the system's list of free disk areas.

  • Or you can Shred it, which is like Delete, but also overwrites the disk area occupied by the file(s) with random data. Useful for disposing of incriminating departmental memos or similar files when you don't want any trace of them to remain on your system.

Note

Theoretically, even ‘shredded’ files can be recovered by someone with enough skill and determination.

The simplest way of removing a file or directory is to position the mouse pointer over its name or icon and press the right mouse button mouse button, which will bring up a menu containing the options Move to Trash, Delete and Shred.

Or, if you have “selected” the item, the Menubar Edit menu will give you the choice of “Move to Trash”, “Delete” and “Shred” options.

Del will move a selected item or items to Trash.

Shift+Del will really, truly and irrevocably delete the selected item or items.

Ctrl+Shift+Del will shred the selected item or items.

Note

You won't be able to remove a file or directory if you don't have the necessary permissions, see the section on Super User Mode for further details.

KDE Logo
Moving and Copying

Moving and Copying

Moving and Copying

To copy a file or sub-directory between directories 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 hotkey.

  • Navigate to the directory you want to copy the item into then Paste the item into the new directory by using the Toolbar Paste button or the Menubar Edit->Paste option or the Ctrl+V hotkey, 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.

Moving a file or sub-directory between directories 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 directory when you do the Paste into the new directory.

You can also copy or move selected item(s) to another directory by using Edit->Copy Files or Edit->Move Files, or by selecting Copy To or Move To from the drop down menu you get when you right click on an file or directory name in the File Manager window.

Note

You may not be able to copy or move a file or directory if you don't have the necessary permissions. See the section on Super User Mode for further details.

Using Drag 'n Drop

Konqueror also supports Drag and Drop copying and moving of files and directories.

You can do this by having two instances of Konqueror, one showing the directory you want to copy from, the other showing the target directory. 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 directory. Release the button and you will be presented with a menu choice of Copy or Move. Take care to ‘drop’ the item into an empty area of the target directory view - dropping it on top of another file name or icon can cause problems.

You can also set up Konqueror to show more than one directory within its window and drag & drop between them.

Split Views for Drag & Drop

For this screenshot we have used the Menubar Window->Split View Left/Right option, also available with the hotkey Ctrl+Shift+L, to split the main Konqueror window into two views, each showing the contents of a different directory.

When the window is split into two (or more) views it is usually best to make sure that they are not 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 Locationbar 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 mouse button 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+R hotkey, or the Menubar Window->Remove Active View option, or right mouse button click on the Status Bar and choose the Remove Active View option from the resulting menu.

KDE Logo
Selecting Multiple Files

Selecting Multiple Files

Selecting Multiple Files

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 directory to another. Konqueror makes this easy by letting you select multiple files based on similarities in their file names.

Use the Menubar Edit->Select... item or the hotkey Ctrl++. 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 uing the Menubar Edit->Unselect... option or Ctrl+- to specify which of the selected files should be removed from the selection.

Use Ctrl+U or the Menubar Edit->Unselect All option or just left mouse button click on a clear area of the view to cancel the selection(s).

You can even invert the selection, that is deselect all selected files and select those that were previously unselected. Use the Menubar Edit->Invert Selection option or Ctrl+* to do this.

Once you have selected the right files then the normal delete, copy or move commands will act on all of the selected files at once.

Note

Depending on your keyboard type and locale, you will probably find that the Ctrl++, Ctrl+- and Ctrl+* hotkeys only work with the Numeric keypad +, - and * keys.

KDE Logo
Create New...

Create New...

Create New...

When Konqueror is in File Manager mode picking Create New... from the Edit menu or from the drop-down menu you get by right clicking on a free area in a directory view gives you a sub-menu letting you create any of the following in the current directory:

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 four 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 Execute page you must enter the command that will run the application, for example kedit to start up the KEdit text editor. kedit /home/pam/todo.txt would open the file /home/pam/todo.txt in KEdit. You can generally leave the Application page blank.

To make the application icon appear on your desktop, create the link in your ~/Desktop directory (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.

If you have a lot of specialised application links and don't want to clutter up the desktop, then why not create them in your Applications directory. You can get there in Konqueror by choosing Go->Applications. Then create a single icon on your desktop to open your Applications directory, which is usually at ~/.kde/share/applink.

To put an application link icon into the panel, first create it in the Applications directory then drag the icon onto a clear area of the panel.

Link To Location (URL)...

This lets you create an icon to open Konqueror at a particular directory 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 directory or going to the Create New... sub menu by right clicking on a free area of the desktop. When you first create it the text shown with the icon will be the full path or URL, you can change it by right clicking on the icon, selecting Properties... and entering the preferred text in the General tab page.

Floppy Device...

Use this option to create an icon that will mount a floppy disk and open an instance of Konqueror showing the disk's contents. To unmount the disk when you have finished with it right click on the icon and select Unmount. In practice it doesn't have to be a floppy disk but can be any hard disk or partition on your system that is not normally mounted. In most cases you will want to create the icon in your Desktop.

Hard Disc...

This option is similar to Floppy Device... but for a hard disc drive or partition.

CD-ROM Device...

This option is similar to Floppy Device... but for a CD-ROM drive.

Directory...

An easy way of creating a new (sub)directory.

Text File...

Use this to create an ordinary, empty, text file. A little 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 little dialog box is is probably best to give it a .html extension to avoid confusion.

Presentation Document...

Creates a skeleton Koffice KPresenter document. Give its name a .kpr extension.

Text Document...

Creates a skeleton KOffice KWord document using the standard KWord style template. Give its name a .kwd extension.

Spread Sheet Document...

Use this to create a new KOffice KSpread spreadsheet file, and name it with a .ksp extension.

Illustration Document...

Creates a new KOffice Kontour document. Name it with the extension .kil.

KDE Logo
Changing Name and Permissions

Changing Name and Permissions

Changing Name and Permissions

The easiest way to change the name of a file or directory is to right click on it and select Rename.

Or, to change the name or permissions of a file or directory right click on its name or icon and select the Properties... item. Or, if you have “selected” the file or directory, then you can use the Menubar Edit->Properties option.

This will bring up the Properties dialog box which has two tabs:

  • General, which gives you some information about the item and lets you change its name and, for a directory, the associated icon.

  • Permissions, which shows you the item's ownership and access permissions and lets you change the permissions.

Super User Mode

If you are running as a normal user and try to access files outside of your own home directory you will often be prevented from doing so and get an error message such as Access Denied.

To access these files you need to be logged in as the system administrator, often known as the Super User or ‘root’.

Rather than logging out then in again, you can launch Konqueror from the K Menu in Super User mode by selecting System->File Manager - Super User . You will be asked for the ‘root’ login password but as long as you can provide that Konqueror will be started up with full access privileges to all files on your system.

Warning

Take care. As Super User (root), you have complete control of your system, and a wrong command can easily do irrevocable damage.

Also, connecting to the internet as root is an extremely bad idea, as it seriously increases your vulnerability to hacking.

KDE Logo
At the Command Line

At the Command Line

At the Command Line

Although Konqueror is a very powerful and flexible GUI file manager, there are occasions when the experienced Linux® user wants to get down to the basics and work at the text command line level.

She could, of course, open an instance of Konsole, perhaps with Konqueror's Menubar Tools->Open Terminal option or with Ctrl+T.

But Konqueror has yet another nice feature here, the Menubar Window->Show Terminal Emulator option opens up a terminal window as a new view within Konqueror, and as long as the link icon is visible at the bottom right corner of each view, the terminal will follow any directory changes you make in the normal file manager view.

Including the terminal emulator
KDE Logo
KDE Logo
Chapter 3. Konqueror the Web Browser

Konqueror the Web Browser

Chapter 3. Konqueror the Web Browser

Browsing www.konqueror.org

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 Locationbar 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 as described in the Proxy Configuration section.

  • 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 distribution you are using. Some ISPs connect their customers to the Internet through a proxy server, in which case see the Proxy Configuration section of this document. You may find it useful to search the archives of your distribution's user group mailing list for help.

Note

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.

Surfing and Searching

Surfing and Searching

Surfing and Searching

Once you have a connection to the Internet, then you can surf with Konqueror just as you can with any other browser.

  • Type a URL into the Locationbar window, press Enter, and Konqueror will download and display that page. You can use the auto URL completion feature to help you type, this is similar to the auto Path completion feature but bases its choices on your browsing history instead of your system file directories.

  • Left click on a link in the page to go there.

  • To open a link in a new instance of Konqueror, leaving the old page still visible, then right mouse button click on the link and select the New Window option.

    You can also select the multiple view mode with Ctrl+Shift+L or the Menubar Window->Split View Left/Right 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 Arrow hotkey, the Back button on the Toolbar, or the Menubar Go->Back option, just as you do when navigating through your own files.

  • Similarly, once you have gone back you can go forward by using Alt+Right Arrow, the Forward button, or the Menubar Go->Forward option.

If you want to stop the 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 you should see two new icons in the Toolbar, looking like magnifying glasses with small + and - symbols. Use these to adjust the size of the text in the page if you find it difficult to read, although whether this works or not will depend on how the HTML page has been constructed.

Some people seem to spend more time searching for a web page than actually reading it. Do you know that you can just type the subject you are looking for into the Locationbar window, and Konqueror will automatically submit it to a Web search engine? Try it by entering the name of your home town.

Or you can tell it to use a particular search engine. For example entering altavista:konqueror or just av:konqueror will use Altavista to do the search. For more details about Konqueror's advanced search features see the Enhanced Browsing section.

KDE Logo
Saving and Printing Web Items

Saving and Printing Web Items

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 Location->Save As.... If the page you are viewing uses frames, then you will also be given the Location->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 Menubar Location->Save Background Image As... option.

But if what you really want is that glorious picture of the latest Ferrari, then right mouse button clicking on the image will give you a drop-down menu with a Save Image As... option. If you choose Copy Image Location instead then the URL will be copied into the clipboard so you can then paste it anywhere you wish. 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.

Right click on a link (which may be an image) and choose Copy Link Location. This copies the URL to the clipboard so you can then paste it into, say, an e-mail to a friend telling her about this wonderful new site.

Printing a copy of the page you are viewing is easily done with the Menubar Location->Print... or Print Frame option or with the Toolbar Print button.

KDE Logo
FTP

FTP

FTP

FTP, or File Transfer Protocol, is one of the the earliest, and still perhaps the best, way of transferring files between computers over the Internet.

With FTP you can see files and directories 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.kde.org/pub/kde

into the Locationbar and press Enter. As long as you are connected to the Internet, and as long as the KDE's FTP site is not too busy, you should end up seeing the /pub/kde directory at ftp.kde.org

Note

Although, strictly speaking, FTP URL's 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.

Note

If you try to access a 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 Locationbar, as for example

ftp://username@ftp.cia.org

Konqueror will then prompt you for the password.

KDE Logo
KDE Logo
Chapter 4. Using Bookmarks

Using Bookmarks

Chapter 4. Using Bookmarks

Although you can use Konqueror's bookmarks to record the locations of your own files and directories, they are most useful when you are surfing the Web, letting you build up a list of useful sites.

To open the Bookmarks drop-down list you may either left click on the Menubar Bookmarks item, or use the Alt+B hotkey. 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 and select Add To Bookmarks when you are viewing the desired directory or web page.

The Bookmarks list can contain folders containing other bookmarks.

  • If you are also using Netscape®, then a Netscape® Bookmarks folder can be added to Konqueror's bookmark list so you can use your current Netscape® bookmarks in Konqueror.

  • Items in your Bookmark Toolbar will usually appear in a Bookmark folder called ‘Toolbar’ although this can be changed with the Bookmark Editor.

  • To add a bookmark into a sub-folder rather than into the main Bookmark list, select the folder from the Bookmarks menu and use the Add Bookmark item in that folder.

If you have a dual-boot Linux®/Windows® system, then Internet Explorer's File->Import and Export->Export Favorites option will create a .htm file containing links to your IE favourites. From within Konqueror you can then, as long as you have access to the Windows partition, find that file and add it to your bookmarks. In this way you can access all of your old IE favourites.

Organising Your Bookmarks

The Bookmarks->Edit Bookmarks option opens the Bookmark Editor in a new window. Here is where you can:

  • Move items around, with Drag 'n Drop or by using Cut and Paste, or Delete unwanted bookmarks and folders. The order in the Bookmark Editor is the order they will appear in the Bookmarks drop down list. You can make the list look even neater by including the occasional separator with the Insert->Insert Separator option.

  • Create new folders and sub folders using the Create New Folder option in the Insert menu or from the drop down menu you get when you right click on the main part of the window, or with Ctrl+N

  • Change a bookmark's name by selecting an item and using F2 or the Edit->Rename option or by right clicking on the item and selecting Rename. Or change the URL with Edit->Change URL or F3

  • Change the folder used to hold the Bookmark Toolbar items by selecting that folder then left click on the Set As Toolbar Folder in the Edit menu.

  • Import or export Netscape® and Mozilla bookmarks.

Note

If you can't get the Bookmark Toolbar to appear when you check the Show Bookmark Toolbar box in Konqueror's Settings menu then select a suitable folder in the Bookmark Editor and left click on the Set As Toolbar Folder in the Edit menu.

KDE Logo
Chapter 5. Saving Settings & Profiles

Saving Settings & Profiles

Chapter 5. Saving Settings & Profiles

Your current View menu settings (such as the View Mode, Use index.html and Show Hidden Files items) are automatically saved by Konqueror as the default options.

But you can also specify different View menu settings for any individual directory. To do this check the View Properties Saved in Directory box in the Settings menu, change the View settings to whatever you want then uncheck the View Properties saved in Directory box. Doing this creates a .directory file in that directory to hold the directory View settings. Use the Settings->Remove Directory Properties option to remove the directory specific settings (or just delete the .directory file).

Note

One nice use of this feature is if you have a directory full of pictures. You can set that particular directory to display thumbnails of the pictures (by choosing Icon View and PreviewImages from the View menu) when you open it, while not displaying images as thumbnails in other directories.

Your current settings for the Menubar, Toolbar, Locationbar and Bookmark Toolbar are also saved as defaults.

Konqueror's overall appearance when you start it up is determined by one of two profiles, depending on whether you start it as a File Manager or as a Browser. These control the window size, whether the window is split into two or more views, whether the Sidebar or Terminal Emulator are shown, and the starting directory or URL.

To change this start up behaviour, simply set Konqueror to whatever you want, then in the Window menu select Save View Profile File Management or Save View Profile Web Browsing depending on which mode you are in. If you want Konqueror to start up with an empty window enter about:blank into the location bar before saving the profile.

You can also create extra start up profiles and save them with the Window ->Configure View Profiles... option. You can then select them from the Window->Load View Profile drop down menu.

Note

You can create a desktop icon to start Konqueror with your new profile. First create a desktop icon by dragging the Konqueror icon from the K menu onto the desktop and selecting Copy Here. Then right click on the new icon, select Properties... and change Program Name in the Execute tab page to kfmclient openProfile MyNewProfile, MyNewProfile being what you called the new profile. Then in the General tab page change the name to something like MyNewProfile.desktop and pick a more suitable icon.

KDE Logo
Chapter 6. Viewing Man and Info Pages

Viewing Man and Info Pages

Chapter 6. Viewing Man and Info Pages

If you want to read UNIX® Man pages Konqueror makes it easy, for example type man:touch or #touch into the locationbar to see the page for the touch command.

And it makes browsing through Info pages an almost pleasant experience. info:/dir takes you to Info's top level directory then it's just a matter of clicking on the right links to find the page you want.

KDE Logo
Chapter 7. Netscape Plugins

Netscape Plugins

Chapter 7. Netscape® Plugins

Currently, Konqueror supports Netscape® 4.x plugins.

If you select Preferences->Web Browsing->Netscape Plugins from the K menu you will get a dialog box with two tabbed pages; Scan and Plugins.

The Scan page lets you make KDE scan for new Netscape® plugins, either manually by pressing the Scan for new plugins button or automatically each time KDE starts up.

The scan is done by looking through the directories listed in the Scan Directories list for .so files containing plugin code. It examines every such file to find out which MIME types the plugin supports. It then creates MIME type definitions for KDE in the user's ~/.kde/share/mimelnk directory to make other applications aware of the new mime types.

The Plugins page shows you the Netscape® plugins that KDE has found, and for each plugin it lists the MIME types and the filename suffixes it uses to recognise them.

KDE Logo
Chapter 8. Konqueror Plugins

Konqueror Plugins

Chapter 8. Konqueror Plugins

The package kdeaddons contains several useful plugins that interact with Konqueror in various ways. These are explained below.

Babelfish

This uses AltaVista's BabelFish site to translate the current HTML page to whatever language you want (within reason). It can be launched with Tools->Translate Web Page.

Directory View Filter

This is controlled by Tools->View Filter and allows you to choose which types of item are displayed in a directory.

DOM Tree Viewer

Selecting Tools->Show DOM Tree opens a new window which displays the document object model (DOM) of the current HTML page.

HTML Validator

This is started with Tools->Validate Web Page->Validate HTML. It uses the W3C HTML validator to validate the current page, very useful when creating web pages.

CSS Validator

Started with Tools->Validate Web Page->Validate CSS, it uses the W3C CSS validator to validate the current page's Cascading Style Sheets.

HTML Settings

Select Tools->HTML Settings to enable or disable a number of HTML settings without going through the Settings dialog.

Image Gallery

In File Manager mode, you can select Tools->Create Image Gallery to create an HTML page with thumbnails of all the images in the current directory. By default the HTML page is called images.html and the thumbnails are put into a new thumbs directory.

User Agent Changer

Select Tools->Change Browser Indentification to get a menu that allows you to change the User Agent string without going through the Settings dialog procedure.

Navigation Panel Media Player

This is a simple media player, embedded as a tab page in the Navigation Panel. You can drag songs or videos onto this page to play them.

KDE Logo
Chapter 9. Configuring Konqueror

Configuring Konqueror

Chapter 9. Configuring Konqueror

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.

Changing Bars

When KDE is newly installed, Konqueror's window contains a Menubar, a Toolbar, a Locationbar and possibly a Bookmark Toolbar.

Maybe you don't need all these bars. To hide one of them, go into the Settings menu and uncheck its box. To show a hidden bar, just check the box.

On the left hand end of each bar you can see some vertical lines. By left mouse button clicking on them, you “flatten” the bar, meaning that it is hidden but can be quickly restored by clicking on the now horizontal lines. You can also drag a bar into a new position with these lines.

If you right click on a Toolbar, you will get a menu to configure this bar. You can choose the orientation, text position and icon size

Note

If you hide the Menubar, you won't be able to access the Settings menu. To restore it, right click on the view and check Show Menubar.

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 Main and Extra Toolbars are divided into sections, such as Main Toolbar <Konqueror>, Main Toolbar <khtmlpart> and Extra Toolbar <khtmlsettingsplugin>. The number and type of these sections will depend on whether Konqueror is in Web Browser or File Manager mode and whether you have Konqueror plugins installed.

File Manager Configuration

File Manager Configuration

File Manager Configuration

Choose Settings->Configure Konqueror...->File Manager or from the K menu select Preferences->File Browsing->File Manager. This will bring up a dialog box with four tabbed pages; Behavior Appearance, Trash, and Previews.

Behavior

The Open directories in separate windows option lets you choose whether Konqueror will open up a new window when you open a directory, or show that directory's contents in the current view.

If you check the Show network operations in a single window box progress information for all network file transfers will be shown in a single window, otherwise separate windows will be opened for each transfer.

If the Show file tips box is checked a small popup window containing additional information will appear when you move the mouse over a file name in Icon View mode. The Number of file tip entries value determines how much additional information is shown.

The Home URL lets you choose where Konqueror jumps to when you press the Toolbar Home button (this is usually your home directory ~). It does not affect the first directory shown when Konqueror is started from a desktop or panel icon.

The Minimize memory usage area is interesting as it lets you trade off memory usage against the consequences of Konqueror crashing.

Select Never if you have plenty of RAM. A separate instance of Konqueror will exist in memory for each Konqueror window that you have opened so that a problem with one is unlikely to affect the others.

If you select For local browsing only a single instance of Konqueror will exist in memory for all of the local browsing windows you have open, although separate instances will exist for each web browsing window. This means that a problem with any of the local browsing windows can cause all of them to close.

The For web browsing only option is the opposite to For local browsing only so that local browsing windows are isolated from one another but a problem with a web browsing window may cause all web browsing windows to close.

The Always option can be picked if you are short of RAM but means that a problem with any Konqueror window can cause all open Konqueror windows to close down.

Appearance

This page lets you set the font size and color used by Konqueror in File Manager mode and how text associated with icons is displayed.

Trash

Here you can choose whether or not Konqueror asks for confirmation before deleting items.

Previews

This page lets you control whether file previews are allowed for different protocols. Uncheck the boxes for those protocols which are too slow for comfortable previewing.

KDE Logo
File Associations

File Associations

File Associations

What Konqueror does when you click on a file name or icon is determined by the file type and the list of actions that Konqueror keeps for the various file types and can be changed to suit your taste or to add a new file type.

For example Right click on a text (.txt) file and select the Edit File Type item. This will bring up a dialog box as shown below.

Edit File Type dialog,
General tab

Under the General tab, the Application Preference Order section defines what appears in the Open With menu for this type of file. You can change these applications and their order. You can also change the icon that Konqueror uses for this file type by left mouse button clicking on the icon, and you can add the extensions (Filename Patterns) for any other types of file that you want to be handled in the same way.

Note

Konqueror is clever enough to recognise most plain text files and treat them as such even though they don't have the .txt extension.

The Embedding (which actually refers to the Preview) tab page controls what happens when you left mouse button click on a filename.

Note

File types are divided into several groups; application, audio, image, inode, message, text and video.

Konqueror can be configured to associate any file type with an installed application.

For example, the Targa image type doesn't exist in Konqueror. If you have such a file on your disk, it will have a question mark as an icon. If you left mouse button click on it, Konqueror will ask you which application you want to use. You could just type in the name of a suitable application each time you select a Targa file, but the best approach is to tell Konqueror what to do with a Targa image.

Let's add the Targa mime type to Konqueror.

Open the Settings->Configure Konqueror...->File Associations dialog box and click on the Add... button at the lower left, this will bring up a little dialog box. Select Image in the Group drop down box, type Targa in the Type name Text Box, and press OK.

Adding the Targa type, step 2

Now have a look at the upper right hand corner of the File Associations Dialog Box. Click on the icon and choose a nice one, here the best seems to be the image icon. In the Filename Patterns Text Box, add the patterns *.tga and *.TGA by clicking on the upper right Add... button. This means that every file with the .tga or .TGA (case is important) extension will now be considered as a Targa image.

Konqueror now knows what a Targa file is, but it doesn't know what to do with it. We need to tell Konqueror which application to launch to view a Targa file. At the lower right hand corner in the Application Preference Order area, click on the Add... button bring up the following Dialog Box.

Adding the Targa type, step 3

You can choose an application from the Known Applications List Box, but as we want to use Gimp which is not listed, type gimp into the Add Application box.

Gimp is really nice but it is big and not designed for quick viewing. Click once more on the Add... button at the lower right hand corner of the File Associations Dialog Box to bring up the little Application Dialog Box, and in the Add Application Text Box, type xv or the name of any other suitable application you can have on your system.

Now you have two application in the list. The first one will be the default application, you can arrange them as you prefer with the Move Up and Move Down buttons.

All Targa files will now be recognized by Konqueror.

KDE Logo
Konqueror Browser Configuration

Konqueror Browser Configuration

Konqueror Browser Configuration

Choose Settings->Configure Konqueror...->Konqueror Browser or from the K menu select Preferences->Web Browsing->Konqueror Browser. This will bring up a dialog box with five tabbed pages; HTML, Appearance, Java, JavaScript and Plugins.

HTML

If you check the Enable completion of forms box in the Form Completion section of this page Konqueror will remember the data you enter in web forms and suggest it in similar fields for all forms. The Maximum completions value is the number of values Konqueror will remember for a form field. Note that letting Konqueror remember this type of data could be considered a security risk.

Checking the Change cursor over links box causes the cursor to change from a pointer to a hand when it is over a link in a web page. This is advisable as otherwise you may miss links which are shown as images rather than text.

If you select Right click goes back in history then a right click on a view will be interpreted as Go->Back. In this case you can get the traditional context menu by moving the mouse with the right held down.

If the Automatically load images box is checked Konqueror will automatically load any images that are embedded in the web page. Otherwise it will display placeholders for the images and you can then manually load them by clicking on the image buttons in the placeholders.

Some web pages request an automatic reload or redirection after a period of time. You can disable this action by unchecking the Allow automatic delayed reloading / redirecting box.

The Underline links section lets you choose whether links are never underlined, always underlined, or underlined only when the mouse tip is over them.

The Animations section controls how animated images are displayed.

Appearance

This page lets you set the font type, size, character set and default encoding to be used when browsing.

Java

Java™ is not JavaScript but a full featured language. HTML pages using Java™ can cause Java™ programs, usually called ‘applets’, to be downloaded and run on your machine.

The Java tab page lets you set Konqueror's global and domain-specific policies for Java™.

The Enable Java globally check box controls whether Konqueror will generally accept or ignore Java applets, but this can be modified by adding Domain-specific Accept or Reject policies. The full domain name must be entered here, for example to enable (or disable) Java for the site http://news.bbc.co.uk you have to enter news.bbc.co.uk in the Host/Domain field, just putting bbc.co.uk or *.bbc.co.uk will not work.

To run Java™ applets, you need a Java Virtual Machine (JVM) installed on your machine and Konqueror needs to know where it is. You can usually just enter java into the Path to java executable text box, but if that doesn't work or if you have several virtual machines installed and you want Konqueror to use a particular one then enter the full path to your Java™ installation, such as /usr/java/bin.

Warning

As with any browser, enabling active content (Java or JavaScript) can weaken your system's security. It is recommended that the Use Security Manager option in the Java tab page is selected if you are enabling Java™. This requires that the Java™ installation on your machine is Java2 compliant.

Note

Visit http://www.konqueror.org for up to date information about how well various Java™ JVM's work with Konqueror.

JavaScript

Javascript is a small scripting language often used to add animation or other features to HTML pages. Konqueror includes an ECMAScript compatible interpreter to handle scripting languages such as Netscape®'s JavaScript and Microsoft®'s JScript.

The Enable JavaScript globally check box controls whether Konqueror will generally accept or ignore Javascript, but this can be modified by adding Domain-specific Accept or Reject policies as for Java™.

In the JavaScript web popups policy area of the dialog box you can define how Konqueror handles JavaScript ‘window.open()’ commands. Some web sites make annoying use of this command to pop up advertizing banners, but be aware that certain sites require the window.open() function for proper operation.

Plugins

This tab page lets you globally enable or disable the excution of plugins, such as Flash, that can be contained in web pages. Note that, as with any browser, enabling active content can be a security problem. For more information about plugins see the section Netscape Plugins.

KDE Logo
Enhanced Browsing

Enhanced Browsing

Enhanced Browsing

Use the Menubar Settings->Configure Konqueror...->Enhanced Browsing or the K menu Preferences->Web Browsing->Enhanced Browsing selection to bring up the KDE Control Module Enhanced Browsing dialog box.

If the Enable Internet Keywords box is checked you can simply type normal words and phrases such as linux into the Locationbar and you will either be redirected to the appropriate site or presented with a list of possible links. To do this Konqueror submits the word(s) to www.internetkeywords.org which will redirect you if it finds a matching Internet Keyword.

The Search Fallback drop down box lets you pick a search engine that will be used if an exact Internet Keyword match isn't found. If you select None then www.internetkeywords.org will be used.

If you check the Enable Search Shortcuts box Konqueror will let you use the Shortcuts defined in the selection box to choose a particular search engine. For example you can type av:linux into the Locationbar to search for “linux” using Altavista.

KDE Logo
Cookie Configuration

Cookie Configuration

Cookie Configuration

Use the Menubar Settings->Configure Konqueror...->Cookies... or the K menu Preferences->Web Browsing->Cookies selection to bring up a dialog box with two tabbed pages; Policy and Management.

Policy

This page allows you to decide whether Konqueror will handle cookies at all, and whether it should ask you for confirmation before accepting them.

You can also set domain specific cookie policies and even share them with other people by using the Import and Export options.

Management

This tab page is interesting because it lets you see what cookies have been placed on your machine and allows you to delete any or all of them.

KDE Logo
Proxy Configuration

Proxy Configuration

Proxy Configuration

The Proxy configuration dialog box is invoked with the Menubar Settings->Configure Konqueror...->Proxy option, or with the K menu Preferences->Web Browsing ->Proxy choice.

A “proxy” connection to the Internet is one that is made through another machine, usually a LAN (Local Area Network) server, and can give you improved security by separating the computers connected to the local network from the wide open world of the Internet itself. A proxy server can also cache downloaded files to give you faster access to recent downloads.

Proxy servers are traditionally associated with a local intranet within an organisation, but are now also used by some Cable Network ISPs who connect their customers living near to each other onto a local area network to improve the overall average performance of the cable network.

If you are on a LAN, the proxy is perhaps the only way you can connect to the web, in which case you need to ask your system administrator or ISP for connection details.

To configure Konqueror to work with your proxy server, open the Proxies Configuration dialog box, check Use Proxy and fill the fields according what your system administrator or ISP has told you.

Of course, the proxy shouldn't be used to access a machine on your local network. So, in the No Proxy for: field, type the names of local machines on your network separated by commas. This is usually the domain name of your ISP or your company. For example, if you're on the Ireste school network, you would type ireste.fr, intranet, “intranet” being the machine where the intranet web server is located. This is important if you are on a LAN because the proxy won't find the internal machines.

Note

The Use Cache option in the dialog box is not really a proxy option. It allows you to choose to store (cache) downloaded pages on your local disk so they need not be downloaded again the next time you access them. We advise you to use this option (whether you use a proxy or not) unless you are short of disk space in your home directory.

KDE Logo
Cryptography

Cryptography

Cryptography

Choosing the Menubar Settings->Configure Konqueror...->Crypto or the K menu Preferences->Personalization ->Crypto option brings up a dialog box that lets you configure SSL, certificates and other cryptography settings. Use the Default settings unless you really know what you are doing.

KDE Logo
User Agent

User Agent

User Agent

Some web sites tailor their HTML pages according to the browser you are using to view them. This is done to cope with differences between browsers and is done by the web server asking for the browser's “User Agent” and then comparing it against a list of known browsers. Unfortunately very few web sites recognise “Konqueror”.

To overcome this problem, you can control what Konqueror reports as it's User Agent. Selecting Settings->Configure Konqueror...->User Agent or the K menu Preferences->Web Browsing->User Agent will bring up a dialog box allowing you to set the User Agent string for selected sites (for example www.kde.org) or domains (kde.org).

To add a new site or domain specific browser-identification string press the New button, fill in the details in the pop up dialog then press the Update List button. A list of suitable alternative identities is given in the drop down selection box. Note that wildcard characters such as * are not allowed in the site or domain name. Do not forget to press the Apply before closing the User Agent configuration dialog.

KDE Logo
KDE Logo
Chapter 10. Command Reference

Command Reference

Chapter 10. Command Reference

Note

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

The Menubar

The Location Menu

Location->New Window (Ctrl+N)

Open another Konqueror window.

Location->Duplicate Window (Ctrl+D)

Open another Konqueror window, duplicating the current one.

Location->Open Location... (Ctrl+O)

Open a directory or file by entering its path (for example /home/pam or /home/pam/fred.txt) in a simple dialog box.

Location->Send Link (Ctrl+L)

Send an email containing a link to the current location.

Location->Send File

Send an email containing the selected file as an attachment.

Location->Save Background Image As...

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.

Location->Save As... (Ctrl+S)

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.

Location->Save Frame As...

Similar to Save As... but for use with a web site that uses frames.

Location->Print... (Ctrl+P)

Print.

Location->Print Frame

Print selected frame of a Web page.

Location->Open With Netscape

Open the web page you are viewing in Konqueror with Netscape as well.

Location->Quit (Ctrl+Q)

Close down this instance of Konqueror.

The Edit Menu

Note

Most items in the Toolbar Edit menu can also be found by right mouse button clicking on a free area of a view.

Edit->Undo (Ctrl+Z)

Sometimes lets you reverse a mistaken action.

Edit->Cut (Ctrl+X)

Puts selected item(s) into the clipboard. If you then do a a Paste the item(s) 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)

Paste item(s) from clipboard to the currently viewed directory.

Edit->Rename (F2)

Lets you rename a file or directory without having to open the Properties... dialog box.

Edit->Move to Trash (Delete)

Move selected item(s) to the Trash directory.

Edit->Delete (Shift+Delete)

Delete the selected item(s).

Edit->Shred (Ctrl+Shift+Delete)

Shred the selected item(s).

Edit->Copy Files (F7)

Copy the selected item(s) to another directory.

Edit->Move Files (F8)

Move the selected item(s) to another directory.

Edit->Create New

Create a link to an application, URL, Floppy or CD-ROM device, or create a new Directory or text or HTML file. See the Create New...section for more details.

Edit->Edit File Type...

Open the Edit File Type dialog box

Edit->Properties..

Open the Edit Properties dialog box

Edit->Select... (Ctrl++)

Together with the Unselect..., 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->Unselect... (Ctrl+-)

Unselect file or folder.

Edit->Unselect All (Ctrl+U)

Unselect all selected files or folders.

Edit->Invert Selection

Invert current selection.

Edit->Select All (Ctrl+U)

Selects all text in a HTML page or in a text page being previewed, you can then Copy it and Paste it into a text editor.

Edit->Find (Ctrl+F)

Find a text string in a text page you are previewing or in an HTML page.

Edit->Find in Frame (Ctrl+F)

Find a text string in an HTML frame.

Edit->Go to Line...

Go to a particular line number in a text page you are previewing.

The View Menu

View->View Mode...

Selects Icon, MultiColumn, Tree, Detailed List or Text view mode.

View->Use index.html

If a selected directory contains a file index.html, it will be opened as a web page rather than showing the directory as a list of files.

View->Lock to current location

Lock to current location.

View->Unlock all views

Unlock all views.

View->Link View

Link current view to others in a multiple view window.

View->Reload (F5)

Reload.

View->Stop (Esc)

Stop load (particularly useful when web browsing).

View->Icon Size

Select size of icons used when wiewing a directory in Icon Mode.

View->Sort...

Choose order in which items are presented in the window when in Icon or MultiColumn View mode.

View->Case Insensitive Sort

Choose whether the sort order in Tree, Detailed List or Text View modes is case sensitive.

View->View Document Source

View document source text.

Only available if you are viewing a document or HTML page.

View->View Frame Source

View frame source text

Only applies if you are viewing a web site that uses frames. Similar to View Document Source.

View->Security...

Tells you whether the current browser connection is secured with SSL and lets you bring up the Cryptography Configuration... dialog box. Left clicking on the Menubar padlock icon does the same thing.

View->Set Encoding

Set encoding

Allows you to choose the character encoding used to display HTML pages. Auto is usually the best choice.

View->Preview

Lets you choose to show thumbnails of images, text files or HTML pages instead of the normal icons in Icon or MultiColumn View modes.

View->Show Hidden Files

Show hidden (dot) files.

View->Show details...

Lets you choose which file and directory details are shown in Tree, Detailed List and Text views.

View->Background Color...

Select background color for the File Manager mode.

View->Background Image...

Select background image for the File Manager mode.

The Go Menu

Go->Up (Alt+Up Arrow)

Go up a level in the directory hierarchy.

Go->Back (Alt+Left Arrow)

Go back to the previous view.

Go->Forward (Alt+Right Arrow)

You can only go forward if you've just gone back.

Go->Home URL (Ctrl+Home)

Go to your home directory.

Go->Applications

Open the directory holding your applications.

Go->Trash

Open your Trash directory in a separate window.

Go->Templates

Open the Templates directory in a separate window.

Go->Autostart

Open your Autostart directory in a separate window.

The Bookmarks Menu

Note

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->Edit Bookmarks...

Open your bookmarks directory in a separate window.

Bookmarks->New Folder

Create a new folder in your Bookmarks dirctory.

The Tools Menu

Tools->Run Command... (Alt+F2)

Run a program by entering its name in a simple dialog box.

Tools->Open Terminal... (Ctrl+T)

Open a Konsole terminal window.

Tools->Find File...

Open the KFind application.

If you have Konqueror plugins installed there will be additional entries in the Tools menu. See the Konqueror Plugins chapter for further details.

The Settings Menu

Note

See also the section Saving Settings and Profiles.

Settings->Show Menubar (Ctrl+M)

Show/Hide the menubar.

Settings->Show Toolbar

Show/Hide the toolbar.

Settings->Show Extra Toolbar

Lets you have a second Toolbar.

Settings->Show Location Toolbar

Show/Hide the locationbar.

Settings->Show Bookmark Toolbar

Show/Hide the Bookmark Toolbar.

Settings->View Properties Saved in Directory

Save View properties to current directory.

Settings->Remove Directory Properties

Remove directory properties.

Settings->Configure Shortcuts...

Lets you see and change Konqueror's shortcut key bindings, i.e. the associations between actions such as Copy and keys or combinations of keys such a 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 the File manager, File Associations, Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, or Toolbars by bringing up the appropriate dialog box.

The Window Menu

Note

See also the section Saving Settings and Profiles.

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->Remove Active View (Ctrl+Shift+R)

Remove Active View.

Window->Show Terminal Emulator

Open a small text terminal view at the bottom of the main window.

Window->Show Navigation Panel (F9)

Show/hide the Navigation panel.

Window->Save View Profile "File Management"

Save the current view profile as the default one for File Management mode.

Window->Save View Profile "Web Browsing"

Save the current view profile as the default one for Web Browsing mode.

Window->Configure View Profiles...

Lets you change an existing view profile or create a new one.

Window->Load View Profile

Load a View Profile.

Window->Fullscreen Mode (Ctrl+Shift+F)

Fullscreen Mode.

The Help Menu

Help->Konqueror Handbook

View this document.

Help->What's This? (Shift+F1)

Draws a question mark (?) beside the mouse pointer, clicking on a window item such as the Stop button will then display a brief explanation. See Tooltips and What's This ? .

Help->Konqueror Introduction

Revisit the introductory pages that you got when Konqueror was first started.

Help->Report Bug...

Report bug.

Help->About konqueror...

Display some brief information about Konqueror's version number, authors and license agreement.

Help->About KDE...

Show some information about the version of KDE that you are running.

KDE Logo
Chapter 11. Questions and Answers

Questions and Answers

Chapter 11. Questions and Answers

11.1. How can I browse web sites using non latin scripts?
11.2. Can I run Konqueror from another window manager?
11.3. Where does Konqueror keep all its configuration data?
11.4. How do I clear out the history file?
11.5. How do I enable, disable or clear the browser cache?
11.1.

How can I browse web sites using non latin scripts?

Detailed instructions can be found at http://www.konqueror.org/i18n.html

11.2.

Can I run Konqueror from another window manager?

Just install Qt™, kdelibs and kdebase, and from your favourite window manager, just launch Konqueror. It should work just fine, but if it doesn't (KDE developers don't test that case often), report it to http://bugs.kde.org and try running kdeinit before running Konqueror, it usually helps.

11.3.

Where does Konqueror keep all its configuration data?

Generally in the ~/.kde directory (this may be ~/.kde3 on your system, depending on how KDE 3 was installed). Don't alter these files unless you really know what you are doing.

  • The ~/.kde/share/apps/konqueror/profiles directory 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 directory ~/.kde/share/config/ the files konqiconviewrc, konqlistviewrc and konquerorrc hold a whole lot of general configuration settings.

  • The directory ~/.kde/share/cache/http/ contains the browser cache.

  • The Navigation Panel uses the files and subdirectories in ~/.kde/share/apps/konqsidebartng

Any directory specific view settings are put into .directory files in the individual directories.

11.4.

How do I clear out the history file?

There are two “histories”:

  • One is used for text completion in the Locationbar text entry box. To clear this right click on the text entry box and select Empty Contents .

  • The other is the log of visited locations. Select the History page in the Navigation Panel, right click on an entry and choose Remove Entry to remove just that entry or Clear History to delete all entries.

11.5.

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

If you select Preferences->Web Browsing->Cache from the K menu you will be presented with a dialog box that lets you disable the cache, clear it or set its size, and change the cacheing policy.

KDE Logo
Chapter 12. Credits and License

Credits and License

Chapter 12. Credits and License

Konqueror. Program copyright 1999-2002, the Konqueror developers:

David Faure <faure@kde.org>

developer (parts, I/O lib) and maintainer

Simon Hausmann <hausmann@kde.org>

developer (framework, parts)

Michael Reiher <michael.reiher@gmx.de>

developer (framework)

Mattias Welk <welk@fokus.gmd.de>

developer

Alexander Neundorf <neundorf@kde.org>

developer (list views)

Michael Brade <brade@kde.org>

developer (list views, I/O lib)

Lars Knoll <knoll@kde.org>

developer (HTML rendering engine)

Antti Koivisto <koivisto@kde.org>

developer (HTML rendering engine)

Dirk Mueller <mueller@kde.org>

developer (HTML rendering engine)

Peter Kelly <pmk@post.com>

developer (HTML rendering engine, JavaScript)

Waldo Bastian <bastian@kde.org>

developer (HTML rendering engine, I/O lib)

Matt Koss <koss@miesto.sk>

developer (I/O lib)

Alex Zepeda <jazepeda@pacbell.net>

developer (I/O lib)

Stephan Kulow <coolo@kde.org>

developer (I/O lib)

Richard Moore <rich@kde.org>

developer (Java™ applet support)

Dima Rogozin <dima@mercury.co.il>

developer (Java™ applet support)

Wynn Willkes <wynnw@calderasystems.com>

developer (Java™2 manager support and other major improvements to applet support)

Harri Porten <porten@kde.org>

developer (JavaScript)

Stefan Schimanski <schimmi@kde.org>

developer (Netscape® plugin support)

Carsten Pfeiffer <pfeiffer@kde.org>

developer (framework)

George Staikos <staikos@kde.org>

developer (SSL support)

Dawit Alemayehu <adawit@kde.org>

developer (I/O lib, Authentication support)

Carsten Pfeiffer <pfeiffer@kde.org>

developer (Framework)

Torsten Rahn <torsten@kde.org>

Graphics / icons

Torben Weis <weis@kde.org>

kfm author

Joseph Wenninger <jowenn@kde.org>

developer (navigation panel framework)

Documentation copyright 2000-2002

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.

KDE Logo
Appendix A. Installation

Installation

Appendix A. Installation

Konqueror is part of the kdebase package which 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.

KDE Logo
KDE Logo