🎵 SoundCloud Desktop

Неофициальный десктопный клиент SoundCloud для Windows, Linux и macOS
Слушай музыку без рекламы и блокировок

🥚 Что-то не работает?

Не спешите удалять приложение, можете открыть Issue, либо написать в ветку дискуссий.

Вам помогут.

Не могу войти в аккаунт

Как авторизоваться тут: #53

Вижу "You have blocked"

Причины и способы решения тут: #91

... и другие возможные проблемы и способы их решения в дискуссиях.

Warning

Саунд более активно стал бороться со сторониими клиентами. Чтобы решить проблему, приложение в данный момент переписывается. Временно можете использовать обходы #107 или отключение прокси + запрет ( #112 )

🎯 Что это такое?

SoundCloud Desktop — это лучший неофициальный десктопный клиент для SoundCloud с расширенными возможностями, которых нет в официальном веб-плеере. Приложение создано специально для комфортного прослушивания музыки на компьютере с полной блокировкой рекламы и обходом всех ограничений.

🔥 Почему выбирают SoundCloud Desktop?

🎨 Полная кастомизация

Встроенный CSS редактор на базе Monaco Editor
Предпросмотр изменений в реальном времени
IntelliSense и подсветка синтаксиса
Сохранение стилей между сеансами

🚫 Полное отсутствие рекламы

Встроенная блокировка 39+ трекинговых и рекламных доменов:

Google Analytics, DoubleClick
Quantcast, Taboola
Facebook Pixel, Twitter Analytics
И многие другие рекламные сервисы

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

Умное определение блокировок
Автоматическое переключение на прокси
Доступ к заблокированным трекам из любого региона
Работает даже при медленном интернете

⚡ Невероятная скорость

Агрессивное 4-дневное кэширование статических файлов
Оптимизированное кэширование аудио сегментов (.m4s, .ts)
Молниеносная загрузка благодаря TypeScript

🔒 Умная система прокси

Автоматическая ротация при исчерпании квоты
Определение "зависших" соединений после 19KB
Множественные прокси для надёжности
Cloudflare Workers в один клик

🎵 Оптимизация для музыки

Эффективное кэширование медиа-сегментов
Плавное воспроизведение без задержек
Минимальное потребление трафика
Поддержка высокого качества аудио

🌐 Мультиязычность

Полная поддержка русского и английского языков
Автоматическое определение системного языка
Легкая смена языка в настройках

🖥️ Кроссплатформенность

Windows 10/11 (Installer)
Linux (AppImage)
macOS (Intel + Apple Silicon)

🎧 Для кого это приложение?

✅ Музыкальные продюсеры и диджеи — полноценный десктопный плеер для работы
✅ Пользователи из России — доступно из России ко всему SoundCloud
✅ Все, кто устал от рекламы — чистое прослушивание музыки без отвлечений
✅ Музыканты — управление несколькими аккаунтами SoundCloud
✅ Подкастеры и слушатели — удобное десктопное приложение для подкастов
✅ Меломаны — расширенные возможности для стриминга музыки

📥 Установка

💻 Windows

Развернуть инструкцию для Windows

Перейдите на страницу релизов
Скачайте SoundCloudInstaller.exe (универсальный установщик)
Запустите установщик
Следуйте инструкциям мастера установки
Готово! Приложение появится в меню «Пуск»

Системные требования:

Windows 10 (1809+) или Windows 11
4 ГБ RAM (рекомендуется 8 ГБ)
200 МБ свободного места на диске

🐧 Linux

Развернуть инструкцию для Linux

Перейдите на страницу релизов
Скачайте soundcloud-{version}.AppImage (например, soundcloud-3.2.0.AppImage)
Сделайте файл исполняемым:

chmod +x soundcloud-*.AppImage

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

./soundcloud-*.AppImage

Системные требования:

Ubuntu 20.04+ / Debian 11+ / Fedora 35+ или аналоги
4 ГБ RAM
200 МБ свободного места

🍎 macOS

Развернуть инструкцию для macOS

Перейдите на страницу релизов
Скачайте файл для вашего процессора:
- Apple Silicon (M1/M2/M3): soundcloud-{version}-arm64.dmg
- Intel: soundcloud-{version}.dmg
Откройте скачанный DMG файл
Перетащите SoundCloud Desktop в папку Applications
Первый запуск: Правый клик → Открыть (из-за безопасности macOS)

Системные требования:

macOS 11 Big Sur или новее
4 ГБ RAM
200 МБ свободного места

🔗 Протокол приложения `sc://`

Открывайте любую страницу SoundCloud прямо в приложении из браузера!

Как это работает?

Просто замените https://soundcloud.com/ на sc:// в любой ссылке:

https://soundcloud.com/discover  →  sc://discover
https://soundcloud.com/you/library  →  sc://you/library
https://soundcloud.com/artist/track  →  sc://artist/track

