> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soundcloud-desktop.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux: white or blank window

> The window is white, blank or black, Failed to create GBM buffer

<Steps>
  <Step title="Quit every copy and update">
    Tray icon menu -> **Quit**. No icon: close the window. The window will not close:

    <CodeGroup>
      ```bash deb, rpm, AUR theme={null}
      pkill -f soundcloud-desktop
      ```

      ```bash AppImage theme={null}
      pkill -f soundcloud-desktop
      ```

      ```bash Flatpak theme={null}
      flatpak kill io.github.zxcloli666.SoundcloudDesktop
      ```
    </CodeGroup>

    Then update the app: [how to update](/en/install/update).
  </Step>

  <Step title="Start once with safe rendering">
    <CodeGroup>
      ```bash deb, rpm, AUR theme={null}
      soundcloud-desktop --safe-render
      ```

      ```bash AppImage theme={null}
      chmod +x soundcloud-desktop_*.AppImage && ./soundcloud-desktop_*.AppImage --safe-render
      ```

      ```bash Flatpak theme={null}
      flatpak run io.github.zxcloli666.SoundcloudDesktop --safe-render
      ```
    </CodeGroup>

    Flatpak: you can also right-click the app icon -> **Safe render mode**.
  </Step>

  <Step title="The window appeared: make it permanent">
    Not signed in yet? Click **Continue without signing in**: Settings open without signing in.

    Turn on **Settings -> Appearance -> Performance -> Software rendering** and click **Restart now**.

    Then choose **Light** in the same section: without the GPU, the CPU has to draw the effects. Windows and Linux only.
  </Step>

  <Step title="Using the AppImage? Switch to Flatpak">
    Flatpak brings everything it needs. It exists for x64 only. [Install on Linux](/en/install/linux)
  </Step>

  <Step title="deb, rpm, AUR: check WebKitGTK 4.1">
    Arch:

    ```bash theme={null}
    sudo pacman -S --needed webkit2gtk-4.1
    ```

    Another distribution without WebKitGTK 4.1: use Flatpak.
  </Step>

  <Step title="Start from a terminal and save the output">
    <CodeGroup>
      ```bash deb, rpm, AUR theme={null}
      soundcloud-desktop 2>&1 | tee ~/soundcloud-output.txt
      ```

      ```bash AppImage theme={null}
      ./soundcloud-desktop_*.AppImage 2>&1 | tee ~/soundcloud-output.txt
      ```

      ```bash Flatpak theme={null}
      flatpak run io.github.zxcloli666.SoundcloudDesktop 2>&1 | tee ~/soundcloud-output.txt
      ```
    </CodeGroup>

    Send the file `~/soundcloud-output.txt`, your distribution, X11 or Wayland, and your graphics card:

    ```bash theme={null}
    echo $XDG_SESSION_TYPE
    lspci | grep -i -E 'vga|3d'
    ```
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="&#x22;Failed to create GBM buffer&#x22;" icon="triangle-exclamation">
    Steps 2 and 3.
  </Accordion>

  <Accordion title=".deb crashes right after start" icon="box">
    Install with `apt`, not with `dpkg -i`. Then step 6.

    ```bash theme={null}
    sudo apt install ./soundcloud-desktop_*_amd64.deb
    ```
  </Accordion>

  <Accordion title="Lag on Wayland or NVIDIA" icon="gauge-high">
    [What to do](/en/fix/performance#linux)
  </Accordion>

  <Accordion title="Broke after custom CSS" icon="paintbrush">
    Press **Ctrl+Alt+Shift+C**. Or quit the app and start it with `--no-custom-css`.
  </Accordion>
</AccordionGroup>

<Card title="Still broken? Write to us" icon="life-ring" href="/en/help/contact" horizontal>
  Attach desktop.log and the Network check report.
</Card>


## Related topics

- [Install on Linux](/en/install/linux.md)
- [Where is desktop.log](/en/help/logs.md)
- [White screen on Windows](/en/fix/white-screen.md)
- [Black screen or "Something went wrong"](/en/fix/black-screen.md)
- [Install on Windows](/en/install/windows.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.