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

> deb, rpm, AUR, Flatpak или AppImage: команда для вашей системы

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="ru" />

    Откройте терминал в папке с файлом и выполните:

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

    Так же ставится на Linux Mint и Pop!\_OS.
  </Tab>

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

    Откройте терминал в папке с файлом и выполните:

    <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">
    Для Arch, Manjaro и EndeavourOS:

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

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

    Ставьте только `soundcloud-bin`. Пакет `soundcloud-desktop-bin` делает другой человек, он обновляется позже.
  </Tab>

  <Tab title="Flatpak">
    Для любого дистрибутива, только x86\_64:

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

    Запуск: **SoundCloud Desktop** в меню приложений или команда:

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

    Это репозиторий проекта, не Flathub. Обновления ставит `flatpak update` и центр приложений.
  </Tab>

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

    Откройте терминал в папке с файлом и выполните:

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

    <Tip>
      AppImage тормозит или окно белое? Поставьте Flatpak.
    </Tip>
  </Tab>
</Tabs>

<Steps>
  <Step title="Запустите приложение">
    Из меню приложений или командой `soundcloud-desktop`. Flatpak и AppImage: командой из своей вкладки.
  </Step>

  <Step title="Войдите">
    Нажмите **Войти через SoundCloud** и разрешите доступ в браузере. [Подробнее про вход](/account/sign-in)
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="ARM: Raspberry Pi и другие платы">
    <div className="flex flex-wrap gap-x-6">
      <Download file="deb-arm" lang="ru" />

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

      <Download file="appimage-arm" lang="ru" />
    </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>

    AUR `soundcloud-bin` есть и для aarch64. Flatpak для ARM нет. Окно помещается на экран 800x480.
  </Accordion>

  <Accordion title="Steam Deck, Bazzite и другие неизменяемые системы">
    Ставьте Flatpak. Окно белое: [Linux: белое или пустое окно](/fix/linux-window).
  </Accordion>

  <Accordion title="Скачать .flatpak файлом">
    <Download file="flatpak" lang="ru" />

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

    Команда подключит тот же репозиторий проекта.
  </Accordion>

  <Accordion title="Нет значка в трее">
    Без значка в трее закрытие окна завершает приложение. [Подробнее](/fix/wont-close#linux-tray)
  </Accordion>
</AccordionGroup>

## Не получилось?

<Columns cols={2}>
  <Card title="Белое или пустое окно" icon="window-maximize" href="/fix/linux-window" horizontal />

  <Card title="Тормозит" icon="gauge-high" href="/fix/performance#linux" horizontal />
</Columns>


## Related topics

- [Linux: белое или пустое окно](/fix/linux-window.md)
- [Установка на Windows](/install/windows.md)
- [Установка на macOS](/install/macos.md)
- [Горячие клавиши и медиа-клавиши](/use/hotkeys.md)
- [Тормозит, грузит видеокарту, падает FPS в играх](/fix/performance.md)


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