Falkon: Difference between revisions

    From KDE UserBase Wiki
    (Added lots of information)
    No edit summary
     
    (7 intermediate revisions by 5 users not shown)
    Line 1: Line 1:
    ==Introduction==
    <!--{{Proposed_deletion|reason=duplication, this page contains information that is kept up to date at www.falkon.org/ }}-->[[Category:Proposed deletion]]
     
    [[File:Falkon mainscreen.png|thumb|Falkon mainscreen]]


    '''Falkon''' is a cross-platform Qt web browser previously known as '''QupZilla'''. It uses the 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==
    ==Installation==


    It can be installed on Windows 7 or newer as well as Linux from the repositories, as a flatpak and as a snap.
    Falkon 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/ .
    For Windows, ''.exe'' binaries are available for 32-bit and 64-bit architectures in https://www.falkon.org/download/ .
    Line 28: Line 28:
    ==Theming==
    ==Theming==


    By default, Falkon's user interface follows system theming and widgets.
    By default, Falkon's user interface follows system theming and widgets. Other themes are available under Preferences, namely: Chrome, Windows, Linux, Mac.
     
    However, other themes are available under Preferences, namely: Chrome, Windows, Linux, Mac.


    ==Fonts==
    ==Fonts==
    Line 40: Line 38:
    '''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.
    '''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.
    There are also extensions that integrate '''Falkon''' directly with your system if you are using KDE Plasma, for instance, PIM and KWallet integration.
     
    The current development version allows downloading more extensions. These can be downloaded from the [https://store.falkon.org/ Falkon Browser store].
     
    Manual installation of extensions for '''Falkon''' under Linux can be done by moving the extension folder into ~/.config/falkon/plugins/ if using version 3.1 or more, and into /usr/lib/qt/plugins/falkon/python/ if using a version lower than 3.1.
     
    For aspiring developers and contributors in general, there are also sample extensions that can be used to learn how to create your own extension.


    ==Spell Check==
    ==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.
    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===
    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.
    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.


    Line 52: Line 58:
    </pre>
    </pre>


    Created ''.bdic'' dictionaries then need to be moved to one of the directories shown in the Preferences, which may be:
    If that does not work, Chromium offers ''.bdic'' dictionaries directly.
    <pre>
    git clone https://chromium.googlesource.com/chromium/deps/hunspell_dictionaries
    </pre>
     
    The ''.bdic'' dictionaries then need to be moved to one of the directories shown in the Preferences, which may be:


    <pre>
    <pre>
    Line 58: Line 69:
    /usr/share/qt5/qtwebengine_dictionaries
    /usr/share/qt5/qtwebengine_dictionaries
    </pre>
    </pre>
    ===Missing features===
    Currently, as of QtWebEngine 5.8, the following useful features are missing:
    * add words to a custom dictionary
    * change path from which dictionaries are loaded


    ==User Style==
    ==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.
    It is possible to use custom ''.css'' or ''.js'' files if you want to override the content displayed on websites. This is 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'''.
    For instance, it can be used for overriding fonts that are not affected by the Fonts preferences from '''Falkon'''.
    Line 73: Line 92:
    }
    }
    </pre>
    </pre>
    (Credits to Jason McDonald over at [https://userstyles.org/styles/158743/universal-opendyslexic userstyles.org] for submitting this code snippet as CC0.)
    (Credits to Jason McDonald over at [https://userstyles.org/styles/158743/universal-opendyslexic userstyles.org] for submitting this code snippet as CC0.)


    ===Missing features===
    ==Missing features==
    Currently, as of QtWebEngine 5.8, the following useful features are missing:
    * One cannot drag tab into bookmark, neither into bookmark toolbar or bookmark manager. (Application version 3.2.0 QtWebEngine version 5.15.2)


    * add words to custom dictionary
    ==External links==
    * change path from which dictionaries are loaded
    * [https://www.falkon.org/ Homepage]


    [[Category:Internet]]
    [[Category:Internet]]

    Latest revision as of 11:28, 8 March 2024


    Falkon mainscreen

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

    Installation

    Falkon 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. 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.

    The current development version allows downloading more extensions. These can be downloaded from the Falkon Browser store.

    Manual installation of extensions for Falkon under Linux can be done by moving the extension folder into ~/.config/falkon/plugins/ if using version 3.1 or more, and into /usr/lib/qt/plugins/falkon/python/ if using a version lower than 3.1.

    For aspiring developers and contributors in general, there are also sample extensions that can be used to learn how to create your own extension.

    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
    

    If that does not work, Chromium offers .bdic dictionaries directly.

    git clone https://chromium.googlesource.com/chromium/deps/hunspell_dictionaries
    

    The .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
    

    Missing features

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

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

    User Style

    It is possible to use custom .css or .js files if you want to override the content displayed on websites. This is 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

    • One cannot drag tab into bookmark, neither into bookmark toolbar or bookmark manager. (Application version 3.2.0 QtWebEngine version 5.15.2)

    External links