fit-webview-bridge 0.1.1a6__tar.gz → 0.2.0a2__tar.gz

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/.gitignore

@@ -179,6 +179,4 @@ pyrightconfig.json
 *.db
 .DS_Store
 FIT/
-COMPILAZIONE.md
-TEST.md
 Qt/

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/CMakeLists.txt

@@ -1,14 +1,11 @@
 cmake_minimum_required(VERSION 3.24)
 project(FITWebViewBridge LANGUAGES CXX)
 
-# Standard C++
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 
-# Opzione unica rimasta
 option(BUILD_BINDINGS "Build Python bindings" ON)
 
-# Dispatch per-OS: tutta la logica sta nelle sottodirectory
 if(CMAKE_SYSTEM_NAME STREQUAL "Darwin")
   add_subdirectory(src/macos)
   if(BUILD_BINDINGS)

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fit-webview-bridge
-Version: 0.1.1a6
+Version: 0.2.0a2
 Summary: Qt native WebView bridge with PySide6 bindings
 Author: FIT Project
 License: LGPL-3.0-or-later
@@ -13,8 +13,6 @@ Description-Content-Type: text/markdown
 
 # FIT WebView Bridge
 
-[🇬🇧 English](README.md) | [🇮🇹 Italiano](README.it.md)
-
 ### Description
 
 **FIT WebView Bridge** is a cross‑platform Qt widget (C++/Objective‑C++) with **PySide6** bindings that wraps the OS‑native web engines:

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/README.md

@@ -1,7 +1,5 @@
 # FIT WebView Bridge
 
-[🇬🇧 English](README.md) | [🇮🇹 Italiano](README.it.md)
-
 ### Description
 
 **FIT WebView Bridge** is a cross‑platform Qt widget (C++/Objective‑C++) with **PySide6** bindings that wraps the OS‑native web engines:

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/bindings/pyside6/macos/CMakeLists.txt

@@ -1,33 +1,27 @@
 cmake_minimum_required(VERSION 3.21)
 
-# Python + Shiboken6 + PySide6
+
 find_package(Python3 REQUIRED COMPONENTS Interpreter Development.Module)
 find_program(SHIBOKEN6_GEN shiboken6 REQUIRED)
 
-# =============== Qt headers (solo SDK, via aqt) ==================
-# Passa -DQt6_DIR=/path/to/Qt/6.9.0/macos/lib/cmake/Qt6
+
 find_package(Qt6 6.7 REQUIRED COMPONENTS Core Gui Widgets)
 
-# Deriva la cartella frameworks (…/macos/lib) a partire da Qt6_DIR
-get_filename_component(_qt_cmake_dir "${Qt6_DIR}" DIRECTORY)            # …/macos/lib/cmake
-get_filename_component(QT_FRAMEWORKS_DIR "${_qt_cmake_dir}" DIRECTORY)  # …/macos/lib
+get_filename_component(_qt_cmake_dir "${Qt6_DIR}" DIRECTORY)
+get_filename_component(QT_FRAMEWORKS_DIR "${_qt_cmake_dir}" DIRECTORY)
 
-# Verifica headers Qt (SDK)
 foreach(_mod QtCore QtGui QtWidgets)
   if(NOT EXISTS "${QT_FRAMEWORKS_DIR}/${_mod}.framework/Headers")
     message(FATAL_ERROR "Missing ${_mod}.framework/Headers under: ${QT_FRAMEWORKS_DIR}")
   endif()
 endforeach()
 
-# Shim uniforme per includere QtCore/QtGui/QtWidgets
 set(QT_HDRSHIM "${CMAKE_BINARY_DIR}/qt_hdrshim")
 file(MAKE_DIRECTORY "${QT_HDRSHIM}")
 file(CREATE_LINK "${QT_FRAMEWORKS_DIR}/QtCore.framework/Headers"    "${QT_HDRSHIM}/QtCore"    SYMBOLIC)
 file(CREATE_LINK "${QT_FRAMEWORKS_DIR}/QtGui.framework/Headers"     "${QT_HDRSHIM}/QtGui"     SYMBOLIC)
 file(CREATE_LINK "${QT_FRAMEWORKS_DIR}/QtWidgets.framework/Headers" "${QT_HDRSHIM}/QtWidgets" SYMBOLIC)
 
