Falkon: Difference between revisions

Revision as of 17:57, 28 June 2019

Introduction

Falkon is a cross-platform Qt web browser previously known as QupZilla. It uses the QtWebEngine rendering engine.

Installation

It can be installed on Windows 7 or newer as well as Linux from the repositories, as a flatpak and as a snap.

For Windows, .exe binaries are available for 32-bit and 64-bit architectures in https://www.falkon.org/download/ .

As a flatpak, nightly builds are available from the kdeapps flatpak repository.

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --if-not-exists kdeapps --from https://distribute.kde.org/kdeapps.flatpakrepo
flatpak install kdeapps org.kde.falkon
flatpak run org.kde.falkon

As a snap, it can be installed like so:

sudo snap install falkon

Theming

By default, Falkon's user interface follows system theming and widgets.

However, other themes are available under Preferences, namely: Chrome, Windows, Linux, Mac.

Fonts

The fonts section is used to override some fonts on websites. On KDE Plasma, for instance, the default fonts belong to the DejaVu font family. This can be changed by the user or may change according to the operating system you're using.

Extensions

Falkon does not use the same extension API as Firefox or Chrome/Chromium, and as such it has only limited support to extensions. However, some extensions are available by default, only having AdBlock active out of the box.

There are also extensions that integrate Falkon directly with your system if you are using KDE Plasma, for instance PIM and KWallet integration.

Spell Check

Spell checking in Falkon currently supports only basic functionality and also needs a custom format of dictionaries. This is a limitation that comes with QtWebEngine.

Dictionaries

Dictionaries needs to be in a special format that uses Chromium, with the extension .bdic. QtWebEngine comes with an utility to convert Hunspell dictionaries (.dic) to this format.

qwebengine_convert_dict /path/to/hunspell/dict.dic /output/path/to/created.bdic

Created .bdic dictionaries then need to be moved to one of the directories shown in the Preferences, which may be:

/usr/bin/qtwebengine_dictionaries
/usr/share/qt5/qtwebengine_dictionaries

User Style

It is possible to use custom .css or .js files if you want to override the content displayed on websites. This is an advanced functionality that can provide users with features not currently available on Falkon and meet certain needs for different kinds of users.

For instance, it can be used for overriding fonts that are not affected by the Fonts preferences from Falkon.

As such, a simple .css file that overrides fonts and turns them into the accessibility-friendly OpenDyslexic could be done like so:

html *
{
  font-family: OpenDyslexic, sans-serif!important;
}

(Credits to Jason McDonald over at userstyles.org for submitting this code snippet as CC0.)

Missing features

Currently, as of QtWebEngine 5.8, the following useful features are missing:

add words to custom dictionary
change path from which dictionaries are loaded

@@ Line 1: / Line 1: @@
 ==Introduction==
-Falkon is a cross-platform Qt web browser previously known as QupZilla. It uses QtWebEngine rendering engine.
+'''Falkon''' is a cross-platform Qt web browser previously known as '''QupZilla'''. It uses the QtWebEngine rendering engine.
 [[File:Falkon_mainscreen.png]]
+==Installation==
+It can be installed on Windows 7 or newer as well as Linux from the repositories, as a flatpak and as a snap.
+For Windows, ''.exe'' binaries are available for 32-bit and 64-bit architectures in https://www.falkon.org/download/ .
+As a flatpak, nightly builds are available from the kdeapps flatpak repository.
+<pre>
+flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+flatpak remote-add --if-not-exists kdeapps --from https://distribute.kde.org/kdeapps.flatpakrepo
+flatpak install kdeapps org.kde.falkon
+flatpak run org.kde.falkon
+</pre>
+As a snap, it can be installed like so:
+<pre>
+sudo snap install falkon
+</pre>
+==Theming==
+By default, Falkon's user interface follows system theming and widgets.
+However, other themes are available under Preferences, namely: Chrome, Windows, Linux, Mac.
+==Fonts==
+The fonts section is used to override some fonts on websites. On KDE Plasma, for instance, the default fonts belong to the DejaVu font family. This can be changed by the user or may change according to the operating system you're using.
+==Extensions==
+'''Falkon''' does not use the same extension API as Firefox or Chrome/Chromium, and as such it has only limited support to extensions. However, some extensions are available by default, only having AdBlock active out of the box.
+There are also extensions that integrate '''Falkon''' directly with your system if you are using KDE Plasma, for instance PIM and KWallet integration.
 ==Spell Check==
-Spell checking in Falkon currently supports only basic functionality and also needs a custom format of dictionaries. This is a limitation that comes from used web engine.
+Spell checking in '''Falkon''' currently supports only basic functionality and also needs a custom format of dictionaries. This is a limitation that comes with QtWebEngine.
 ===Dictionaries===
-Dictionaries needs to be in special format that uses Chromium, with suffix ''.bdic''. QtWebEngine comes with utility to convert Hunspell dictionaries (''.dic'') to this format.
+Dictionaries needs to be in a special format that uses '''Chromium''', with the extension ''.bdic''. QtWebEngine comes with an utility to convert '''Hunspell''' dictionaries (''.dic'') to this format.
 <pre>
@@ Line 15: / Line 52: @@
 </pre>
-Created bdic dictionaries then need to be moved to one of the directories shown in the Preferences.
+Created ''.bdic'' dictionaries then need to be moved to one of the directories shown in the Preferences, which may be:
+<pre>
+/usr/bin/qtwebengine_dictionaries
+/usr/share/qt5/qtwebengine_dictionaries
+</pre>
+==User Style==
+It is possible to use custom ''.css'' or ''.js'' files if you want to override the content displayed on websites. This is an advanced functionality that can provide users with features not currently available on '''Falkon''' and meet certain needs for different kinds of users.
+For instance, it can be used for overriding fonts that are not affected by the Fonts preferences from '''Falkon'''.
+As such, a simple ''.css'' file that overrides fonts and turns them into the accessibility-friendly OpenDyslexic could be done like so:
+<pre>
+html *
+{
+  font-family: OpenDyslexic, sans-serif!important;
+}
+</pre>
+(Credits to Jason McDonald over at [https://userstyles.org/styles/158743/universal-opendyslexic userstyles.org] for submitting this code snippet as CC0.)
 ===Missing features===
-Currently, as of QtWebEngine 5.8, following useful features are missing:
+Currently, as of QtWebEngine 5.8, the following useful features are missing:
 * add words to custom dictionary