Примеры использования:

Открыть топ чарты: sc://charts
Открыть библиотеку: sc://you/library
Открыть плейлист: sc://username/sets/playlist-name

Бонус: Приложение имеет встроенную URL-панель (как в браузере) для быстрой навигации! 🚀

🎨 Кастомизация и настройки

CSS Редактор

SoundCloud Desktop включает мощный встроенный CSS редактор на базе Monaco Editor (тот же движок, что в VS Code):

Возможности:

✏️ Предпросмотр в реальном времени — видите изменения мгновенно
💾 Автосохранение — стили применяются при каждом запуске
🎯 IntelliSense — автодополнение и подсветка синтаксиса
🔄 Сброс к стандартным — восстановление в один клик
🌙 Темная тема — стилизован под эстетику SoundCloud

Как открыть:
Нажмите на иконку ⚙️ в правом верхнем углу окна

Расположение файла:

Windows: %APPDATA%\soundcloud\custom-styles.css
Linux/macOS: ~/.config/soundcloud/custom-styles.css

Уведомления об обновлениях

Красивые кастомные уведомления с:

📋 Markdown changelog с форматированием
📊 Прогресс-бар загрузки обновлений
🔗 Кликабельные ссылки
🎯 Установка в один клик

🗂️ Управление данными

Окно настроек включает мощные инструменты управления данными:

Очистка кэша

Удаление кэшированных файлов и данных запросов для освобождения места:

Что удаляется: Кэш ассетов (изображения, скрипты, медиа-сегменты), Electron session cache
Расположение кэша: Системная временная директория (soundcloud-cache)
Эффект: Может временно замедлить работу при следующем запуске, так как ассеты будут загружаться заново
Когда использовать: При проблемах с кэшированием или для освобождения дискового пространства

Очистка всех данных

Полный сброс всех данных приложения:

Что удаляется:
- Пользовательские CSS стили
- Все настройки приложения
- Кэшированные данные
Эффект: Сбрасывает приложение к начальному состоянию
⚠️ Предупреждение: Это действие необратимо!
Когда использовать: При устранении неполадок или для полного сброса настроек

Оба действия отображают размер данных в реальном времени и требуют подтверждения перед выполнением.

⚙️ Настройка и конфигурация

🌐 Настройки языка и интерфейса

Для настройки языка создайте файл config.json5 в директории приложения:

Расположение:

Windows: %APPDATA%\soundcloud\config.json5
Linux/macOS: ~/.config/soundcloud/config.json5

Формат файла:

{
  // Автоматические обновления
  autoUpdate: true,

  // Настройки локализации
  translations: {
    // Русский (также используется для kk, ky, be локалей)
    ru: {
      proxy_available_not_found: "Доступные прокси-серверы не найдены",
      // ... другие переводы
    }
  }
}

Приоритет конфигурации:

Папка пользователя (высший приоритет): %APPDATA%\soundcloud\config.json5 (Windows) или ~/.config/soundcloud/config.json5 (Linux/macOS)
Папка приложения (встроенный): config.json5 в директории с исполняемым файлом

Примечание: Настройки прокси загружаются из отдельного файла config.proxy.json5 (см. раздел "Настройка прокси" ниже).

🔒 Настройка прокси (для обхода гео-блока)

📖 Подробная инструкция по настройке прокси

Зачем нужен и какие возможности дает

Зачем нужен прокси?

Прокси позволяет обходить блокировки и получать доступ к заблокированным трекам без сторонних программ.

Умные возможности прокси:

🔍 Автоматическое определение блокировок
Приложение автоматически распознаёт "зависшие" соединения после передачи 19 КБ данных

🔄 Автоматическая ротация прокси
При получении ошибок 429/500 приложение автоматически переключается на следующий прокси из списка

💾 Агрессивное кэширование
4-дневный кэш для статических файлов (.js, .css, изображения, аудио сегменты)

🎵 Оптимизация медиа-сегментов
Умное кэширование .m4s и .ts сегментов с автоматическим удалением query-параметров

🚫 Расширенная блокировка рекламы
39+ трекинговых/рекламных доменов (Google Analytics, Quantcast, Taboola, etc.)

📊 Метрики использования
Сбор статистики использования доменов в режиме разработки (при запуске из исходников с дебагов)

Создание конфигурации

Создайте файл config.proxy.json5 в одной из директорий:

Приоритет загрузки конфигурации:

Папка пользователя (высший приоритет):
- Windows: %APPDATA%\soundcloud\config.proxy.json5
- Linux/macOS: ~/.config/soundcloud/config.proxy.json5
Папка приложения (встроенный): config.proxy.json5 в директории с исполняемым файлом
Без файла: Если файл не найден, используется пустой массив прокси { proxy: [] }

Важно: Конфигурация прокси полностью независима от config.json5. Приложение ищет файл config.proxy.json5 в указанном порядке и использует первый найденный.

