falkonOfficial/FAQ

FAQ

Q: Profile data storage location
Q: Cannot find page bookmarked with clicking on star icon.
Q: Errors when visiting secured (https) sites or downloading EasyList.
Q: Cannot save bookmarks and history.
Q: Using a lot of % CPU.
Q: Search engines are not saved through restarts.
Q: Cannot find Import bookmarks feature.
Q: How to change User Agent.
Q: Browser is using ugly theme and cannot find any translations.
Q: Empty window when trying to run on FreeBSD

Q: I have been told to look for a file in my profile directory. So where are
   all my profile data stored?
----------------------------------------------------------------------------------
A: Please select the menu entry Help -> Informations about application and then
   scroll to the Paths section.


Q: I have bookmarked a page, the star icon is shining, but I cannot see
   the bookmark in the Menu or in the bookmark panel. Where do I find it?
----------------------------------------------------------------------------------      
A: When you add a bookmark from the star icon, it is automatically added
   to unsorted bookmarks folder. You will find it only in the library (Ctrl+Shift+O).
   You can move the bookmark to other folder with the star icon or in the library.
   

Q: I am getting a lot of SSL errors when visiting secured (https) pages.
   Also I cannot update EasyList. Why does this happen?
----------------------------------------------------------------------------------
A: Your system CA certificates list is probably too small or even missing.
   You can check this in SSL Manager (Tools ->Preferences -> Privacy -> SSL Manager).
   If this is your case, you have to download the ca-bundle.crt file from
   https://github.com/nowrep/QupZilla/tree/master/other/ca-bundle.crt.
   It contains certificates from Debian's ca-certificates package and I am
   trying to update it as soon as it is updated in the Debian repository.
   
   After downloading this file, you may put it into $yourprofile/certificates/
   directory or in some other place. But then you have to add a new certificate
   path in the SSL Manager (last tab - settings).
   

Q: I cannot save any bookmark and my history is empty. What should I do?
----------------------------------------------------------------------------------
A: At first, please check that you have installed the Qt SQLite plugin.
   On Debian, this package is called libqt4-sql-sqlite.
   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 by some
   SQLite database viewer. If the database is empty, then you can recover
   it by copying
       Windows: Program Files/QupZilla/data/profiles/default/browsedata.db
       Unix: /usr/share/qupzilla/data/profiles/default/browsedata.db
   into your profile directory.
   If it doesn't help, please open an issue.
   
   
Q: QupZilla is using a lot % of my CPU. What can I do to cool it down?
----------------------------------------------------------------------------------
A: 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
   adverts). You have 3 options to solve this:
   
    1) Completely disable Flash in preferences (Browsing -> Web Configuration ->
       Enable Plugins (Flash plugin)
    2) Use the Click2Flash plugin (Preferences -> Plugins -> WebKit plugins ->
       Enable Click2Flash). You will now have to manually start every flash content
       on a specific site.
    3) Use AdBlock to filter adverts. Menu Tools -> AdBlock -> Enable AdBlock.
       Before using AdBlock, you will have to update filters by clicking the
       Update Filters button.  
   
   
Q: When I add or edit my Search Engines and restart QupZilla, the changes won't stay.
   What's wrong?
----------------------------------------------------------------------------------
A: If you are using your own builds from git, you have probably an old version of
   the profile database file. The easiest way to upgrade your database is to edit
   the version file in your profile. Open it with some text editor and change
   1.0.0-rc1 (or whatever you have in it) to 1.0.0 and restart QupZilla.
   Your database should now be updated and changes won't be discarded on every
   restart anymore.
   

Q: I have heard that QupZilla supports importing bookmarks from other browsers, but
   I can't find this feature anywhere.
----------------------------------------------------------------------------------
A: This feature has been added in version 1.0.0-rc1. If you are using older version,
   please upgrade it either by downloading installable packages from github or from
   your distributions repository.
   Then you will find the Import Bookmarks option in Menu File -> Import Bookmarks...
   The importing wizard will then guide you through the importing process.

Q: Site xyz offers less features in QupZilla than in other browser, is it possbile to
   change User Agent?
----------------------------------------------------------------------------------
A: You can change User Agent in QupZilla, but it is not possible from Preferences.
   You need to manually edit settings.ini file in your profile directory.
   Open settings.ini in your favourite text editor and find line with:
    [Web-Browser-Settings]
    
   and append to next line this: UserAgent=YourUserAgent version 0.1.2.3 /Linux
   So it will look something like that:
   
   [Web-Browser-Settings]
   UserAgent=YourUserAgent version 0.1.2.3 /Linux
   allowFlash=true
   ...
   
Q: I have started QupZilla, but it looks very different from screenshots (very ugly!).
   I cannot find option to change themes nor language in preferences.
----------------------------------------------------------------------------------
A: You have probably downloaded tarball for other Linux distributions and executed
   QupZilla from it.
   You need to move files from /usr/share/qupzilla directory in 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 restart, it should be ok now.
   
   If you are not using tarball for other Linux distributions, didn't you forget to run
   make install?
   
Q: I have successfully compiled QupZilla on FreeBSD, but when I tried to run it, only
   blank window appeared. Is QupZilla incompatible with FreeBSD?
----------------------------------------------------------------------------------
A: There is problem with raster graphics system on FreeBSD with (probably) NVIDIA drivers.
   You can workaround it by running QupZilla with native graphics system:
      qupzilla -graphicssystem native
   but running with 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 
      a) put them in /etc/sysctl.conf and run '/etc/rc.d/sysctl restart'
      b) set them manually with
          'sysctl kern.ipc.shmmax=67108864'
          'sysctl kern.ipc.shmall=32768'
          'sysctl kern.ipc.shm_allow_removed=1'
         commands (without ' of course)