Konqueror FAQ
Questions
- Konqueror refuses to login into netscape mail. Is there a fix for that ?
- Is there a way to change the default Accept-Charset/Accept-Language HTTP headers in konqueror ?
- How do I tell Konqueror to forget all the cached logins and passwords?
- Where does Konqueror store its history, and how do I erase it?
- Why does KDE ignore the system wide proxy settings? (KDE 2.2.2 or earlier)
- Why does Konqueror 2.2 crash on every page with JavaScript?
- Why does Konqueror crash on every page with Flash?
- Does Konqueror support automatic ftp logins via ".netrc" files
- I'm using an NVidia driver for X, and Konqueror hangs the system
- My wheel mouse sometimes does not work with Konqueror
- Where does the name Konqueror come from?
- Why doesn't KHTML show the contents of an image's ALT tag in a tooltip?
- When trying to authenticate to a proxy, I get "unknown authorization method" (KDE 2.1.1)
- What is Konqueror's User Agent string?
- As an author of a web site, how can I identify Konqueror from other browsers?
- How do I set my 'home' page - the page loaded on startup?
- Is there a way to change the timeout values in Konqueror?
- Can I run Konqueror without running KDE?
- What is the format of addresses in the "No proxy for" dialog box?
- How can I connect to an FTP site that requires a login and password?
- Konqueror crashes when viewing PNGs (e.g. in the image preview)
- I get many problems / crashes with the beta releases or with KDE 2.0
- How do I add bookmarks to the bookmark toolbar?
- How do I enable SSL support?
- How do I enable support for Netscape plugins?
- Java Applets only show up as grey rectangles, what's wrong?
Answers
Konqueror refuses to login into netscape mail. Is there a fix for that ?
By default konqueror does not accept cookies that originate from a site other than the one you are currently visiting. This is done to protect your privacy. Unfortunately, the netscape mail site requires that you accept cookies that come from sites other than their own. Hence, the only way to make konqueror work with that site is to disable the option that activates the feature mentioned above. To disable this option do the following:
- In konqueror click on the Settings menu.
- Select Configure Konqueror...
- In the Configure Konqueror dialog, click on Cookies.
- Make sure the option labeled Only accept cookies from originating servers is unchecked.
Is there a way to change the default Accept-Charset/Accept-Language HTTP headers in konqueror ?
Yes. By default konqueror automatically uses the settings configured when you installed your
desktop. You can manually override this behavior by adding the following settings to either
$KDEHOME/share/config/kioslaverc
or $KDEHOME/share/config/kio_httprc
:
Languages=<comma-separated-list-of-languages> Charsets=<comma-separated-list-of-charsets>
If you add the settings to the first "kioslaverc", then the options are available to all KDE ioslaves that support changing these settings. On the other hand, if you want the settings to be applicable to a specific io-slave, e.g. kio_httprc, then you want to add them to the protocol specific config files. You can also specify these settings on a per-site basis. To do that, instead of adding the settings to the top of the file (global section), you need to add them to a specific site section. For example to change the settings sent to all kde.org sites you would do the following:
[kde.org] Languages=en Charsets=iso-8859-1
After making these changes you need to issue the following command to make the settings take immediate effect:
dcop konqueror-* KIO::Scheduler reparseSlaveConfiguration "http";
How do I tell Konqueror to forget all the cached logins and passwords?
When you successfully login to a web site (using the login/password dialog, not using a form),
or to an FTP/SMB/SSH/... site, Konqueror caches the username and password in the
kdesud daemon. This information remains alive as long as kdesud runs, but isn't
saved to any file. To ask it to forget all the currently cached logins and passwords,
simply run
kdesu -s
Where does Konqueror store its history, and how do I erase it?
There are several kinds of "history" stored by Konqueror.
- The location bar combobox items and completion: since KDE 2.2, you can clear those with right-click, "Empty Contents".
- The history module in the sidebar: since KDE 2.2 you can clear it with a right-click on one of the host names, and selecting "Clear History".
- The HTTP cache (known as "Temporary Internet Files" in other environments) can be cleared in the KControl module called "Cache", using the "Clear cache" button on the bottom right.
File locations (~/.kde
is only an indication. Your distributor, or $KDEHOME, could have modified that value) :
- Combobox items:
~/.kde/share/config/konq_history
- History module and combobox completion:
~/.kde/share/apps/konqueror/konq_history
(binary file) - HTTP cache:
~/.kde/share/cache/http/
(previously in~/.kde/share/apps/kio_http/cache/
)
Why does KDE ignore the system wide proxy settings? (KDE 2.2.2 or earlier)
This is due to a bug in a script used by the configuration update program. It has been fixed for 3.x release. For KDE 2.2.2 or earlier you can workaround the problem by simply replacing the last line of $KDEDIR/share/apps/kconf_update/proxytype.pl with the following:
print "ProxyType=$proxytype " if $proxytype;
Another solution is to remove kioslave.upd located in the same directory mentioned above. Note that you do not want to do this right after upgrading KDE and before you have had a chance to start the new version for the first time. Otherwise, you might loose your exisiting configuration. Also note that this does not apply to upgrading to KDE 3.x since the problem has already been fixed.
Why does Konqueror 2.2 crash on every page with JavaScript?
There are two cases where this is known to happen:
If you're using the SuSE i686 RPM's of KDE2.2 release you will experience
that almost every page with JavaScript either does not work or crashes
Konqueror. This is a bug in the objprelinking that was used to build the
RPMs. Please use the non-experimentally marked RPMs instead, they will work.
Please do not report bugs if you are using these packages.
If you see a message about an undefined symbol on the konsole output,
you hit the binutils bug. Exact reason for this is unknown, but upgrading
to a recent binutils (>= 2.10) and recompiling kjs helped in every case up to now.
If you installed from RPM you shouldn't be affected.
Why does Konqueror crash on every page with Flash?
This is a result of a clashing symbol in both the flash plugin and the
XFree86 libGLU (OpenGL utility lib). Upon closing an embedded flash view,
the wrong function is called which heavily corrupts memory and leads to
either immediately or delayed crashes, lockups and worse.
The only solution that is currently known is either to install Qt without
OpenGL support or to not use the Flash plugin. You can't combine both
until this symbol clash is somehow solved. Unfortunately we cannot do
much about this issue, unless Macromedia is willing to help.
Another reason for Konqueror to crash on every page using a Netscape plugin
is the use of gcc3. Plugins can't work with gcc3 because they are linked to
gcc2's libstdc++, which is incompatible with gcc3's libstdc++.
Does Konqueror support automatic ftp logins via ".netrc" files
Starting with version 2.2 beta1 konuqeror does indeed support automatic logins as specified in the ".netrc" file. However, there is no graphical front end to enable this feature ; so you have to do it manually using the following procedure:
- Create $KDEHOME/share/config/kio_ftprc if it does not already exist.
Note that $KDEHOME referes to your personal kde config directory (usually ~/.kde).
- Add the following entry to kio_ftprc: "EnableAutoLogin=true"
- Issue the following command to update running io-slaves:
dcop konqueror-* KIO::Scheduler reparseConfiguration ""
Please note that the support for the "macro" keyword is very limited in the current implementation. In fact, we only honor the "cd" command. Furthermore, eventhough this nominal "macro" support was left ON by default for the 2.2 beta1 release, you will have to be manually enable it in subsequent releases by adding a "EnableAutoLoginMacro=" entry following the same procedure outlined above.
I'm using an NVidia driver for X, and Konqueror hangs the system
Add
Option "NvAgp" "2"
to the "Device" section for the NVidia card, in XF86Config. The above option just says to use the Linux agpgart module instead of Nvidia's own. Thanks to Scott Lanham for this advice.
My wheel mouse sometimes does not work with Konqueror
Disable imwheel, at least for Konqueror (you can add this to the Exclude section in ~/.imwheelrc). You might consider not using imwheel at all, because it causes more problems than they solve with applications these days.
Where does the name Konqueror come from?
It's a word play on the other browsers' names. After the Navigator and the Explorer comes the Conqueror; it's spelled with a K to show that it's part of KDE. The name change also moves away from "kfm" (the KDE file manager, Konqueror's predecessor) which represented only file management.
Why doesn't KHTML show the contents of an image's ALT tag in a tooltip?
There's no standard that says an ALT tag should appear when you
hover over an image. Some browsers do so, but that's all.
Most of the time the ALT tag contains some useless description
like "foo.jpg (231432 bytes)" as Frontpage does by default; besides, the
specification for the ALT property calls for ALT to be displayed in place of
the image, as in text-mode-only browsers such as lynx or w3m. It is not meant
to be used as a tooltip. Tooltips for images are supposed to come from the TITLE attribute,
and this is being implemented.
When trying to authenticate to a proxy, I get "unknown authorization method" (KDE 2.1.1)
Unfortunately a bug was introduced when the code that deals with authentication
was being revamped for the 2.1.1 release. The bug has now been fixed in both
the development as well as the current stable branches.
If you compiled KDE 2.1.1 from source code through anoncvs.kde.org, please update
kdelibs/kio/http to the current version of 2.1.1 using
cvs upd -r KDE_2_1_BRANCH
in that directory.
We apologize for the inconvenience.
What is Konqueror's User Agent string?
There is no definite answer to this question.
The HTTP_USER_AGENT
http header and the properties of the
window.navigator JavaScript object have been subject to change during
the last KDE releases. Additionally, the user can modify the UA
information on a domain-by-domain basis pretending to have any other
browser in existence.
If you are reading this because you wanted to uniquely identify
Konqueror on your website see the answer to the next question.
As an author of a web site, how can I identify Konqueror from other browsers?
We are working very hard on making all the differences go away thus
making any differentiation impossible - or rather needless.
In case you experience a bug or missing feature in Konqueror (let's
say the JavaScript function document.foo() is not working as expected)
we recommend to test for features rather than the browsers brand.
Rather than writing code like
if (navigator.userAgent.indexOf("Konqueror") >= 0) IEorMozilla = false;we recommend to perform direct checks such as
var workingFoo = (foo("bar") == 42); // doing what it's supposed to do ? var DOM = !!document.getElementById; // basic DOM support ? var documentALL = !!document.all; // Microsoft extension available ?
This way you don't
- discriminate against any kind of browser. No matter how exotic they are.
- get trapped by browsers that have to disguise their identity to slip through incomplete or wrong user agent checks.
- have to maintain any version dependency in your check in case a future maintenance release fixes the issue.
How do I set my 'home' page - the page loaded on startup?
Start Konqueror with the "Web Browser" button, open the page that you want to be loaded in any new "Web Browser" window, and select "Save View Profile Web Browsing" in the Window menu. To have Konqueror start up with no page loaded (as it did in KDE 2.0), use "about:blank".
Is there a way to change the timeout values in Konqueror?
Beginning with 2.2 beta series, you can change the timeout settings
in the control panel under "Network->Preferences"
.
If you are using the 2.1 series, however, you have to manipulate the config
file manually to adjust these values to your liking. Here is the procedure
for doing that:
- Open $KDEHOME/share/config/kioslaverc in your favorite editor, where $KDEHOME is your local kde config directory (usually ~/.kde/).
- Add the following entries without any HEADING, i.e outside of any [] block.
Simply adding it to the top of the file will suffice.
ReadTimeout=x // length of time to wait for arrival of requested data ResponseTimeout=x // length of time to wait for a response after sending a request ConnectTimeout=x // length of time to wait for response after attempting to connect ProxyConnectTimeout=x // same a above except it is used for proxy servers.
where x is the value you need in seconds. To give you an idea, here are the default values:
DEFAULT_READ_TIMEOUT 15 // 15 SECONDS DEFAULT_RESPONSE_TIMEOUT 60 // 1 MINUTE DEFAULT_CONNECT_TIMEOUT 20 // 20 SECONDS DEFAULT_PROXY_CONNECT_TIMEOUT 10 // 10 SECONDS
- Manually run the following command to update any running io-slaves:
dcop konqueror-* KIO::Scheduler reparseConfiguration ""
If you are running older than version 2.1 of KDE, upgrade.
Can I run Konqueror without running KDE?
Yes. 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.
This is of course the same for any other KDE application.
What is the format of addresses in the "No proxy for" dialog box?
The "No Proxy For" field under "Settings->Configure->Proxies" accepts any number of comma or space separated hostnames or fully qualified addresses. You can mix and match the use of these separators as well as have any number of them b/n the specified hostnames in the list.
Example: 1.) kde.org,,,,,,, mycompanyintranet.com 2.) kde.org mycompanyintranet.com 3.) kde.org, mycompanyintranet.com
Do not however use the asterisk (*) to indicate multiple matches under a specific domain. That will not work. Instead only enter the common part of the addresses you want to exclude. For example, to exclude all KDE sites from using proxy enter ".kde.org" (without the quotation) rather than "*.kde.org" in the "No Proxy For" field. Also note that this is only supported for HTTP proxies currently, not for FTP proxies.
How can I connect to an FTP site that requires a login and password?
Simply type ftp://user@host/ and Konqueror will prompt you for a password. If your username contains the '@' sign, replace it with %40.
Konqueror crashes when viewing PNGs (e.g. in the image preview)
All KDE applications are affected by an incompatibility between Qt 2.2.1 and libpng 1.0.8, when they try to display PNGs. This applies to Konqueror, but also to ksnapshot and many other KDE applications. Either upgrade libpng to 1.0.9, or Qt to 2.2.2 or 2.2.3. See the libpng home page.
I get many problems / crashes with the beta releases or with KDE 2.0
Update to the latest KDE, many bugs have been fixed, and Konqueror is much more stable than it used to be. See the KDE web site for instructions on installing binaries and source.
How do I add bookmarks to the bookmark toolbar?
Under the Bookmarks menu, select Edit Bookmarks.
This will bring up a new window, showing the contents of the bookmarks directory.
From there, you can copy bookmarks into the Toolbar sub-directory,
and every bookmark you copy there will appear in the bookmark toolbar.
Using the "Edit toolbars" dialog for this won't work, it even tends to crash.
Sorry about that, this toolbar shouldn't even appear there.
There is no way to control the order of bookmarks, in the toolbar or in the menu, in KDE 2.0.,
but this has been done in CVS (will be in KDE 2.1)
How do I enable SSL support?
Most binary distributions come with SSL support enabled, but if you compile from sources, you need to install a recent openssl, remove config.cache and re-run configure, in kdelibs.
How do I enable support for Netscape plugins?
Most binary distributions come from Netscape plugins support enabled, but if you compile from sources, you need to install lesstif, remove config.cache and re-run configure, in kdebase (check that it compiles the contents of kdebase/nsplugins/). If the auto-detection of the plugins fails, try running "nspluginscan" from the command line.
Java Applets only show up as grey rectangles, what's wrong?
Most like you are using Sun's 1.3 JRE. There is a know problem that prevents KJAS from working with that version of Java. Please use Blackdown's 1.3 release, IBM's 1.3 release, or Sun's 1.2.2 release. Each of those is known to work. Hopefully this issue will be resolved in a 1.3.1 release from Sun.
[ Edit ]