Формат конфигурации:

{
  "proxy": [
    "https://your-worker.workers.dev",
    "http://proxy.example.com:8080",
    "https://backup-proxy.example.com"
  ]
}

Отключение прокси: Чтобы полностью отключить использование прокси-серверов, укажите пустой массив:

{
  "proxy": []
}

Множественные прокси: При исчерпании квоты на одном прокси (ошибки 429/500), приложение автоматически переключается на следующий. Когда все прокси недоступны, они восстанавливаются и ротация начинается снова.

Cloudflare Worker Proxy (Рекомендуется) ⭐

Самый простой и бесплатный способ настроить прокси:

Используйте готовый код Worker'а из _proxy/cloudflare-proxy.js
Разверните его в Cloudflare Workers (бесплатный тариф: 100,000 запросов/день)
Добавьте URL вашего Worker'а в config.proxy.json5
Подробные инструкции: _proxy/README.md

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

http://host:port
https://host:port

🛠️ Разработка

Details

👨‍💻 Для разработчиков

Требования

Node.js 22+ (рекомендуется 25 LTS)
pnpm 10+ (менеджер пакетов)
Rust 1.70+ (для нативных модулей)

Быстрый старт

# 1. Установите pnpm (если ещё не установлен)
npm install -g pnpm

# 2. Клонируйте репозиторий
git clone https://github.com/zxcloli666/SoundCloud-Desktop.git
cd SoundCloud-Desktop

# 3. Установите зависимости
pnpm install

# 4. Запустите в режиме разработки
pnpm dev

# 5. Сборка для production
pnpm build

Доступные команды

Команда	Описание
`pnpm dev`	Сборка и запуск в dev режиме
`pnpm dev:watch`	Запуск с пропуском копирования
`pnpm build`	Полная production сборка для всех платформ
`pnpm build:app`	Сборка только приложения
`pnpm build:production`	Production сборка без упаковки
`pnpm start`	Запуск собранного приложения
`pnpm type-check`	Проверка типов TypeScript
`pnpm lint`	Проверка кода ESLint
`pnpm biome:check`	Проверка кода Biome
`pnpm biome:write`	Форматирование кода Biome
`pnpm format`	Автоформатирование кода

🤝 Поддержка проекта

⭐ Поставь звезду!

Если тебе нравится SoundCloud Desktop — поставь ⭐ этому репозиторию!

🐛 Нашёл баг?

Создай issue с подробным описанием проблемы.

💡 Есть идея?

Открой discussion и поделись своими предложениями!

🔧 Хочешь помочь?

Pull requests приветствуются! Для больших изменений сначала открой issue для обсуждения.

📊 Статистика

📄 Лицензия

Этот проект распространяется под лицензией MIT. См. файл LICENSE для подробностей.

Дисклеймер: Названия и изображения принадлежат SoundCloud. Это приложение не аффилировано с SoundCloud Ltd.

📎 Связанные термины

Для улучшения поиска проекта: soundcloud desktop, soundcloud приложение, soundcloud клиент, soundcloud windows, soundcloud linux, soundcloud macos, soundcloud без рекламы, soundcloud в России, soundcloud россия, soundcloud desktop client, soundcloud app, soundcloud player, unofficial soundcloud, soundcloud прокси, музыкальный плеер, desktop music player, soundcloud альтернатива

Сделано с ❤️ для музыки без ограничений

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

🎵 SoundCloud Desktop

🥚 Что-то не работает?

Не могу войти в аккаунт

Вижу "You have blocked"

🎯 Что это такое?

🔥 Почему выбирают SoundCloud Desktop?

🎨 Полная кастомизация

🚫 Полное отсутствие рекламы

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

⚡ Невероятная скорость

🔒 Умная система прокси

🎵 Оптимизация для музыки

🌐 Мультиязычность

🖥️ Кроссплатформенность

🎧 Для кого это приложение?

📥 Установка

💻 Windows

🐧 Linux

🍎 macOS

🔗 Протокол приложения sc://

Как это работает?

Примеры использования:

🎨 Кастомизация и настройки

CSS Редактор

Уведомления об обновлениях

🗂️ Управление данными

⚙️ Настройка и конфигурация

🌐 Настройки языка и интерфейса

🔒 Настройка прокси (для обхода гео-блока)

Зачем нужен и какие возможности дает

Зачем нужен прокси?

Умные возможности прокси:

Создание конфигурации

Формат конфигурации:

Cloudflare Worker Proxy (Рекомендуется) ⭐

🛠️ Разработка

Требования

Быстрый старт

Доступные команды

🤝 Поддержка проекта

⭐ Поставь звезду!

🐛 Нашёл баг?

💡 Есть идея?

🔧 Хочешь помочь?

📊 Статистика

📄 Лицензия

📎 Связанные термины

🔗 Протокол приложения `sc://`