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

# Install on Linux

> deb, rpm, AUR, Flatpak or AppImage: the command for your system

export const Download = ({file = "windows", lang = "ru"}) => {
  const mirror = "https://images.scnative.dev/x-target/";
  const desktop = "zxcloli666/SoundCloud-Desktop";
  const android = "okeydw/SoundCloud-Android";
  const site = lang === "en" ? "https://getsoundcloud.app/download?lang=en" : "https://getsoundcloud.app/download";
  const files = {
    "windows": {
      repo: desktop,
      match: /x64-setup\.exe$/i,
      ru: "Скачать для Windows",
      en: "Download for Windows",
      arch: "x64"
    },
    "windows-msi": {
      repo: desktop,
      match: /\.msi$/i,
      ru: "Скачать MSI",
      en: "Download MSI",
      arch: "x64"
    },
    "windows-portable": {
      repo: desktop,
      match: /portable\.exe$/i,
      ru: "Скачать portable",
      en: "Download portable",
      arch: "x64"
    },
    "mac-arm": {
      repo: desktop,
      match: /aarch64\.dmg$/i,
      ru: "Скачать для Apple Silicon",
      en: "Download for Apple Silicon",
      arch: "M1-M4"
    },
    "mac-intel": {
      repo: desktop,
      match: /x64\.dmg$/i,
      ru: "Скачать для Intel Mac",
      en: "Download for Intel Mac",
      arch: "Intel"
    },
    "deb": {
      repo: desktop,
      match: /amd64\.deb$/i,
      ru: "Скачать .deb",
      en: "Download .deb",
      arch: "x64"
    },
    "deb-arm": {
      repo: desktop,
      match: /arm64\.deb$/i,
      ru: "Скачать .deb",
      en: "Download .deb",
      arch: "ARM64"
    },
    "rpm": {
      repo: desktop,
      match: /x86_64\.rpm$/i,
      ru: "Скачать .rpm",
      en: "Download .rpm",
      arch: "x64"
    },
    "rpm-arm": {
      repo: desktop,
      match: /aarch64\.rpm$/i,
      ru: "Скачать .rpm",
      en: "Download .rpm",
      arch: "ARM64"
    },
    "appimage": {
      repo: desktop,
      match: /amd64\.appimage$/i,
      ru: "Скачать AppImage",
      en: "Download AppImage",
      arch: "x64"
    },
    "appimage-arm": {
      repo: desktop,
      match: /aarch64\.appimage$/i,
      ru: "Скачать AppImage",
      en: "Download AppImage",
      arch: "ARM64"
    },
    "flatpak": {
      repo: desktop,
      match: /\.flatpak$/i,
      ru: "Скачать .flatpak",
      en: "Download .flatpak",
      arch: "x64"
    },
    "android-full": {
      repo: android,
      match: /full.*\.apk$/i,
      ru: "Скачать APK",
      en: "Download APK",
      arch: "Full"
    },
    "android-lite": {
      repo: android,
      match: /lite.*\.apk$/i,
      ru: "Скачать APK",
      en: "Download APK",
      arch: "Lite"
    }
  };
  const target = files[file] || files.windows;
  const api = `https://api.github.com/repos/${target.repo}/releases/latest`;
  const cacheKey = `scd-latest:${target.repo}`;
  const [asset, setAsset] = useState(null);
  const loadRelease = async () => {
    try {
      const cached = JSON.parse(sessionStorage.getItem(cacheKey) || "null");
      if (cached && Date.now() - cached.at < 600000) return cached.release;
    } catch (e) {}
    let response = await fetch(api).catch(() => null);
    if (!response || !response.ok) {
      response = await fetch(mirror, {
        headers: {
          "X-Target": btoa(api)
        }
      });
    }
    const release = await response.json();
    try {
      sessionStorage.setItem(cacheKey, JSON.stringify({
        at: Date.now(),
        release
      }));
    } catch (e) {}
    return release;
  };
  useEffect(() => {
    loadRelease().then(release => {
      const found = release.assets.find(a => target.match.test(a.name));
      if (found) setAsset({
        ...found,
        version: release.tag_name
      });
    }).catch(() => {});
  }, [file]);
  const megabytes = asset ? Math.max(1, Math.round(asset.size / 1048576)) : null;
  const details = asset ? `${target.arch} · ${megabytes} ${lang === "en" ? "MB" : "МБ"} · ${asset.version.replace(/^v/, "")}` : target.arch;
  return <div className="not-prose flex flex-wrap items-center gap-x-4 gap-y-2 my-4">
      <a href={asset ? mirror + btoa(asset.browser_download_url) : site} className="inline-flex items-center gap-3 rounded-xl px-5 py-3 text-white no-underline hover:-translate-y-0.5 transition-transform" style={{
    background: "linear-gradient(135deg, #C24100 0%, #DD4A00 100%)",
    boxShadow: "0 6px 24px rgba(255,85,0,0.25)"
  }}>
        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
          <path d="M12 3v12" />
          <path d="m7 10 5 5 5-5" />
          <path d="M5 21h14" />
        </svg>
        <span className="flex flex-col leading-tight">
          <span className="font-semibold text-base">{target[lang] || target.ru}</span>
          <span className="text-xs opacity-90">{details}</span>
        </span>
      </a>
      {asset && <a href={asset.browser_download_url} className="text-sm opacity-70 hover:opacity-100 no-underline">
          {lang === "en" ? "or from GitHub" : "или с GitHub"}
        </a>}
    </div>;
};

