(1) I have been told to look for a file in my profile directory. So where are all my profile data stored?
(2) I have bookmarked a page, the star icon is shining, but I cannot see the bookmark in the Menu or in the bookmark panel.
(3) I cannot save any bookmark and my history is empty. What should I do?
(4) QupZilla is using a lot % of my CPU. What can I do to cool it down?
(5) I have heard that QupZilla supports importing bookmarks from other browsers, but I can't find this feature anywhere.
(6) Site xyz offers less features in QupZilla than in other browser, is it possible to change the User Agent?
(7) I have started QupZilla, but it looks very very different from the screenshots (very ugly!).
(8) How can I get command line output in Windows?
(9) How do I debug QupZilla in case of a crash?
(10) I have successfully compiled QupZilla on FreeBSD, but when I try to run it, only a blank window appears.
(11) I am not able to load a specific https:// website. What can I do?
(12) QupZilla's blog says, that nested bookmark folders are supported. I do not find this in QupZilla yet.
(13) Does QupZilla support the blink web rendering engine used in Chromium?
(14) Does QupZilla support Firefox and/ or Chrome extensions?
(15) I have problems with the facebook web-page. How can I fix it?
Please select the menu entry Help -> Configuration Information and then scroll to the Paths section.
When you add a bookmark from the star icon, it is automatically added to unsorted bookmarks folder.
You will find unsorted bookmarks only in the library
You can move the bookmark to other folder with the star icon or in the library.
At first, please check that you have installed the Qt SQLite plugin. On Debian this package is called
libqt5sql5 respectively on qt5.
If you have it installed and you are still experiencing this issue, please run QupZilla from a terminal window and have a look at the output.
If it contains something like
QSqlQuery::value: not positioned on a valid record QSqlQuery::value: not positioned on a valid record
it seems that your profile database is broken. You can check it with some SQLite database viewer like sqliteman for example. If the database is empty, then you can recover it by creating a new profile.
If this does not help, please open an issue.
Well, the problem with using excessive amount of processor time is very likely caused by some flash content running in the browser (most likely bad coded advertisement). You have 3 options to solve this:
This feature has been added in version 1.0.0-rc1.
You will find the Import Bookmarks option in Menu File -> Bookmarks -> Organize Bookmarks:
The importing wizard will then guide you through the importing process. As you can see you will be able to export your bookmarks as well.
It might help, if you change the user agent in QupZilla. Starting with QupZilla version 1.1.8 you will be able to do this in the preferences:
It is even possible to define a User Agent per site:
You have probably downloaded a tarball for another Linux distribution and executed QupZilla from it.
You need to move files from
/usr/share/qupzilla directory in the tarball to (probably)
/usr/share/qupzilla directory in your system.
The exact path can be found directly from QupZilla: Menu Help -> Informations about application -> Paths -> Data
After a restart of QupZilla, it should work.
If you are not using a tarball for another Linux distribution, please verify, that you did not forget to run make install.
You have to, obviously, run qupzilla.exe from command line. You will be able do it by following these steps:
cd C:\\Program Files\QupZilla
qupzilla.exe 1> output.txt 2>&1and output will be then written into output.txt file
I assume you are using Linux and have gdb installed:
At first, you will have to build QupZilla with debugging symbols. For this, please add
CONFIG += debug into the src/defines.pri file.
Then start a debugging session:
You will get into gdb prompt. Type:
QupZilla should be running now. Make the steps to reproduce the crash and gdb will inform you about that. Now type:
and you have a backtrace of the crash that you can paste into your issue.
Starting with version 1.3.0 QupZilla is able to generate a backtrace and to save it into a file when QupZilla crashes. You will find this file in
However, this will only work, if QupZilla has been compiled with DEBUG support and with the GNU project debugger (gdb) installed. Please consult the documentation of your distribution.
Note: Please remove
# characters from your backtrace when you are pasting it into issue. Otherwise, you would reference issues with number following after
The best way to send backtraces would be to upload them at gist
There is problem with raster graphics system on FreeBSD with (probably) NVIDIA drivers.
You can workaround it by running QupZilla with the native graphics system:
qupzilla -graphicssystem native
Please note, that running QupZilla with the native graphics system is very slow.
To fix this issue, you have to set 3 sysctls:
kern.ipc.shmmax=67108864 kern.ipc.shmall=32768 kern.ipc.shm_allow_removed=1
You can do it by
sysctl kern.ipc.shmmax=67108864 sysctl kern.ipc.shmall=32768 sysctl kern.ipc.shm_allow_removed=1
The QtNetwork stack (unlike other browsers network stacks), which is a part of the Qt Framework, does not support a fallback from the TLSv1 handshake to SSLv3. Thus, if a specific server does not understand the TLSv1 handshake, QupZilla is not able to load this specific website. To allow QupZilla to overcome this issue, it uses a list of known non-working servers and automatically sets SSLv3 as handshaking protocol for them.
Starting with version 1.6.3 non-working servers can be added by the user to QupZilla's configuration file
settings.ini, which is located in the profile directory.
If you find a specific https:// website, that might be affected by this issue, close QupZilla and open the configuration file with an editor of your choice. Go to the section
[Web-Browser-Settings] and look for the parameter
SSLv3Sites=. Per default the following servers are included:
centrum.sk, centrum.cz, oneaccount.com, hdi.de, live.com, i0.cz, sermepa.es
Just add this specific website to this section, save the configuration file and you're done!
Important notice: Due to the poodle vulnerability it is highly recommended to avoid using the SSL3-protocol to connect to web-servers! QupZilla provides an option to disable the SSL3-protocol via
Preferences -> Privacy -> Certificate Manager -> Settings.
Starting with version 1.8.0 nested or multi-level bookmarks are fully supported.
Please check, if this version is available for your distribution and install it.
QtWebEngine is a new web engine based on Chromium, adopted for use within Qt, which has been introduced in the Qt-5.4 series. Given the fact that Chromium uses multi-process architecture, a lot of the API is now asynchronous (instead of synchronous as in QtWebKit). As a consequence a lot of advanced features in QupZilla will have to be adapted due to this change. For now, those features are simply disabled. The next QupZilla major release 2.0.0 will use the QtWebEngine only. Currently there is no release date planned for this, because the QtWebEngine is still under heavy development.
Since January 27, 2015 QupZilla with the QtWebEngine is in the
master-branch of the git-repository. You might want to clone it with:
linux:~>git clone https://github.com/QupZilla/qupzilla.git
Hint: QupZilla with the QtWebkit engine can be found in the
v1.8-branch, which can be cloned with:
linux:~>git clone -b v1.8 https://github.com/QupZilla/qupzilla.git
To build QupZilla you will have to install libqt >= 5.4.0 and of course libqt5-qtwebengine. The package names might be different depending on your distribution. Then you can start compiling QupZilla by invoking
It is recommended to build QupZilla with NO_SYSTEM_DATAPATH, so it can be run directly from the \bin directory instead of installing it system-wide.
Please keep in my mind, that this branch is experimental and not every feature, that you might know from QupZilla 1.8.x, is available. Due to this fact please do not open issues for this branch on the issue tracker!
To answer this questions we would like to give you some background information about APIs and dependencies at a high technical level.
Generally speaking it is possible to support firefox extensions via XUL (XML User Interface Language), which is Mozilla's XML-based language for building user interfaces of applications like firefox. These extensions are also known as traditional or classic. Due to the fact, that XUL is a completely different framework than Qt, there is no reasonable factor and benefit to mix two or more UI frameworks. The other type of firefox extensions, which are known as restartless or bootstrapped, may be supported, but it takes to much effort to implement them.
From a technical point of view Chrome extensions are the same as the restartless or bootstrapped firefox extensions. In addition, because of the multi-process architecture, they support asynchronous messaging between extension and browser and between other extensions. Although it may be possible to somehow support these extensions, it is just too much effort again. It has to be mentioned, that there will probably be a huge impact on the performance of QupZilla, as all extensions will run in one single process in QtWebkit - which is not the case with Chrome.
Conclusion: Firefox and Chrome extension are currently not supported in QupZilla. Generally, it is not the goal of the project. It never was and never will be.
Please consider, that even without Firefox or Chrome extensions QupZilla is a full-featured web browser! Thus, it comes with many features, that provide the almost same functionality with a high integration into your browsing experience:
AdBlock was designed to subscribe to 3rd party filter lists and/ or to create own filter lists. By selecting suitable filter subscriptions it will be possible to achieve a functionality, that comes close to ghostery or noscript.
Blocks unwanted flash content. User-defined whitelist entries are supported.
Provides support for navigating in webpages by mouse gestures
Access Keys Navigation
Provides support for navigating in webpages by keyboard shortcuts
Personal Information Manager
Adds the ability for Qupzilla to store some personal data for filling out formulars in the web
The name says it all
Basic RSS reader implementation
Provides support for autoscroll with middle mouse button
Opens video links from video sharing services in an external program
Makes QupZilla handle mailto links in online services
A TabManager-Plugin for QupZilla
A plugin to manage flash cookies
If you have problems to access facebook.com, then please try to do the following steps:
1 - Change the user agent to Mozilla/5.0 (Windows 7; rv:24.0) Gecko/20131101 Firefox/24.1.0
2 - Disable java script
3 - Use the mobile version of Facebook
Unfortunately this issue is caused by QtWebkit, which will have to be fixed upstream. Please have a look at this issue as well.