') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); Web backend: run ManaTools AUI apps in a web browser by xquiet · Pull Request #7 · manatools/python-manatools · GitHub
Skip to content

Web backend: run ManaTools AUI apps in a web browser - #7

Open
xquiet wants to merge 97 commits into
mainfrom
web_backend
Open

Web backend: run ManaTools AUI apps in a web browser#7
xquiet wants to merge 97 commits into
mainfrom
web_backend

Conversation

@xquiet

@xquietxquiet commented Aug 2, 2026

Copy link
Copy Markdown

This branch adds a fourth UI backend to the AUI layer: applications written
against manatools can now be served in a web browser with no code
changes - the same source runs on Qt, GTK, ncurses, or web.

What's included

  • New web backend (manatools/aui/backends/web/): renders the widget
    tree as HTML and serves it over HTTP, with real-time updates and events over
    WebSocket. Pure Python standard library without extra dependencies;
  • All standard widgets supported: dialogs (main + popup modals), layouts,
    labels, buttons, input fields, check/radio boxes, combo/selection boxes,
    frames, progress bars, sliders, tables, trees, rich text, menu bars, images,
    int/date/time fields, multi-line edit, log view, dumb tabs, paned splitter,
    spacing, alignment, replace points;
  • Backend selection: MUI_BACKEND=web|qt|gtk|ncurses environment
    variable override; the web backend is opt-in only and it's never
    auto-selected;
  • Security hardening: CSP and standard security headers on
    every response, localhost-only binding, origin checks on WebSocket upgrades
    and the /event POST fallback, frame/body size caps, path-traversal guards
    on static file and icon serving;
  • Browser UX: Bootstrap 5.3 frontend, XDG icon lookup served from system
    themes, deferred skeleton rendering for heavy widgets (table/tree),
    coalesced server thus browser DOM updates;
  • Qt backend robustness fixes: widgets now initialize their attributes
    before super().__init__() so containers that trigger backend-widget
    creation mid-construction (e.g. YDumbTab) no longer crash; popup dialog
    lifecycle fixes; guarded _items access in table/tree rebuilds.

How to test

bash
MUI_BACKEND=web python3 test/test_hello_world.py

