SoundCloud-Desktop

---

[soundcloud-desktop-8.5]

---

Что это?

SoundCloud Desktop — полноценное десктопное приложение для прослушивания музыки на SoundCloud. Написано на Tauri 2 + React 19 — работает нативно, потребляет минимум ресурсов и не тормозит.

Более 100 000 скачиваний. Работает на Windows, Linux и macOS.

---

Почему SoundCloud Desktop

Доступно в России

SoundCloud заблокирован Роскомнадзором — веб-версия не открывается. SoundCloud Desktop работает напрямую без каких-либо дополнительных программ. Весь каталог SoundCloud доступен полностью.

Никакой рекламы

Ноль рекламных баннеров, ноль промо-вставок между треками, ноль всплывающих окон «оформи подписку». Чистый интерфейс, только музыка.

Без капчи

Никаких бесконечных проверок «я не робот». Открыл — слушаешь.

Без цензуры

Доступ ко всему каталогу SoundCloud без региональных ограничений. Все треки, все артисты, все жанры.

Нативное и лёгкое

Построено на Tauri 2 (Rust) вместо Electron. Результат:

• Системный WebView вместо встроенного Chromium
• Мгновенный запуск
• Плавный интерфейс на 60 FPS даже на слабом железе

Полностью на русском

Интерфейс переведён на русский язык. Язык определяется автоматически по системе — ничего настраивать не нужно.

Системная интеграция

• Управление из системы — медиа-кнопки на клавиатуре, системный центр уведомлений (Windows), MPRIS (Linux)
• Discord Rich Presence — показывай друзьям, что слушаешь
• Трей — приложение работает в фоне
• Обновления из приложения — для установщика Windows, macOS и AppImage кнопка «Установить и перезапустить», для остальных сборок прямая ссылка на нужный файл

---

Скачать

Стоит zapret, а треки или обложки не грузятся? Добавьте scnative.dev и scnative.space в его lists/list-general-user.txt. Подробно: zapret, VPN и списки доменов.

Windows

Перейди на страницу релизов и скачай:

• *_x64-setup.exe - установщик, рекомендуется
• *_x64_en-US.msi - альтернативный установщик
• soundcloud-desktop-portable.exe - portable-версия, без установки

Требования: Windows 10 (1809+) или Windows 11

Нужен Microsoft Edge WebView2 Runtime. Установщики (~220 МБ) несут его внутри и ставят без загрузки из сети, такую загрузку антивирусы принимают за угрозу. Portable (~43 МБ) его не несёт: если WebView2 нет или Windows урезанная, поставь Evergreen Standalone Installer от имени администратора. Сам Edge не нужен.

Linux

Формат	Архитектура	Описание
.deb	amd64, arm64	Ubuntu, Debian, Mint, Pop!_OS
.rpm	amd64, arm64	Fedora, openSUSE, CentOS
.AppImage	amd64, arm64	Универсальный, работает везде
.flatpak	amd64	Песочница
AUR soundcloud-bin	amd64, arm64	Arch, Manjaro, EndeavourOS

Скачай нужный формат со страницы релизов или с сайта, если GitHub не открывается.

Arch и производные: официальный пакет soundcloud-bin публикуется в AUR автоматически через минуту после каждого релиза.

yay -S soundcloud-bin

Есть и пакет от сообщества soundcloud-desktop-bin, его ведёт не автор приложения. Ставь только один из двух.

Flatpak ставится из нашего репозитория, тогда обновления приходят через flatpak update и центр приложений (GNOME Software, Discover):

flatpak install --user https://zxcloli666.github.io/SoundCloud-Desktop/flatpak/soundcloud-desktop.flatpakref

Скачанный soundcloud-desktop.flatpak тоже подключает этот репозиторий при установке: flatpak install --user soundcloud-desktop.flatpak.

Для AppImage:

chmod +x soundcloud-desktop_*.AppImage
./soundcloud-desktop_*.AppImage

Белое или пустое окно при запуске: запусти с флагом --safe-render (во Flatpak это пункт "Безопасный режим отрисовки" / "Safe render mode" в меню ярлыка). Лог: ~/.local/share/com.soundcloud.desktop/logs/desktop.log, во Flatpak ~/.var/app/io.github.zxcloli666.SoundcloudDesktop/data/com.soundcloud.desktop/logs/desktop.log.

macOS

• Apple Silicon (M1/M2/M3/M4): *_aarch64.dmg
• Intel: *_x64.dmg

Скачай со страницы релизов.

[!NOTE] macOS блокирует запуск? Приложение не подписано Apple Developer сертификатом, поэтому Gatekeeper может показать ошибку «приложение повреждено». Исправляется одной командой:

xattr -cr /Applications/soundcloud-desktop.app

После этого приложение запустится нормально.

---

zapret, VPN и списки доменов

Приложение ходит на свои домены в зоне scnative.dev (часть файлов треков пока приходит со старой scnative.space) и напрямую к SoundCloud за треками. Если провайдер режет прямой путь к нашим доменам, приложение само переключается на резервные маршруты *.relay.scnative.dev.

Треки или обложки не грузятся:

1. Откройте «Настройки → Сеть → Проверка сети». Там видно, что сломано, и есть кнопка «Скопировать отчёт».
2. zapret включён: выключите его и нажмите «Проверить снова».
3. Заработало: мешал zapret. Добавьте scnative.dev, scnative.space и getsoundcloud.app в lists/list-exclude-user.txt и включите zapret обратно.
4. Не заработало: режет провайдер. Добавьте scnative.dev и scnative.space в lists/list-general-user.txt, включите zapret и проверьте снова. Стало хуже — уберите строки.
5. Всё равно не работает или zapret нет: поможет только VPN.

