Skip to content

fix: #158 - Add missing linux dependency documentation and better DLOpen error messaging#159

Open
bxrne wants to merge 1 commit intoblackboardsh:mainfrom
bxrne:main
Open

fix: #158 - Add missing linux dependency documentation and better DLOpen error messaging#159
bxrne wants to merge 1 commit intoblackboardsh:mainfrom
bxrne:main

Conversation

@bxrne
Copy link

@bxrne bxrne commented Feb 18, 2026

Summary

Fixes first-run failures on Arch Linux caused by missing GTK/WebKit runtime libraries by:

  • Documenting Linux runtime dependencies in README.md.
  • Printing a clearer launcher error when common Linux libraries are missing.

On Arch Linux, launching the multi-tab browser template failed with missing shared library errors. The launcher error was opaque (ERR_DLOPEN_FAILED). These dependencies are hard runtime requirements for the Linux native wrapper and should be documented and surfaced clearly at runtime.

Changes

  • Added a Linux Runtime Dependencies section to README.md with Arch and Ubuntu/Debian package commands.
  • Updated the launcher to detect common missing libraries (libwebkit2gtk-4.1, libgtk-3, libayatana-appindicator) and print install instructions.

Reproduction

See #158

Related Issue

@bxrne bxrne changed the title Bug #158: Add missing linux dependency documentation and better DLOpen error messaging fix: #158 - Add missing linux dependency documentation and better DLOpen error messaging Feb 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant