Install & build MythBrowse

Build from source

The Rust toolchain (1.92.0) is pinned in rust-toolchain.toml.

Test the light crates first. They do not compile Servo, run on any OS and take a few minutes:

cargo test -p mythbrowse-ai -p mythbrowse-blocker -p mythbrowse-compat -p mythbrowse-storage \
  -p mythbrowse-sync -p mythbrowse-files -p mythbrowse-notify -p mythbrowse-passwords -p mythbrowse-update
cargo test -p mythbrowse-engine --no-default-features

The browser itself compiles Servo: 16 GB RAM is recommended, and a build takes 30 to 90 minutes.

• Windows: Visual Studio 2022 Build Tools (C++), LLVM / clang (LIBCLANG_PATH), CMake, Ninja and Python 3. Then:

cargo build --release -p mythbrowse-shell

• Linux / macOS: not built in CI. Servo's build prerequisites and the same cargo build are the starting point, but expect platform gaps.

Windows package

The executable needs ANGLE's libEGL.dll and libGLESv2.dll (required graphics libraries) next to it. packaging/windows/ builds an MSI with WiX v5. Installers built from the repository are not code-signed.

Logs and errors

Windows release builds have no console window. Logs go to logs\mythbrowse.log in the profile folder (%LOCALAPPDATA%\MythBrowse Open Build for the open build). Start-up failures and crashes show an error dialog. Run mythbrowse.exe --console (or set MYTHBROWSE_CONSOLE=1) to print logs to the terminal instead.

Command line

mythbrowse [--console] [--private] [URL | text]

Text that is not a URL is sent to the AI home as a prompt. --private starts a private session.

Environment variables