# Troubleshooting

### macOS

When installing the app on macOS, if you see this kind of message:

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-18f79045c0fc64a017ac6550d5c38967e3361bb2%2FXnapper-2024-01-24-12.27.54.png?alt=media" alt="" width="375"><figcaption><p>“SEO Utils” can’t be opened because Apple cannot check it for malicious software.</p></figcaption></figure>

1. Please open the **System Settings**
2. Go to the **Privacy & Security** menu
3. Hit the **Open Anyway** button

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-02267046d00e83293035dd8bcae68a1220078a0e%2FCleanShot%202024-01-24%20at%2012.31.18%402x.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

If you cannot upgrade the app, please move the SEO Utils app to the **Applications** folder

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-87f8be67e54768e8842650645dd58bd440a43ee2%2F471607863_8910071832395299_4952853912844482308_n.jpg?alt=media" alt="" width="563"><figcaption><p>Move the SEO Utils app to the Applications to folder</p></figcaption></figure>

And please make sure you allow SEO Utils to access your Downloads folder.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-a4b16d4d6199bef135885ff7fe867d6ea3505c22%2FCleanShot%202024-05-06%20at%2012.13.03%402x.png?alt=media" alt="" width="375"><figcaption><p>Allows SEO Utils to access the Downloads folder in macOS</p></figcaption></figure>

### Windows

If you encounter a permission error or the program exits when clustering keywords on Windows, please ensure that you run SEO Utils as an administrator. This will allow the app to write the cluster data into a CSV file on your machine.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-8da8f6e83dc8eb482241412a27b9a053661e2a17%2F53db0b2010303a3571c40e969cd8623b.png?alt=media" alt=""><figcaption><p>Permission denied</p></figcaption></figure>

You can do that by right-clicking on the SEO Utils shortcode, going to the **Compatibility** tab, and selecting "**Run this program as an administrator**." So, each time you run it, it will always run as an administrator.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-0c8e6f5693bb71715ec8447d17fb5ce57d23e4ed%2Fimage-1.png?alt=media" alt=""><figcaption><p>Run "SEO Utils" as an administrator</p></figcaption></figure>

### Linux

If you can't open the app and see an alert like this.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-8f89b084909f4e7fbf90308efbf7771568125f69%2FCleanShot%202024-08-06%20at%2010.51.50%402x.png?alt=media" alt="" width="563"><figcaption><p>Cannot open the app in Linux</p></figcaption></figure>

Right-click on the app > **Properties** > **Permissions** > Check "**Allow executing file as program"**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-3292820565a8bc793543acb5274179a7c13ea87f%2FXnapper-2024-08-06-11.15.47.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

***

If you're running Ubuntu 24.04 (or similar distro) and the app doesn't launch, try running it from the terminal. If you see this error:

```
./SEO Utils: error while loading shared libraries: libwebkit2gtk-4.0.so.37: cannot open shared object file: No such file or directory
```

This happens because Ubuntu 24.04 ships with WebKitGTK 4.1 instead of 4.0. The `libwebkit2gtk-4.0-dev` package is not available in the default repositories for this distro version.

**Solution:** Create symbolic links to alias version 4.1 to version 4.0:

```bash
sudo ln -sf /usr/lib/x86_64-linux-gnu/libwebkit2gtk-4.1.so.0 /usr/lib/x86_64-linux-gnu/libwebkit2gtk-4.0.so.37
sudo ln -sf /usr/lib/x86_64-linux-gnu/libjavascriptcoregtk-4.1.so.0 /usr/lib/x86_64-linux-gnu/libjavascriptcoregtk-4.0.so.18
```

Credit: [BambuStudio GitHub Issue #3973](https://github.com/bambulab/BambuStudio/issues/3973#issuecomment-2097651206)

***

If the app crashes with an error like:

```
Overriding existing handler for signal 10. Set JSC_SIGNAL_FOR_GC if you want WebKit to use a different signal
...
fatal error: non-Go code set up signal handler without SA_ONSTACK flag
```

This is a signal handling conflict between Go and WebKit's JavaScript garbage collector.

**Solution:** Set an environment variable before launching the app:

```bash
export JSC_SIGNAL_FOR_GC=SIGUSR2
./SEO\ Utils
```

Or run it in one line:

```bash
JSC_SIGNAL_FOR_GC=SIGUSR2 ./SEO\ Utils
```

This tells WebKit to use a different signal that doesn't conflict with Go's runtime.