Skip to content

Bug: Missing GTK/WebKit dependencies causes opaque launcher failure for Linux #158

@bxrne

Description

@bxrne

Problem

Tried the multi browser template project but bun start fails to launch the application due to missing runtime dependencies it links against.

It fails at startup due to missing system GTK/WebKit libraries. The error message is low-level (ERR_DLOPEN_FAILED) and does not indicate which packages need to be installed.

  • These Linux runtime dependencies are not documented.
  • The launcher surfaces a low-level dlopen error.
  • There is no guidance for which packages to install. (ldd libNativeWrapper.so can show it to be fair)

Output

Failed to open library ".../libNativeWrapper.so":
libwebkit2gtk-4.1.so.0: cannot open shared object file

code: ERR_DLOPEN_FAILED

Environment

  • OS: Arch Linux x86_64
  • Kernel: Linux 6.18.1-arch1-Watanare-T2-1-t2
  • WM: Hyprland 0.53.3 (Wayland)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions