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

# Белый экран на Windows

> Белое окно, мигает и пропадает, WebView2 уже стоит. Все способы по порядку

export const body_0 = "Приложите версию Windows (Win+R, winver), какой файл ставили, было ли окно про WebView2, и desktop.log: он есть даже при белом окне."

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>;
};

<Steps>
  <Step title="Подождите 10-20 секунд, потом закройте полностью и запустите снова">
    1. Нажмите **^** у часов.
    2. Правой кнопкой нажмите на значок SoundCloud Desktop.
    3. Выберите **Quit** (меню трея на английском).

    Не закрылось или окна нет совсем: **Диспетчер задач** (Ctrl+Shift+Esc) -> снимите `soundcloud-desktop.exe` (portable: `soundcloud-desktop-portable.exe`) и `msedgewebview2.exe`.
  </Step>

  <Step title="Перезагрузите компьютер">
    Потом запустите SoundCloud Desktop.
  </Step>

  <Step title="Стоит portable? Поставьте установщик">
    Он сам ставит WebView2.

    <Download file="windows" lang="ru" />
  </Step>

  <Step title="Поставьте WebView2 от Microsoft, даже если Windows пишет, что он есть">
    1. Откройте [страницу WebView2 на сайте Microsoft](https://developer.microsoft.com/microsoft-edge/webview2/).
    2. Скачайте **Evergreen Standalone Installer**, версия **x64**.
    3. Правой кнопкой нажмите на файл -> **Запуск от имени администратора**.
    4. Перезагрузите компьютер.

    Edge для этого не нужен.
  </Step>

  <Step title="Всё ещё белое: удалите WebView2 и поставьте заново">
    Откройте **Параметры -> Приложения**, удалите **Microsoft Edge WebView2 Runtime**, перезагрузите компьютер и повторите шаг 4. Нет в списке: пропустите шаг.
  </Step>

  <Step title="Установщик пишет, что WebView2 уже установлен">
    <Warning>
      Сначала сохраните реестр: **Win+R**, `regedit`, **Файл -> Экспорт**.
    </Warning>

    Удалите в `regedit` три ключа. Какого ключа нет - пропустите.

    ```text theme={null}
    HKLM\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
    HKLM\SOFTWARE\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
    HKCU\Software\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
    ```

    Потом запустите установщик WebView2 от имени администратора ещё раз и перезагрузите компьютер.
  </Step>

  <Step title="Выключите VPN, прокси в режиме TUN, AdGuard и веб-защиту антивируса">
    Запустите приложение. Заработало: добавьте `soundcloud-desktop.exe` и `msedgewebview2.exe` в исключения этой программы и включите её обратно.
  </Step>

  <Step title="Включите программный рендеринг">
    Видите экран входа? Нажмите **Продолжить без входа**: Настройки откроются и без входа.

    Включите **Настройки -> Оформление -> Производительность -> Программный рендеринг** и нажмите **Перезапустить**.

    Потом выберите **Лайт** в том же разделе: без видеокарты эффекты считает процессор. Только Windows и Linux.

    Обновите драйвер видеокарты. Окно совсем пустое: шаг 10.
  </Step>

  <Step title="Сбросьте данные приложения">
    Скачанные треки удалятся, войти придётся заново.

    1. Закройте приложение полностью, как в шаге 1.
    2. Вставьте `%LOCALAPPDATA%` в адресную строку **Проводника** и удалите папку `com.soundcloud.desktop`. То же для `%APPDATA%`. Или удалите приложение с галочкой **Delete the application data**.
    3. Поставьте приложение заново:

    <Download file="windows" lang="ru" />
  </Step>

  <Step title="Если ничего не помогло и окно не рисуется совсем" id="render-file">
    1. Закройте приложение полностью, как в шаге 1.

    2. Нажмите **Win+R**, введите `cmd`, нажмите **Enter**.

    3. Вставьте команду и нажмите **Enter**:

       ```bat theme={null}
       mkdir "%APPDATA%\com.soundcloud.desktop" 2>nul & echo {"softwareRendering":true}> "%APPDATA%\com.soundcloud.desktop\render_mode.json"
       ```

    4. Запустите приложение.

    Отменить: удалите файл `render_mode.json` из папки `%APPDATA%\com.soundcloud.desktop`.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Окно &#x22;Microsoft Edge WebView2 Runtime не найден или повреждён&#x22;" icon="triangle-exclamation" id="webview2">
    Это проверка самого приложения. Нажмите **Да**: откроется страница Microsoft. Дальше шаги 4-6.
  </Accordion>

  <Accordion title="Белое окно мелькает и пропадает, приложение висит в Диспетчере задач" icon="ghost">
    Завершите все `soundcloud-desktop.exe`: скрытая копия не даёт запустить новую. Потом шаги 3-6. На LTSC и урезанных сборках обычно не хватает WebView2.
  </Accordion>

  <Accordion title="Ошибка про .dll" icon="puzzle-piece">
    Нужен другой компонент Windows: [что поставить](/fix/windows-dll).
  </Accordion>
</AccordionGroup>

<Card title="Не помогло? Напишите нам" icon="life-ring" href="/help/contact" horizontal>
  {body_0}
</Card>


## Related topics

- [Установка на Windows](/install/windows.md)
- [Чёрный экран или "Что-то пошло не так"](/fix/black-screen.md)
- [Linux: белое или пустое окно](/fix/linux-window.md)
- [Не найден MSVCP140.dll или другой .dll](/fix/windows-dll.md)
- [SoundCloud Desktop](/index.md)


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