<Tabs>
  <Tab title="Ubuntu, Debian">
    <Download file="deb" lang="en" />

    Open a terminal in the folder with the file and run:

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

    Linux Mint and Pop!\_OS install the same way.
  </Tab>

  <Tab title="Fedora, openSUSE">
    <Download file="rpm" lang="en" />

    Open a terminal in the folder with the file and run:

    <CodeGroup>
      ```bash Fedora theme={null}
      sudo dnf install ./soundcloud-desktop-*.x86_64.rpm
      ```

      ```bash openSUSE theme={null}
      sudo zypper install ./soundcloud-desktop-*.x86_64.rpm
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Arch">
    For Arch, Manjaro and EndeavourOS:

    <CodeGroup>
      ```bash yay theme={null}
      yay -S soundcloud-bin
      ```

      ```bash paru theme={null}
      paru -S soundcloud-bin
      ```
    </CodeGroup>

    Install only `soundcloud-bin`. The `soundcloud-desktop-bin` package is made by someone else and gets updates later.
  </Tab>

  <Tab title="Flatpak">
    For any distribution, x86\_64 only:

    ```bash theme={null}
    flatpak install --user https://zxcloli666.github.io/SoundCloud-Desktop/flatpak/soundcloud-desktop.flatpakref
    ```

    Start it from **SoundCloud Desktop** in the app menu or with the command:

    ```bash theme={null}
    flatpak run io.github.zxcloli666.SoundcloudDesktop
    ```

    This is the project's own repository, not Flathub. Updates come through `flatpak update` and the app center.
  </Tab>

  <Tab title="AppImage">
    <Download file="appimage" lang="en" />

    Open a terminal in the folder with the file and run:

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

    <Tip>
      AppImage is slow or the window is white? Install the Flatpak.
    </Tip>
  </Tab>
</Tabs>

<Steps>
  <Step title="Start the app">
    From the app menu or with `soundcloud-desktop`. Flatpak and AppImage: with the command in their own tab.
  </Step>

  <Step title="Sign in">
    Click **Sign in with SoundCloud** and allow access in the browser. [More about signing in](/en/account/sign-in)
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="ARM: Raspberry Pi and other boards">
    <div className="flex flex-wrap gap-x-6">
      <Download file="deb-arm" lang="en" />

      <Download file="rpm-arm" lang="en" />

      <Download file="appimage-arm" lang="en" />
    </div>

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

      ```bash rpm theme={null}
      sudo dnf install ./soundcloud-desktop-*.aarch64.rpm
      ```

      ```bash AppImage theme={null}
      chmod +x soundcloud-desktop_*_aarch64.AppImage
      ./soundcloud-desktop_*_aarch64.AppImage
      ```
    </CodeGroup>

    The AUR package `soundcloud-bin` is built for aarch64 too. There is no Flatpak for ARM. The window fits an 800x480 screen.
  </Accordion>

  <Accordion title="Steam Deck, Bazzite and other immutable systems">
    Install the Flatpak. Window is white: [Linux: white or blank window](/en/fix/linux-window).
  </Accordion>

  <Accordion title="Download the .flatpak file">
    <Download file="flatpak" lang="en" />

    ```bash theme={null}
    flatpak install --user soundcloud-desktop.flatpak
    ```

    The command adds the same project repository.
  </Accordion>

  <Accordion title="No tray icon">
    Without a tray icon, closing the window quits the app. [More](/en/fix/wont-close#linux-tray)
  </Accordion>
</AccordionGroup>

## Didn't work?

<Columns cols={2}>
  <Card title="White or blank window" icon="window-maximize" href="/en/fix/linux-window" horizontal />

  <Card title="Laggy" icon="gauge-high" href="/en/fix/performance#linux" horizontal />
</Columns>


## Related topics

- [Linux: white or blank window](/en/fix/linux-window.md)
- [iPhone app](/en/install/ios.md)
- [Update the app](/en/install/update.md)
- [Install on Windows](/en/install/windows.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.