From 1279617197e47ae3b09f3e852c4b1407bdc6318d Mon Sep 17 00:00:00 2001 From: seaxwi <71350948+seaxwi@users.noreply.github.com> Date: Tue, 16 Dec 2025 09:39:02 +0100 Subject: [PATCH 1/3] Create If-App-Lab-does-not-open.md --- .../If-App-Lab-does-not-open.md | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md diff --git a/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md b/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md new file mode 100644 index 00000000..f36627e1 --- /dev/null +++ b/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md @@ -0,0 +1,60 @@ +--- +title: "If App Lab does not open on Linux" +--- + +If you’re running App Lab on Linux, the application will not be able to launch if the WebKit2 library is not installed. Learn how to install the library and diagnose other potential issues. + +--- + +In this article: + + + +- [Make sure the WebKit2 library is installed](#make-sure-the-webkit2-library-is-installed) +- [Try launching App Lab in Terminal](#try-launching-app-lab-in-terminal) + + + +## Make sure the WebKit2 library is installed + +If you’re running App Lab on Linux, the application will not be able to launch if an appropriate version of the **WebKitGTK** library is missing. + +Resolve the issue by installing the library: + +1. Open Terminal from the main application menu, or press Ctrl + Alt + T. + +1. Type the following command: + + - **Ubuntu/Debian/Mint:** `sudo apt install libwebkit2gtk-4.1-0` + - **Arch:** `sudo pacman -S webkit2gtk-4.1` + +1. Press Enter. + +1. Try launching App Lab again. + +If the library was already installed, check for other errors by [launching App Lab in Terminal](#try-launching-app-lab-in-terminal). + + +## Launch App Lab in Terminal + +If App Lab still isn't launching, you can try opening the application from Terminal, to reveal error output not visible when launching the application normally. + +Follow these steps: + +1. Open Terminal from the main application menu, or press Ctrl + Alt + T. + +1. Navigate to the directory containing Arduino App Lab. A quick way to do this is by typing `cd`and a space, and then drag and drop the file's folder directly onto the Terminal window. The path will appear automatically. Press Enter to confirm. + +1. Type `./arduino-app-lab` and press Enter. + +1. Observe the Terminal output. + + * If you see this error, you are still missing the WebKitGTK library. + + ``` + ./arduino-app-lab: error while loading shared libraries: libwebkit2gtk-4.1.so.0: cannot open shared object file: No such file or directory + ``` + + Follow the steps in [Make sure the WebKit2 library is installed](#make-sure-the-webkit2-library-is-installed). + + * For other issues, try seraching the Arduino Help Center or [contacting Arduino Support](https://www.arduino.cc/en/contact-us/). From f4d179685597966ad3e3d10ea10b759b6d2b3208 Mon Sep 17 00:00:00 2001 From: seaxwi <71350948+seaxwi@users.noreply.github.com> Date: Tue, 16 Dec 2025 09:48:23 +0100 Subject: [PATCH 2/3] fix linter errors --- .../Arduino App Lab/If-App-Lab-does-not-open.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md b/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md index f36627e1..30b51e22 100644 --- a/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md +++ b/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md @@ -11,7 +11,7 @@ In this article: - [Make sure the WebKit2 library is installed](#make-sure-the-webkit2-library-is-installed) -- [Try launching App Lab in Terminal](#try-launching-app-lab-in-terminal) +- [Launch App Lab in Terminal](#launch-app-lab-in-terminal) @@ -34,7 +34,6 @@ Resolve the issue by installing the library: If the library was already installed, check for other errors by [launching App Lab in Terminal](#try-launching-app-lab-in-terminal). - ## Launch App Lab in Terminal If App Lab still isn't launching, you can try opening the application from Terminal, to reveal error output not visible when launching the application normally. @@ -49,7 +48,7 @@ Follow these steps: 1. Observe the Terminal output. - * If you see this error, you are still missing the WebKitGTK library. + - If you see this error, you are still missing the WebKitGTK library. ``` ./arduino-app-lab: error while loading shared libraries: libwebkit2gtk-4.1.so.0: cannot open shared object file: No such file or directory @@ -57,4 +56,4 @@ Follow these steps: Follow the steps in [Make sure the WebKit2 library is installed](#make-sure-the-webkit2-library-is-installed). - * For other issues, try seraching the Arduino Help Center or [contacting Arduino Support](https://www.arduino.cc/en/contact-us/). + - For other issues, try seraching the Arduino Help Center or [contacting Arduino Support](https://www.arduino.cc/en/contact-us/). From 3d56e32ee2f557674408ac2b392be903fad02f69 Mon Sep 17 00:00:00 2001 From: seaxwi <71350948+seaxwi@users.noreply.github.com> Date: Tue, 16 Dec 2025 10:13:22 +0100 Subject: [PATCH 3/3] Update filename to match title --- ...-Lab-does-not-open.md => If-App-Lab-does-not-open-on-Linux.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename content/Software Support/Arduino App Lab/{If-App-Lab-does-not-open.md => If-App-Lab-does-not-open-on-Linux.md} (100%) diff --git a/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md b/content/Software Support/Arduino App Lab/If-App-Lab-does-not-open-on-Linux.md similarity index 100% rename from content/Software Support/Arduino App Lab/If-App-Lab-does-not-open.md rename to content/Software Support/Arduino App Lab/If-App-Lab-does-not-open-on-Linux.md