Embedded browser with tunnel proxy, bookmarks & AxScript API#306
Open
shashinma wants to merge 11 commits intoAdaptix-Framework:dev-v1.3from
Open
Embedded browser with tunnel proxy, bookmarks & AxScript API#306shashinma wants to merge 11 commits intoAdaptix-Framework:dev-v1.3from
shashinma wants to merge 11 commits intoAdaptix-Framework:dev-v1.3from
Conversation
Lists the Qt WebEngine development package next to other Qt6 modules in pre_install_linux_all.sh so Linux setups can install optional WebEngine headers/libs needed to build AdaptixClient with the embedded browser.
Exposes a small API to recompute popover frame geometry and mask after inner widgets change size or visibility. Used when proxy popover content toggles rows (e.g. host/port) so fixed-size content does not leave a blank gap.
Add PNG assets for toolbar and home page: globe, home, tab bar toggles, DevTools open/close, bookmark bar, star (filled/outline), edit/delete, and detach-to-window. Wire aliases in Resources.qrc for :/icons/… URLs.
Build: find Qt6 WebEngineWidgets with QUIET, set HAS_WEBENGINE; when found, add EmbeddableBrowserWidget sources, link Qt6::WebEngineWidgets, and define HAS_QT_WEBENGINE for conditional UI. Widget: multi-tab QWebEngineView, shared profile, bookmark home grid, navigation and proxy popover (SOCKS5/HTTP/manual), tunnel list from AdaptixWidget::Tunnels under TunnelsLock, DevTools, optional floating QMainWindow, adaptix-browser:// internal URLs. Client still builds when WebEngine is not installed.
When HAS_QT_WEBENGINE: globe toolbar button, EmbeddableBrowserWidget instance, and LoadBrowserUI(url, proxyHost, proxyPort) to show the bottom dock and optionally set SOCKS5 before navigation.
Script API forwards to AdaptixWidget::LoadBrowserUI with optional URL and SOCKS proxy host/port. No-op build path without HAS_QT_WEBENGINE (Q_UNUSED) so scripts stay valid on minimal Qt builds.
Introduce BrowserChromeMode and EmbeddableBrowserOptions (fullMode / chromelessMode factories). Split UI build into createFullUI (renamed from createUI) and createChromelessUI: chromeless uses a dedicated QWebEngineProfile per logicalId and a single QWebEngineView without tabs, toolbar, bookmarks, proxy popover, or DevTools chrome. Guard slots and helpers that touch full-chrome widgets (urlBar, proxy combo, navigation buttons, etc.) so chromeless instances stay safe. currentWebView returns the lone view in chromeless mode; createNewTabPage, loadHomePage, openBrowserInSeparateWindow, and DevTools are no-ops or disabled there. setProxy updates UI controls only in Full mode; otherwise applies QNetworkProxy directly. isBrowserDevToolsOpen is false in chromeless.
Track per-panel EmbeddableBrowserWidget instances in chromelessWebPanels
keyed by logical panel id. chromelessExtDockId builds stable ext-dock ids
including project name.
LoadChromelessWebPanel creates or reuses a chromeless dock, applies
optional SOCKS proxy, loads URL, registers AddExtDock/PlaceDock on the
bottom dock. CloseChromelessWebPanel removes ext dock and deletes the
widget. clearChromelessWebPanels closes all (used from ClearAdaptix).
applyChromelessWebModulesJson parses JSON: either { "apps": [...] } or a
root array. Each app needs id, title, url; optional proxy_host, proxy_port,
icon. Panels whose ids disappear from the payload are closed; others are
created or updated via LoadChromelessWebPanel.
Add includes for QJsonParseError, QSet, QUrl.
When setSyncUpdateUI toggles UI updates for the main docks, also call setUpdatesEnabled on BrowserDock and on each chromeless EmbeddableBrowserWidget so full and embedded web views respect the same sync batching as the rest of the client.
open_web_panel(chromeless, panelId, title, url, proxyHost, proxyPort, icon): when chromeless is false, delegates to LoadBrowserUI (same as the existing embedded browser). When true, requires a non-empty panelId and opens LoadChromelessWebPanel; logs an error if panelId is missing. apply_chromeless_web_modules(jsonPayload) forwards to AdaptixWidget::applyChromelessWebModulesJson for declarative sync of multiple chromeless panels from script or extender payloads. Both entry points compile to no-ops without HAS_QT_WEBENGINE.
Update Go version across Dockerfile, pre_install_linux_all.sh, and gopher_agent/src_gopher/go.mod to match go.work requirement.
Feedback: Cookie Management & External Session ImportRegarding the new Embedded Browser implementation, adding a native mechanism to import or inject cookies (JSON/plaintext) into the dedicated profiles would be a valuable addition. Proposed Enhancement
Thanks for the work on this it's a solid addition to the framework. |
Contributor
Author
Thanks, that’s something we can think about and maybe add in the next release. |
It is strongly recommended to add this feature. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Changes
Embedded Browser — Full mode
EmbeddableBrowserWidget: multi-tabQWebEngineView, shared profile, bookmark home grid, navigation bar, proxy popover (SOCKS5/HTTP/manual), tunnel list, DevTools, detach to separate window,adaptix-browser://internal URLs.LoadBrowserUI(url, proxyHost, proxyPort).HAS_QT_WEBENGINE); the client builds without it.Features preview
Homepage with bookmark tiles, tabs & proxy popover
The home page displays a tile grid of bookmarked sites with favicons. Tabs run along the top; the bookmarks bar auto-trims to fit available width. The proxy popover lets the operator pick an active SOCKS5 tunnel or enter a custom host:port.
Proxy popover — tunnel picker & manual mode
Left: tunnel picker dropdown listing active SOCKS5 tunnels by agent name. Right: after selecting a tunnel, the proxy type, host and port are auto-filled (bind address normalized to
127.0.0.1).Browsing an internal target through a SOCKS5 tunnel
Navigating to an internal OWA (Outlook Web Access) page at
10.154.21.34via a SOCKS5 tunnel bound to agent LMILLER. All browser traffic is routed through the beacon's tunnel — no external tools or browser configuration required.Back button long-press history menu
Long-pressing the Back button opens a dropdown with the last 25 visited pages, allowing quick jumps without clicking Back repeatedly.
Detached browser in a separate window
The browser can be detached into a standalone floating window. Multi-tab browsing, navigation, bookmarks and proxy settings remain fully functional. Closing the window re-parents the browser back into the dock.
Embedded Browser — Chromeless mode
BrowserChromeModeenum withfullMode/chromelessModefactories.QWebEngineProfileperlogicalId, singleQWebEngineView, no tabs, toolbar, bookmarks, or DevTools.AdaptixWidgetmanages chromeless panels (chromelessWebPanelsmap) — create/reuse/remove ext docks.applyChromelessWebModulesJson— declarative panel sync from JSON: creates new panels, updates existing ones, closes removed ones.AxScript API
open_embedded_browser— opens Full browser with optional URL and SOCKS proxy.open_web_panel(chromeless, panelId, title, url, ...)— opens a Full or Chromeless panel.apply_chromeless_web_modules(jsonPayload)— batch sync of chromeless panels.HAS_QT_WEBENGINE.UI / qlementine
Popover::relayoutToContent()— recomputes popover geometry when inner content changes size.setUpdatesEnabledon browser docks during sync pause.Infrastructure
pre_install_linux_all.sh,gopher_agent/src_gopher/go.mod.