> ## 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.

# Uninstall or reinstall clean

> How to remove the app and all its data on Windows, macOS and Linux

<Tabs>
  <Tab title="Windows" icon="windows" iconType="brands">
    <Steps>
      <Step title="Turn off autostart">
        If you had it on: **Settings -> General -> Startup -> Launch at login**.
      </Step>

      <Step title="Uninstall the app">
        Open the Windows **Settings -> Apps**, find **soundcloud-desktop** and click **Uninstall**.
      </Step>

      <Step title="Decide what happens to your data">
        The uninstaller window has a checkbox **Delete the application data**. Tick it and your settings, sign-in and downloaded tracks are deleted. Leave it empty and everything stays for a reinstall.
      </Step>
    </Steps>

    **MSI**: skip step 3, there is no checkbox. Delete the [folders](#folders) by hand.

    **Portable**: click **^** next to the clock, right-click the icon and choose **Quit** ([if it did not quit](/en/fix/wont-close)). Delete the file `soundcloud-desktop-portable.exe`, then the [folders](#folders).
  </Tab>

  <Tab title="macOS" icon="apple" iconType="brands">
    1. Press **Cmd+Q**.
    2. Drag **soundcloud-desktop** from the **Applications** folder to the Trash.

    The [data folders](#folders) stay, delete them by hand.
  </Tab>

  <Tab title="Linux" icon="linux" iconType="brands">
    <CodeGroup>
      ```bash Ubuntu, Debian theme={null}
      sudo apt remove soundcloud-desktop
      ```

      ```bash Fedora, openSUSE theme={null}
      # Fedora
      sudo dnf remove soundcloud-desktop
      # openSUSE
      sudo zypper remove soundcloud-desktop
      ```

      ```bash Arch theme={null}
      sudo pacman -Rns soundcloud-bin
      ```

      ```bash Flatpak theme={null}
      flatpak uninstall --delete-data io.github.zxcloli666.SoundcloudDesktop
      ```
    </CodeGroup>

    AppImage: delete the file.

    The [data folders](#folders) stay, delete them by hand. Flatpak with `--delete-data` removes them itself.
  </Tab>
</Tabs>

<h2 id="folders">
  What stays after uninstall
</h2>

<Tabs>
  <Tab title="Windows" icon="windows" iconType="brands">
    ```text Settings and sign-in theme={null}
    %APPDATA%\com.soundcloud.desktop
    ```

    ```text Cache and downloaded tracks theme={null}
    %LOCALAPPDATA%\com.soundcloud.desktop
    ```

    To open a folder, press **Win+R**, paste the path and press **Enter**.
  </Tab>

  <Tab title="macOS" icon="apple" iconType="brands">
    ```text Settings and sign-in theme={null}
    ~/Library/Application Support/com.soundcloud.desktop
    ```

    ```text Cache and downloaded tracks theme={null}
    ~/Library/Caches/com.soundcloud.desktop
    ```

    ```text Log theme={null}
    ~/Library/Logs/com.soundcloud.desktop
    ```
  </Tab>

  <Tab title="Linux" icon="linux" iconType="brands">
    ```text Settings and sign-in theme={null}
    ~/.local/share/com.soundcloud.desktop
    ```

    ```text Cache and downloaded tracks theme={null}
    ~/.cache/com.soundcloud.desktop
    ```

    ```text Flatpak theme={null}
    ~/.var/app/io.github.zxcloli666.SoundcloudDesktop/
    ```
  </Tab>
</Tabs>

<Warning>
  Deleting these folders removes your downloaded tracks and signs you out. Likes and playlists live in your account and stay.
</Warning>

<h2 id="clean">
  Reinstall clean
</h2>

If the app hangs at launch or after an update.

<Steps>
  <Step title="Quit the app">
    <Tabs>
      <Tab title="Windows" icon="windows">
        1. Click **^** next to the clock.
        2. Right-click the SoundCloud Desktop icon.
        3. Choose **Quit**.

        The menu is in English whatever the app language is. Still running: **Task Manager** (Ctrl+Shift+Esc) -> `soundcloud-desktop.exe` (portable: `soundcloud-desktop-portable.exe`) -> **End task**.
      </Tab>

      <Tab title="macOS" icon="apple">
        Press **Cmd+Q**. No window: menu bar icon -> **Quit**.
      </Tab>

      <Tab title="Linux" icon="linux">
        Open the tray icon menu -> **Quit**. No icon: close the window, the app exits.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Delete the folders">
    All the [data folders](#folders). On Windows with the installer it is easier: uninstall the app with **Delete the application data** ticked.
  </Step>

  <Step title="Install the latest version">
    Download and install it again: [which file](/en/install/download).
  </Step>

  <Step title="Sign in">
    Click **Sign in with SoundCloud** and allow access in the browser.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Reset only the settings">
    Quit the app, delete the file `sc-settings.json` in the [settings folder](#folders) and start the app again.
  </Accordion>

  <Accordion title="It hangs as soon as I play a track">
    Click **Settings -> Storage -> Cache -> Audio -> Clear**. If the app does not respond, quit it and delete only the `audio` folder in the [cache folder](#folders).
  </Accordion>

  <Accordion title="My cache was on another drive">
    If you changed **Settings -> Storage -> Cache location**, the tracks are in a folder named **SoundCloud Desktop** inside the folder you picked. Delete it by hand.
  </Accordion>

  <Accordion title="Should I remove WebView2 too?">
    No. Uninstalling the app does not touch it, and you do not need to remove it.
  </Accordion>
</AccordionGroup>


## Related topics

- [Update the app](/en/install/update.md)
- [Forks and builds from strangers](/en/about/forks.md)
- ["Session Interrupted" or "Session expired"](/en/fix/session-expired.md)
- [Sign-in stuck on "Waiting for authorization"](/en/fix/sign-in.md)
- [Won't close, or the old version opens](/en/fix/wont-close.md)


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