The application prints its URL (http://127.0.0.1:8080/) - open it in a
modern browser. The same test runs unchanged under MUI_BACKEND=qt,
gtk, or ncurses.

Notes

  • The web backend binds to 127.0.0.1 only; file dialogs and system tray are
    not supported in the browser but they seems to degrade gracefully;
  • This branch also carries the main fixes/features merged in (tooltips,
    paned multi-layout, backend detection improvements), so it's ready to
    fast-forward main, local testing show no conflicts.

xquiet added 30 commits March 28, 2026 23:44
xquiet
Add new Web backend
7caae71
xquiet
Add web backend support to the selector
087ea1d
xquiet
Add web backend to the advertised subpackages
b1159f9
xquiet
Fixed icon button rendering via XDG icon lookup endpoint
935e23e
xquiet
Fixed event listener loss after widget DOM replacement
dd5ebbe
xquiet
Added busy overlay via busyCursor/normalCursor WebSocket message
d1d4c04
xquiet
Fixed busy overlay dismissed before widget updates arrive in browser
b32bb1c
xquiet
Silenced BrokenPipeError on static/icon serving (client disconnect)
8949d2a
xquiet
Added client-side pagination, search and sticky header to YTableWeb
c0a3abb
xquiet
Fixed table disappearing on narrow viewport (missing min-width:0 on f…
3d1f500
…lex items)
xquiet
Rendered treeweb as paginated table; added responsive mobile layout
0eaed78
xquiet
Improved responsiveness: yhbox wraps, paned sections padded, mobile d…
b47dc0f
…ivider spacing
xquiet
Fixed About dialog button unresponsive after resize: removed harmful …
08b401f
…pointer-events sibling rule
xquiet
Intercept YRichText link clicks: prevent navigation, post YMenuEvent
f7df329
Links inside YRichText now behave like Qt/GTK: browser navigation is
blocked, the URL is stored in widget._last_url, and a YMenuEvent(id=url)
is posted to the dialog queue when notify() is True.
xquiet
Replace YUI_BACKEND with MUI_BACKEND
d9a9e0a
xquiet
Add checkbox column support to YTableWeb
facf7d2
xquiet
Fixed YRichText shifting on update: use innerHTML action to avoid re-…
8f8f8f9
…insertion
xquiet
Extended _flush_update to support 3-tuple render_update() with custom…
e946dd2
… action
xquiet
Fixed paned divider collapsing and improved YRichText responsiveness
ff7fb13
xquiet
Collapse paned section and divider when child widget is hidden
506b454
xquiet
YLabelWeb now has setAutoWrap(on) and autoWrap()
3eee365
xquiet
Add thread-local initial-render context flag to commonweb
ac36dba
xquiet
Set initial-render flag around dialog.render() in HTTP handler
c76fcca
xquiet
Handle ready message and push deferred table rows on WS connect
200238e
xquiet
Defer table row rendering: skeleton on initial load, rows pushed via …
84ea32c
…WS; drop page-size selector
xquiet
Send ready on WS open; handle rows action to inject deferred table co…
20ae200
…ntent
xquiet
Add loading row style for deferred table skeleton
b48c125
xquiet
Harden WebSocket: origin check, recv_exact, frame size cap, CSRF guar…
0a61d66
…d on /event
xquiet
Add shutdown overlay element to base template
4222c50
xquiet
Add shutdown overlay style
4b13b28
xquiet added 30 commits April 6, 2026 20:24
xquiet
Fixed typo
23401d5
xquiet
Merge origin/main: updated translation files
574524b
xquiet
Merge origin/main: wayland desktop_file_name, translations
4367ef2
xquiet
Merge origin/web_backend: rebase reconciliation, keep local main-merg…
933adea
…e content
xquiet
Fix comment wording and alignment in backend map
d569339
xquiet
Remove page-size selector from treeweb controls bar
5cab5b5
xquiet
Align table search input to the right; fix controls overlap with sibl…
5f760d6
…ing elements
xquiet
Add missing setProperty/getProperty/_set_backend_enabled to YFrameWeb…
589ad06
…; fix enabled handling
xquiet
Fix YAlignment vertical stretch and YFrame responsiveness/overlap
3c84806
xquiet
Track skeleton state per table; only push deferred rows when skeleton…
0f95320
… was actually emitted
xquiet
Guard _push_deferred_tables: skip non-skeleton tables, catch per-widg…
743bd59
…et exceptions
xquiet
Fix YImageWeb: resolve file paths as data URIs, icon names via /icon/…
91337ea
… endpoint; add autoScale and fallBackName
xquiet
Pass fallBackName in createImage factory method
b93f1e0
xquiet
Fix YImage CSS: container uses flexbox, img element carries sizing rules
1e6f4a2
xquiet
Make YFrame and YAlignment responsive: wrap in HBox instead of collap…
45a6d1d
…sing
xquiet
Rewrite YDumbTabWeb: extend YSelectionWidget, Bootstrap 5.3 nav-tabs,…
694fbae
… notify support
xquiet
Replace custom tab CSS with Bootstrap 5.3 nav-tabs; add dumbtab conte…
a3804e5
…nt layout rules
xquiet
Update handleTabClick to toggle Bootstrap active class and aria-selec…
7bd5265
…ted attribute
xquiet
Cap /event POST body at 64 KB to prevent memory exhaustion
9bef400
xquiet
Fix ComboBox option value= escaping: use html.escape(quote=True) to h…
220b100
…andle labels with double quotes
xquiet
Send selectedValue in handleSelectChange so server label-based lookup…
28cf8a3
… works
xquiet
Add HTTP security headers: CSP, X-Frame-Options, X-Content-Type-Optio…
51ee5d5
…ns, Referrer-Policy
xquiet
Replace inline onclick on reload button with id for CSP compliance
ce3c7f7
xquiet
Wire reload button via JS; add paned splitter drag with mouse and tou…
eaec3d1
…ch support
xquiet
Add drag-state cursor lock CSS for paned splitter
af9e7ba
xquiet
Fix YTableQt popup: init attributes before super() so _create_backend…
0eeb559
…_widget runs correctly inside YDumbTab
xquiet
Fix YTreeQt: init attrs before super() to survive early _create_backe…
d5170bc
…nd_widget call; guard _items in _rebuildTree
xquiet
Fix popup: never setParent(None) on visible widget in _attach_child_b…
d4c762e
…ackend fallback
xquiet
Guard _items access in rebuildTable with getattr for early _create_ba…
f1f964d
…ckend_widget calls
xquiet
Merge origin/main: tooltips, paned multi-layout, backend detection, p…
9a7d2ee
…o build
Resolved yui.py conflict: keep MUI_BACKEND/XDG detection, take main's
DISPLAY/WAYLAND and PKEXEC_UID display-recovery steps, web backend stays
explicit-only. treeqt.py merged both the init-before-super ordering and
tooltip support.
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@xquiet