{% extends "styled.html" %} {% block style %} {{super()}} .note { font-size: smaller; color: grey; } .mono { font-family: monospace; } {% endblock %} {% block content %}

Legacy QtWebKit backend

Note this warning will only appear once. Use :open qute://backend-warning to show it again at a later time.

You're using qutebrowser with the legacy QtWebKit backend. It's still the default until a few remaining issues are sorted out. If you can, it's strongly suggested to switch earlier, as legacy QtWebKit has known security issues and also breaks things on various websites.

Using QtWebEngine instead

This is usually the better choice if you aren't using Nouveau graphics, and don't need any features which are currently unavailable with QtWebEngine (like the qute://settings page or caret browsing). {% macro install_webengine(package) -%} You should be able to install {{ package }} and start qutebrowser with --backend webengine to use the new backend. {%- endmacro %} {% macro please_open_issue() -%} If you know more, please open an issue! {%- endmacro %} {% macro unknown_system() -%} There's no information available for your system. {{ please_open_issue() }} {%- endmacro %}

{% if distribution.parsed == Distribution.ubuntu %} {% if distribution.version == none %} {{ unknown_system() }} {% elif distribution.version >= version('17.04') %} {{ install_webengine('python3-pyqt5.qtwebengine') }} {% elif distribution.version >= version('16.04') %} QtWebEngine is only available in Ubuntu's repositories since 17.04, but you can install qutebrowser via tox with tox -e mkvenv-pypi to use the new backend. {% else %} Unfortunately, no easy way is known to install QtWebEngine on Ubuntu < 16.04. {{ please_open_issue() }} {% endif %} {% elif distribution.parsed == Distribution.debian %} {% if distribution.version == none %} {{ unknown_system() }} {% elif distribution.version >= version('9') %} {{ install_webengine('python3-pyqt5.qtwebengine') }} {% else %} Unfortunately, no easy way is known to install QtWebEngine on Debian < 9. {{ please_open_issue() }} {% endif %} {% elif distribution.parsed in [Distribution.arch, Distribution.manjaro] %} {{ install_webengine('qt5-webengine') }} {% elif distribution.parsed == Distribution.void %} {{ install_webengine('python-PyQt5-webengine') }} {% elif distribution.parsed == Distribution.fedora %} {{ install_webengine('qt5-qtwebengine') }} {% elif distribution.parsed == Distribution.opensuse %} {{ install_webengine('libqt5-qtwebengine') }} {% else %} {{ unknown_system() }} {% endif %}

Using QtWebKit-NG instead

This is a drop-in replacement for legacy QtWebKit.

{% if distribution.parsed == Distribution.debian and distribution.version != none and distribution.version >= version('9') %} There are unofficial QtWebKit-NG packages available. {% elif distribution.parsed in [Distribution.ubuntu, Distribution.debian] %} No easy way is known to install QtWebKit-NG on your system. There are unofficial QtWebKit-NG packages available, but they are intended for Debian Unstable. {{ please_open_issue() }} {% elif distribution.parsed in [Distribution.arch, Distribution.manjaro] %} With an updated qt5-webkit package, you should already get QtWebKit-NG. {% elif distribution.parsed == Distribution.gentoo %} There's an unofficial ebuild available. {% else %} {{ unknown_system() }} {% endif %}

{% endblock %}