-# =============== PySide6 runtime (da site-packages) ===============
-# Dir dei frameworks Qt nel venv (PySide6/Qt/lib)
 if(NOT DEFINED PYSIDE_QT_LIBDIR)
   execute_process(
     COMMAND ${Python3_EXECUTABLE} -c "import os, PySide6; print(os.path.join(os.path.dirname(PySide6.__file__), 'Qt', 'lib'))"
@@ -39,7 +33,6 @@ if(NOT EXISTS "${PYSIDE_QT_LIBDIR}")
   message(FATAL_ERROR "PySide6 Qt frameworks not found: ${PYSIDE_QT_LIBDIR}")
 endif()
 
-# Binari framework da PySide6 (linker)
 set(QTCORE_BIN    "${PYSIDE_QT_LIBDIR}/QtCore.framework/Versions/A/QtCore")
 set(QTGUI_BIN     "${PYSIDE_QT_LIBDIR}/QtGui.framework/Versions/A/QtGui")
 set(QTWIDGETS_BIN "${PYSIDE_QT_LIBDIR}/QtWidgets.framework/Versions/A/QtWidgets")
@@ -49,12 +42,12 @@ foreach(_f ${QTCORE_BIN} ${QTGUI_BIN} ${QTWIDGETS_BIN})
   endif()
 endforeach()
 
-# Trova anche i frameworks per completezza (stessa cartella)
+
 find_library(QTCORE_FW    NAMES QtCore    PATHS "${PYSIDE_QT_LIBDIR}" NO_DEFAULT_PATH REQUIRED)
 find_library(QTGUI_FW     NAMES QtGui     PATHS "${PYSIDE_QT_LIBDIR}" NO_DEFAULT_PATH REQUIRED)
 find_library(QTWIDGETS_FW NAMES QtWidgets PATHS "${PYSIDE_QT_LIBDIR}" NO_DEFAULT_PATH REQUIRED)
 
-# =============== Typesystem & includes Shiboken/PySide6 ==========
+
 execute_process(
   COMMAND ${Python3_EXECUTABLE} -c "import os,shiboken6;print(os.path.join(os.path.dirname(shiboken6.__file__),'typesystems'))"
   OUTPUT_VARIABLE SHIBOKEN_TYPESYS
@@ -66,7 +59,6 @@ execute_process(
   OUTPUT_STRIP_TRAILING_WHITESPACE
 )
 
-# Shiboken include (runtime, poi fallback al generator)
 execute_process(
   COMMAND ${Python3_EXECUTABLE} -c "import os,importlib; m=importlib.import_module('shiboken6'); print(os.path.join(os.path.dirname(m.__file__),'include'))"
   OUTPUT_VARIABLE SHIBOKEN_INCLUDE_DIR
@@ -84,7 +76,7 @@ if(NOT EXISTS "${SHIBOKEN_INCLUDE_DIR}/shiboken.h")
 endif()
 message(STATUS "Shiboken include dir: ${SHIBOKEN_INCLUDE_DIR}")
 
-# Shiboken runtime library
+
 execute_process(
   COMMAND ${Python3_EXECUTABLE} -c "import os,glob,importlib; d=os.path.dirname(importlib.import_module('shiboken6').__file__); m=glob.glob(os.path.join(d,'libshiboken*.dylib')) or glob.glob(os.path.join(d,'libshiboken*.so*')); print(m[0] if m else '')"
   OUTPUT_VARIABLE SHIBOKEN_LIBRARY
@@ -102,7 +94,7 @@ if(NOT SHIBOKEN_LIBRARY)
 endif()
 message(STATUS "Shiboken library: ${SHIBOKEN_LIBRARY}")
 
-# PySide6 include & lib
+
 execute_process(
   COMMAND ${Python3_EXECUTABLE} -c "import os, PySide6; print(os.path.join(os.path.dirname(PySide6.__file__), 'include'))"
   OUTPUT_VARIABLE PYSIDE_INCLUDE_DIR
@@ -119,11 +111,11 @@ endif()
 message(STATUS "PySide library   : ${PYSIDE_LIBRARY}")
 get_filename_component(PYSIDE_LIB_DIR "${PYSIDE_LIBRARY}" DIRECTORY)
 
-# Include per shiboken (SDK Qt + tuoi header + shiboken + PySide6)
+
 set(SHIBOKEN_INCLUDE_LIST
-  "${QT_HDRSHIM}"                         # QtCore/QtGui/QtWidgets headers
-  "${PROJECT_SOURCE_DIR}/src/macos"       # tuoi header nativi
-  "${SHIBOKEN_INCLUDE_DIR}"               # shiboken.h
+  "${QT_HDRSHIM}"                   
+  "${PROJECT_SOURCE_DIR}/src/macos"       
+  "${SHIBOKEN_INCLUDE_DIR}"             
   "${QT_FRAMEWORKS_DIR}/QtCore.framework/Headers"
   "${QT_FRAMEWORKS_DIR}/QtGui.framework/Headers"
   "${QT_FRAMEWORKS_DIR}/QtWidgets.framework/Headers"
@@ -139,7 +131,7 @@ endif()
 list(JOIN SHIBOKEN_INCLUDE_LIST ":" SHIBOKEN_INCLUDE_ARG)
 message(STATUS "Shiboken include paths:\n  ${SHIBOKEN_INCLUDE_ARG}")
 
-# =============== Shiboken: codegen ================================
+
 set(GEN_DIR ${CMAKE_CURRENT_BINARY_DIR}/shiboken_out)
 file(MAKE_DIRECTORY ${GEN_DIR})
 
@@ -173,24 +165,21 @@ if (SHIBOKEN_SRCS STREQUAL "")
   message(FATAL_ERROR "No sources generated in ${GEN_DIR}")
 endif()
 
-# =============== Estensione Python ================================
+
 add_library(_wkwebview MODULE ${SHIBOKEN_SRCS})
 target_compile_features(_wkwebview PRIVATE cxx_std_17)
 
-# Installa l’estensione nel pacchetto Python
 install(TARGETS _wkwebview
   LIBRARY DESTINATION fit_webview_bridge
   RUNTIME DESTINATION fit_webview_bridge
 )
 
-# Suffisso Python (es. .cpython-311-darwin.so)
 execute_process(
   COMMAND ${Python3_EXECUTABLE} -c "import sysconfig; print(sysconfig.get_config_var('EXT_SUFFIX') or '.so')"
   OUTPUT_VARIABLE PY_EXT_SUFFIX
   OUTPUT_STRIP_TRAILING_WHITESPACE
 )
 
-# Include & link
 target_include_directories(_wkwebview PRIVATE
   ${GEN_DIR}
   "${PROJECT_SOURCE_DIR}/src/macos"
@@ -207,10 +196,10 @@ if(EXISTS "${PYSIDE_INCLUDE_DIR}")
   )
 endif()
 
-# CMake deve cercare nelle dir dei framework di PySide6
+
 target_link_directories(_wkwebview PRIVATE "${PYSIDE_QT_LIBDIR}")
 
-# Linka CONTRO i binari di PySide6 + shiboken + Python + lib nativa
+
 target_link_libraries(_wkwebview PRIVATE
   "${QTCORE_BIN}"
   "${QTGUI_BIN}"
@@ -221,7 +210,6 @@ target_link_libraries(_wkwebview PRIVATE
   wkwebview
 )
 
-# =============== RPATH per runtime su macOS =======================
 get_filename_component(SHIBOKEN_LIB_DIR "${SHIBOKEN_LIBRARY}" DIRECTORY)
 option(FITWVB_VENDORIZE "Vendorize PySide/Qt lookup via @loader_path" ON)
 

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/examples/macos/wkwebview_demo.py

@@ -1,14 +1,19 @@
-import os, sys
+import os
+import sys
+
 ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
-sys.path[:0] = [os.path.join(ROOT, "build"),
-                os.path.join(ROOT, "build", "bindings", "shiboken_out")]
+sys.path[:0] = [
+    os.path.join(ROOT, "build"),
+    os.path.join(ROOT, "build", "bindings", "shiboken_out"),
+]
 
+from PySide6.QtCore import QUrl
+from PySide6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget
 
-from PySide6.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout
-from fit_webview_bridge import SystemWebView
 # tentativo 1: pacchetto generato da shiboken (wkwebview)
 try:
     import wkwebview
+
     WKWebViewWidget = wkwebview.WKWebViewWidget  # accesso via attributo
 except Exception:
     # tentativo 2: modulo nativo diretto
@@ -28,7 +33,8 @@ class Main(QMainWindow):
         self.view.titleChanged.connect(self.setWindowTitle)
         self.view.loadProgress.connect(lambda p: print("progress:", p))
 
-        self.view.load("https://www.facebook.com/reel/574839388710756/")
+        self.view.setUrl(QUrl("http://fit-project.org/"))
+
 
 app = QApplication([])
 m = Main()

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fit-webview-bridge"
-version = "0.1.1a6"
+version = "0.2.0a2"
 description = "Qt native WebView bridge with PySide6 bindings"
 requires-python = ">=3.11,<3.14"
 dependencies = ["PySide6==6.9.0", "shiboken6==6.9.0", "shiboken6-generator==6.9.0"]

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/src/macos/CMakeLists.txt

@@ -6,22 +6,19 @@ set(CMAKE_OBJCXX_STANDARD 17)
 set(CMAKE_OBJCXX_STANDARD_REQUIRED ON)
 set(CMAKE_AUTOMOC ON)
 
-# Qt da aqt: serve solo per moc + headers
-# Passa -DQt6_DIR=/path/to/Qt/6.9.0/macos/lib/cmake/Qt6
 find_package(Qt6 6.7 REQUIRED COMPONENTS Core Gui Widgets)
 
-# Deriva la cartella dei frameworks (…/macos/lib) da Qt6_DIR
 get_filename_component(_qt_cmake_dir "${Qt6_DIR}" DIRECTORY)       # …/macos/lib/cmake
 get_filename_component(QT_FRAMEWORKS_DIR "${_qt_cmake_dir}" DIRECTORY) # …/macos/lib
 
-# Verifica headers
+
 foreach(_m QtCore QtGui QtWidgets)
   if(NOT EXISTS "${QT_FRAMEWORKS_DIR}/${_m}.framework/Headers")
     message(FATAL_ERROR "Missing ${_m}.framework/Headers in: ${QT_FRAMEWORKS_DIR}")
   endif()
 endforeach()
 
-# Shim include uniforme
+
 set(QT_HDRSHIM "${CMAKE_BINARY_DIR}/qt_hdrshim")
 file(MAKE_DIRECTORY "${QT_HDRSHIM}")
 file(CREATE_LINK "${QT_FRAMEWORKS_DIR}/QtCore.framework/Headers"    "${QT_HDRSHIM}/QtCore"    SYMBOLIC)
@@ -42,7 +39,6 @@ target_include_directories(wkwebview PUBLIC
   ${QT_HDRSHIM}
 )
 
-# Link SOLO framework di sistema (Cocoa/WebKit). Niente Qt qui.
 target_link_libraries(wkwebview PUBLIC
   "-framework Cocoa"
   "-framework WebKit"

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/src/macos/WKWebViewWidget.h

@@ -1,16 +1,21 @@
 #pragma once
 #include <QWidget>
 #include <QObject>
+#include <QUrl>
 
-class QString; class QUrl; class QShowEvent; class QResizeEvent;
+class QString; class QShowEvent; class QResizeEvent;
 
 class WKWebViewWidget : public QWidget {
     Q_OBJECT
+    Q_PROPERTY(QUrl url READ url WRITE setUrl NOTIFY urlChanged)
+
 public:
     explicit WKWebViewWidget(QWidget* parent = nullptr);
     ~WKWebViewWidget() override;
 
-    Q_INVOKABLE void load(const QString& url);
+    Q_INVOKABLE QUrl url() const;
+    Q_INVOKABLE void setUrl(const QUrl& url);
+
     Q_INVOKABLE void back();
     Q_INVOKABLE void forward();
     Q_INVOKABLE void stop();

{fit_webview_bridge-0.1.1a6 → fit_webview_bridge-0.2.0a2}/src/macos/WKWebViewWidget.mm

@@ -22,7 +22,7 @@ struct WKWebViewWidget::Impl {
 - (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation {
     if (!self.owner) return;
     emit self.owner->loadFinished(true);
-    if (webView.URL) emit self.owner->urlChanged(QUrl(QString::fromUtf8(webView.URL.absoluteString.UTF8String)));
+    if (webView.URL) emit self.owner->urlChanged(QUrl::fromEncoded(QByteArray(webView.URL.absoluteString.UTF8String)));
     if (webView.title) emit self.owner->titleChanged(QString::fromUtf8(webView.title.UTF8String));
     emit self.owner->loadProgress(100);
     emit self.owner->canGoBackChanged(webView.canGoBack);
@@ -43,12 +43,23 @@ struct WKWebViewWidget::Impl {
 }
 @end
 
-static NSURL* toNSURL(QString u) {
-    u = u.trimmed();
-    if (!u.startsWith("http://") && !u.startsWith("https://")) u = "https://" + u;
-    return [NSURL URLWithString:[NSString stringWithUTF8String:u.toUtf8().constData()]];
+static NSURL* toNSURL(QUrl u) {
+    if (!u.isValid()) return nil;
+
+    if (u.scheme().isEmpty())
+        u = QUrl::fromUserInput(u.toString());
+
+    if (u.scheme() == "http")
+        u.setScheme("https");
+
+    if (u.isLocalFile())
+        return [NSURL fileURLWithPath:[NSString stringWithUTF8String:u.toLocalFile().toUtf8().constData()]];
+
+    const QByteArray enc = u.toString(QUrl::FullyEncoded).toUtf8();
+    return [NSURL URLWithString:[NSString stringWithUTF8String:enc.constData()]];
 }
 
+
 WKWebViewWidget::WKWebViewWidget(QWidget* parent)
     : QWidget(parent), d(new Impl) {
     setAttribute(Qt::WA_NativeWindow, true);
@@ -66,8 +77,6 @@ WKWebViewWidget::WKWebViewWidget(QWidget* parent)
     d->delegate = [WKNavDelegate new];
     d->delegate.owner = this;
     [d->wk setNavigationDelegate:d->delegate];
-
-    load(QStringLiteral("https://example.org"));
 }
 
 WKWebViewWidget::~WKWebViewWidget() {
@@ -77,12 +86,25 @@ WKWebViewWidget::~WKWebViewWidget() {
     delete d; d = nullptr;
 }
 
-void WKWebViewWidget::showEvent(QShowEvent* e) { QWidget::showEvent(e); /* opzionale */ }
-void WKWebViewWidget::resizeEvent(QResizeEvent* e) { QWidget::resizeEvent(e); /* opzionale */ }
+void WKWebViewWidget::showEvent(QShowEvent* e) { QWidget::showEvent(e); }
+void WKWebViewWidget::resizeEvent(QResizeEvent* e) { QWidget::resizeEvent(e); }
+
+QUrl WKWebViewWidget::url() const {
+    if (!(d && d->wk)) return QUrl();
+    NSURL* nsurl = d->wk.URL;
+    if (!nsurl) return QUrl();
+    const char* utf8 = nsurl.absoluteString.UTF8String;
+    if (!utf8) return QUrl();
+    return QUrl::fromEncoded(QByteArray(utf8));
+}
 
-void WKWebViewWidget::load(const QString& url) {
-    if (d && d->wk) [d->wk loadRequest:[NSURLRequest requestWithURL:toNSURL(url)]];
+void WKWebViewWidget::setUrl(const QUrl& u) {
+    if (!(d && d->wk)) return;
+    NSURL* nsurl = toNSURL(u);
+    if (!nsurl) return;
+    [d->wk loadRequest:[NSURLRequest requestWithURL:nsurl]];
 }
+
 void WKWebViewWidget::back()    { if (d && d->wk && d->wk.canGoBack)    [d->wk goBack]; }
 void WKWebViewWidget::forward() { if (d && d->wk && d->wk.canGoForward) [d->wk goForward]; }
 void WKWebViewWidget::stop()    { if (d && d->wk) [d->wk stopLoading:nil]; }

fit_webview_bridge-0.1.1a6/README.it.md

@@ -1,139 +0,0 @@
-# FIT WebView Bridge
-
-[🇬🇧 English](README.md) | [🇮🇹 Italiano](README.it.md)
-
-### Descrizione
-
-**FIT WebView Bridge** è un widget Qt multipiattaforma (C++/Objective-C++) con binding **PySide6** che incapsula i motori web nativi del sistema:
-- **Windows →** Edge WebView2
-- **macOS →** WKWebView
-- **Linux →** WebKitGTK (con **GStreamer** per i codec)
-
-Espone una **API Python unificata** per controllare il browser ed abilita la **visualizzazione/acquisizione forense** di contenuti, inclusi quelli che richiedono codec proprietari (es. **H.264/AAC**), **senza** build personalizzate di QtWebEngine né oneri di redistribuzione dei codec (si usano quelli del sistema operativo). I **controlli** (UI e logica applicativa) sono **demandati alla finestra PySide**.
-
-### Perché questo progetto
-QtWebEngine (Chromium) di default **non abilita i codec proprietari** e la loro distribuzione richiede **licenza**. Le alternative considerate (compilare QtWebEngine con codec o usare QtWebView/QML) presentano limiti di portabilità/controllo. La via scelta è **incapsulare i motori di sistema**, ottenendo compatibilità con i codec e **massimo controllo** via API Python.
-
-### Struttura del repository
-```
-fit-webview-bridge/
-├─ CMakeLists.txt
-├─ cmake/                   # Find*.cmake, toolchain, helper
-├─ include/fitwvb/          # Header pubblici (API)
-├─ src/
-│  ├─ core/                 # Facade / interfacce comuni
-│  ├─ win/                  # Backend Edge WebView2 (C++)
-│  ├─ macos/                # Backend WKWebView (Obj-C++)
-│  └─ linux/                # Backend WebKitGTK (C++)
-├─ bindings/pyside6/        # Shiboken6: typesystem e config
-├─ tests/                   # Unit / integration
-└─ examples/                # Mini app PySide6 dimostrativa
-```
-
-### Interfaccia (metodi/slot + segnali)
-**Metodi / slot**
-- `load(url)`
-- `back()`
-- `forward()`
-- `reload()`
-- `stop()`
-- `setHtml(html, baseUrl)`
-- `evalJs(script, callback)`
-
-**Segnali**
-- `urlChanged(QUrl)`
-- `titleChanged(QString)`
-- `loadProgress(int)`
-- `loadFinished(bool)`
-- `consoleMessage(QString)`
-
-> Nota: l’API è esposta in modo **uniforme** su tutti gli OS; l’implementazione delega al motore nativo.
-
-### Prerequisiti
-**Comuni**
-- **CMake** (>= 3.24 consigliato)
-- **Ninja** (generator)
-- **Python** 3.9+
-- **PySide6** e **Shiboken6** (per i binding Python)
-- Strumenti di build della piattaforma
-
-**Windows**
-- **MSVC** (Visual Studio 2022 o Build Tools) e Windows SDK
-- **Microsoft Edge WebView2 Runtime**
-- **WebView2 SDK** (NuGet/vcpkg)
-
-**macOS**
-- **Xcode** + Command Line Tools
-- Linguaggio **Objective-C++** abilitato (.mm)
-- Framework: `WebKit`, `Cocoa`
-
-**Linux**
-- **GCC/Clang**, `pkg-config`
-- **WebKitGTK** dev (es. `webkit2gtk-4.1` o equivalente della distro)
-- **GStreamer** (base + plugin necessari per i codec)
-
-### Compilazione (indicativa)
-```bash
-git clone https://github.com/fit-project/fit-webview-bridge.git
-cd fit-webview-bridge
-cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DBUILD_PYSIDE6_BINDINGS=ON
-cmake --build build
-# (opzionale) ctest --test-dir build
-```
-
-### Esempi
-Gli esempi PySide6 si trovano in `examples/` e mostrano caricamento URL, iniezione JS e ascolto dei segnali.
-
-### Considerazioni su codec e licenze
-Il progetto **non** ridistribuisce codec proprietari: sfrutta i codec **già presenti nel sistema operativo**. L’uso finale dei contenuti è responsabilità dell’utente in base alle rispettive licenze/formati.
-
-### Stato del progetto
-Iniziale/alpha (API soggetta a modifiche).
-
----
-
- Fit Web — Motivazioni del progetto e opzioni per i codec proprietari
-
-**Fit Web** è il modulo *scraper* del progetto FIT pensato per **acquisire e cristallizzare, con modalità forensi, contenuti web**: <https://github.com/fit-project/fit-web>.
-
-Come gli altri moduli, **Fit Web** si basa su **PySide** (Qt per Python). Attualmente utilizza **QtWebEngine**, che è un *wrapper* di **Chromium**.
-
-## Il problema
-Chromium, di default, **non abilita i codec audio/video proprietari**, in particolare **H.264** e **AAC**.
-
-## Soluzioni considerate
-
-### 1) Compilare QtWebEngine con codec proprietari
-Abilitare l’opzione `-webengine-proprietary-codecs`.  
-Documentazione: <https://doc.qt.io/qt-6/qtwebengine-overview.html>
-
-**Criticità**
-- Va eseguito per **tutti i sistemi operativi** supportati.
-- La compilazione richiede **macchine molto performanti** (es.: difficoltà su MacBook Air M2 con 16 GB di RAM).
-- **Licenze**: la **distribuzione** di H.264 e AAC **richiede una licenza**.
-
-### 2) Usare QtWebView
-QtWebView utilizza **le API web native del sistema operativo**; per i contenuti con codec proprietari sfrutta **i codec del sistema**.  
-**Vantaggi**: niente compilazioni personalizzate, niente gestione diretta delle licenze.  
-**Limiti**: l’interfaccia è in **QML**, pensata per UI leggere (spesso mobile), e **non offre il controllo completo** sul browser rispetto a QtWebEngine.
-
-Documentazione: <https://doc.qt.io/qt-6/qtwebview-index.html>
-
-### 3) Scrivere un widget Qt nativo (C/C++) per ogni OS
-Creare un widget Qt (usabile da **PySide6**) che *embedda* il motore web di sistema:
-
-- **Windows →** Edge WebView2
-- **macOS →** WKWebView
-- **Linux →** WebKitGTK (con **GStreamer** per i codec)
-
-**Vantaggi**
-- **Nessuna licenza da redistribuire**: si usano i codec già forniti dal sistema.
-- Possibilità di **un’API comune** da esporre a PySide6.
-- **Maggiore controllo** rispetto a QtWebView, senza i limiti imposti da QML.
-
-**Svantaggi**
-- **Complessità medio‑alta** di implementazione.
-- Richiede **C++** e, su macOS, anche **Objective‑C++**.
-- Necessità di **CMake** ad hoc per includere librerie e collegamenti.
-
----