Skip to content

Web browser for Plasma Mobile

Notifications You must be signed in to change notification settings

KDE/plasma-angelfish

Repository files navigation

Angelfish

This is an experimental webbrowser designed to

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

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

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