Angelfish

This is a webbrowser designed to

• be used on small mobile devices,
• integrate well in Plasma workspaces

Reporting bugs

Bugtracker: https://bugs.kde.org/describecomponents.cgi?product=angelfish

Preliminary roadmap:

• browser navigation: back + forward + reload
• browser status
• Implement URL bar
• Error handler in UI
• history store, model and UI
• bookmarks store, model and UI
  • add / remove
• in-window navigation: tabs in bottom bar
• SSL error handler
• Touch actions (pinch?) (done in QtWebEngine)
• user-agent to request mobile site
• open and close new tabs
• History based completion
• Right click / long press menu
• purpose integration (for kdeconnect)
• adblock

Development

Building

If you are using a rolling release distribution, you can install the dependencies using your package manager. Otherwise, use kde-builder to build angelfish and its dependencies. Setting up kde-builder is documented in the Community Wiki

Currently the dependencies are:

• Qt (including QtCore, QtQuick, QtTest, QtGui, QtSvg, QtQuickControls2, QtSql and optionally QtFeedback)
• The KDE Frameworks (including Kirigami2, Purpose, I18n, Config, CoreAddons, DBusAddons, WindowSystem, Notifications)
• Rust (including cargo and rustc) (optional)
• Corrosion (optional)

Please check the community wiki for how to build projects with kde-builder. If you went for using your distribution's package manager, then you can build (and install) Angelfish like this:

mkdir build
cd build
cmake .. # add -DCMAKE_BUILD_TYPE=Release to compile for release
make
sudo make install # optional, if you want to install Angelfish into your system

Adblock

To debug requests sent by the browser, for example for debugging the ad blocker, it can be useful to have a look at the development tools. For using them, the browser needs to be started with a special environment variable set: QTWEBENGINE_REMOTE_DEBUGGING=4321 angelfish. The variable contains the port on which the development tools will be available. You can now point another browser to http://localhost:4321.

To enable adblock logging, add the following to ~/.config/QtProject/qtlogging.ini:

[Rules]
org.kde.angelfish.adblock.debug=true

Flatpak

If one of the Cargo.toml files is updated, the flatpak sources need to be regenerated. That can be done using the ./flatpak/regenerate-sources.sh script.