Vivian Browser

🐧 Linux (Ubuntu 22.04+)

sudo apt install cmake build-essential libssl-dev \
     qt6-base-dev qt6-webengine-dev qt6-speech-dev \
     qt6-multimedia-dev libqt6concurrent6-dev

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
./build/bin/VivianBrowser

🍎 macOS (Apple Silicon + Intel)

# Install dependencies via Homebrew
brew install cmake openssl qt@6

# Configure & build
cmake -B build -DCMAKE_PREFIX_PATH=$(brew --prefix qt@6) \
               -DOPENSSL_ROOT_DIR=$(brew --prefix openssl)
cmake --build build --config Release

# Run (app bundle)
open build/bin/VivianBrowser.app

🪟 Windows (MSVC 2022)

# Install Qt 6.5 LTS (MSVC 2019 64-bit + WebEngine + Speech + Multimedia)
# Install OpenSSL 3 from https://slproweb.com/products/Win32OpenSSL.html

cmake -B build -G "Visual Studio 17 2022" -A x64 ^
      -DCMAKE_PREFIX_PATH="C:\Qt\6.5.3\msvc2019_64" ^
      -DOPENSSL_ROOT_DIR="C:\OpenSSL-Win64"
cmake --build build --config Release
build\bin\VivianBrowser.exe

🍓 Raspberry Pi (ARM64)

sudo apt install cmake build-essential libssl-dev \
     qt6-base-dev libqt6webenginewidgets6 libqt6webenginecore6 \
     qt6-speech-dev qt6-multimedia-dev

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j2   # single-threaded to avoid OOM

// Every plugin implements PluginInterface:
class MyPlugin : public QObject, public PluginInterface {
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "net.d0a.vivian.PluginInterface/1.0")
    Q_INTERFACES(PluginInterface)

public:
    PluginMeta meta() const override {
        return { "com.example.myplugin", "My Plugin", "1.0",
                 "Does something cool", "Your Name" };
    }
    void initialize(BrowserAPI *api) override;
    void shutdown() override;

    // Optional hooks:
    void onPageLoad(const QString &url, const QString &title) override;
    void onUrlChange(const QString &url) override;
    QList<QAction*> toolbarActions() override;
    QList<QAction*> contextMenuActions(QWidget *webView) override;
};