Error "libwebkitgtk-1.0-0 not found" on Linux

The libwebkitgtk-1.0-0 not found error can appear when you run client tools, like Spoon, on Linux (for example, Ubuntu 20.04 and later). The error occurs because some graphical components, such as the embedded browser in Spoon, depend on the libwebkitgtk-1.0-0 library.

Symptoms of the error include graphical components not opening because the internal web viewer component does not render well and the log showing errors that reference the libwebkitgtk-1.0-0 library. The libwebkitgtk-1.0-0 not found error occurs because the required library isn't available in the default Ubuntu repositories for Ubuntu 20.04 and later.

Note: If you use PDI command-line tools (Kitchen, Pan, or Carte), you can safely ignore the libwebkitgtk-1.0-0 not found error because it affects only the graphical user interface (Spoon).

To resolve the libwebkitgtk-1.0-0 not found error, add the legacy repository and install the libwebkitgtk-1.0-0 library:

1. Open the /etc/apt/sources.list file in a text editor with root permissions by running

   sudo vim /etc/apt/sources.list.

   Note: If vim isn't installed on your system, use another editor, or install vim by running sudo apt install vim.

2. Add the following lines to the sources.list file:

   # Add entry to repository that contains the old lib
   deb http://cz.archive.ubuntu.com/ubuntu bionic main universe
   
   # Alternative link if upper does not work
   #deb http://mirrors.kernel.org/ubuntu bionic main universe

3. Save the sources.list file.

4. Update the repository cache by running sudo apt-get update.

5. Install the libwebkitgtk-1.0-0 library by running sudo apt-get install libwebkitgtk-1.0-0 -y.

6. Restart Spoon by running restart spoon.sh.

If you encounter the following errors, see the instructions for resolving each error:

• "GPG error: repository not signed" error

• "Failed to load module canberra-gtk-module" error

"GPG error: repository not signed" error

After you add the bionic repository, the apt-get update might return a GPG key error that indicates the repository isn't signed. To resolve this issue, add the missing public key:

1. Add the public key to your keystore, by running the following command, replacing the example hex identifier (3B4FE6ACC0B21F32) with the hex identifier from your error message:

   sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32

2. Update the repository cache by running sudo apt-get update.

3. Install the libwebkitgtk-1.0-0 library by running sudo apt-get install libwebkitgtk-1.0-0 -y.

4. Restart Spoon by running restart spoon.sh.

"Failed to load module canberra-gtk-module" error

After you install the libwebkitgtk-1.0-0 library, you might see the Failed to load module canberra-gtk-module error. This error typically doesn't prevent PDI from running, but you can resolve it by installing the missing modules:

1. Install the missing modules by running

   sudo apt install libcanberra-gtk-module libcanberra-gtk3-module.

2. Restart Spoon by running restart spoon.sh.

Workarounds for error libwebkitgtk-1.0-0 not found

If you don't need the internal Welcome page or Marketplace browser, or if the previous solution doesn't resolve your issue, try one of the following alternatives.

Skip the browser

Configure Spoon to ignore the missing libwebkitgtk-1.0-0 library. The main ETL canvas works normally.

1. Open spoon.sh in a text editor.

2. Add the following flag to the PENTAHO_DI_JAVA_OPTIONS variable:

   "-Dorg.eclipse.swt.browser.DefaultType=mozilla"

3. Save the file.

4. Restart Spoon by running spoon.sh.

5. (Optional) If the error persists, replace the flag you added to the PENTAHO_DI_JAVA_OPTIONS variable in step 2 with:

   "-Dorg.eclipse.swt.browser.UseWebKitGTK=false"

6. Save the spoon.sh file.

7. Start Spoon by running spoon.sh.

8. Confirm that Spoon ignores the missing libwebkitgtk-1.0-0 library by checking the following results:

   1. The libwebkitgtk-1.0-0 not found error does not appear because the JVM no longer scans the system for the libwebkitgtk-1.0 library during startup.

   2. The Welcome screen is blank, containing an empty gray or white box instead of links or news. The empty box might display an error message.

   3. The Canvas is fully functional with drag-and-drop capabilities.

What to do next: You can click File > New > Transformation and start working.

Use WebKit2

Some SWT versions can communicate with webkit2gtk-4.x. You can set an environment variable to use the newer library version.

1. Open the spoon.sh file in a text editor.

2. Add the following line near the top of the spoon.sh file:

   export SW_GTK_LIB=webkit2

3. Save the spoon.sh file

4. Restart Spoon by running spoon.sh.