Пути выше для Windows (winws, сборка Flowseal). После правки списков перезапустите zapret.

Подробности:

• Linux и macOS (nfqws, tpws): исключения лежат в /opt/zapret/ipset/zapret-hosts-user-exclude.txt (после правки sudo /opt/zapret/ipset/get_exclude.sh), список обхода в /opt/zapret/ipset/zapret-hosts-user.txt. У zapret2 папка /opt/zapret2.
• Шаг 3 при IPSet в режиме loaded или any: добавьте ещё адреса наших серверов в lists/ipset-exclude-user.txt (по одному на строку). Актуальные адреса показывает проверка сети: приложение берёт их из DNS, поэтому список не устаревает при смене серверов. Режим none наши адреса не трогает.
• Для стратегий с fooling=ts или tcp_ts включите TCP timestamps: netsh interface tcp set global timestamps=enabled от администратора.
• Если системный DNS выдаёт неверный адрес, приложение само спрашивает DoH (1.1.1.1, 8.8.8.8 и другие).
• Провайдер блокирует SoundCloud — добавьте soundcloud.com и sndcdn.com в list-general, иначе треки идут через сервер и грузятся дольше.

Каждая запись покрывает все поддомены: scnative.dev включает резервные маршруты, soundcloud.com включает api-v2.soundcloud.com.

Домен	Для чего
api.scnative.dev, api-star.scnative.dev	API
stream.scnative.dev, stream-star.scnative.dev	аудио
storage.scnative.dev, storage-star.scnative.dev, s3.scnative.dev	хранилище треков
images.scnative.dev	обложки
pay.scnative.dev	оплата STAR
health.scnative.dev, status.getsoundcloud.app	проверка связи
call-*.scnative.dev	«Сеть пользователей»
*.relay.scnative.dev	резервные маршруты
*.scnative.space	старая зона, с неё пока приходят файлы треков
soundcloud.com, api-v2.soundcloud.com, *.sndcdn.com	прямая загрузка трека с SoundCloud

---

Скриншоты

[home-screen]

[liked-tracks]

---

Обновление

Приложение само проверяет новые версии при запуске и раз в шесть часов. Проверить вручную и посмотреть свою версию можно в Настройки → Общее → Обновления.

Сборка	Как обновляется
Windows setup.exe / .msi, macOS .dmg, .AppImage	Кнопка «Установить и перезапустить», настройки и кэш сохраняются
Windows portable	Закрой приложение из трея (правый клик по иконке → «Выход») и замени exe скачанным
.deb / .rpm	Установи новый пакет поверх старого
AUR	yay -Syu soundcloud-bin
Flatpak	flatpak update или центр приложений. Если ставил старый .flatpak и обновлений не видно, один раз переустанови: flatpak install --user --reinstall soundcloud-desktop.flatpak с новым файлом (без --reinstall будет ошибка «Каталог не пуст»)
Сборка из исходников	git pull и пересборка

Если поставил новую версию, а открывается старая, значит старая ещё работает в трее: закрой её через «Выход» и запусти снова.

---

Логи

Если приложение вылетает или что-то не играет, приложите к баг-репорту файл desktop.log. В него пишут и интерфейс, и нативная часть, включая паники с трассировкой. Токены и session_id в ссылках скрываются. Когда файл больше 5 МБ, при запуске он переименовывается в desktop.old.log.

Папку открывает кнопка «Открыть папку» в Настройки → Общее → Диагностика. Пути:

ОС	Папка
Windows	%LOCALAPPDATA%\com.soundcloud.desktop\logs
macOS	~/Library/Logs/com.soundcloud.desktop
Linux	~/.local/share/com.soundcloud.desktop/logs

---

Обратная связь

Предложить идею	Обсуждение #121
Что значит ошибка?	Справка по ошибкам
Свой CSS	Как писать темы
Что-то не работает?	Обсуждение #144
Поставить звезду	GitHub Stars — помогает продвижению!
Поддержать донатом	Boosty — разово на любую сумму, или STAR в самом приложении

Pull requests приветствуются. Для крупных изменений сначала откройте issue.

---

Сборка из исходников

Требования

• Node.js 22+
• pnpm 10+
• Rust 1.77+ (stable)

Запуск

git clone https://github.com/zxcloli666/SoundCloud-Desktop.git
cd SoundCloud-Desktop/desktop
pnpm install
pnpm tauri dev

Production-сборка

pnpm tauri build

Артефакты появятся в src-tauri/target/release/bundle/.

Проверки

npx tsc --noEmit        # типы TypeScript
cargo check              # компиляция Rust
npx biome check src/     # линтинг

---

Стек

Компонент	Технология
Оболочка	Tauri 2 (Rust)
Фронтенд	React 19, Vite 7, Tailwind CSS 4
Стейт	Zustand, TanStack Query
Аудио	rodio (rust)
UI-компоненты	Radix UI
Бэкенд	NestJS 11, TypeORM, PostgreSQL
CI/CD	GitHub Actions — сборка под все платформы
Линтер	Biome

---

Статистика

---

Лицензия

MIT. Подробности — в файле LICENSE.

SoundCloud — торговая марка SoundCloud Ltd. Это приложение не аффилировано с SoundCloud.

---