🎵 SoundCloud Desktop

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

---

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

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

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

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

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

🐧 Linux

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

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

chmod +x soundcloud-*.AppImage

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

./soundcloud-*.AppImage

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

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

🍎 macOS

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

1. Перейдите на страницу релизов
2. Скачайте файл для вашего процессора:
   • Apple Silicon (M1/M2/M3): soundcloud-{version}-arm64.dmg
   • Intel: soundcloud-{version}.dmg
3. Откройте скачанный DMG файл
4. Перетащите SoundCloud Desktop в папку Applications
5. Первый запуск: Правый клик → Открыть (из-за безопасности 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: "Доступные прокси-серверы не найдены",
      // ... другие переводы
    }
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

1. Папка пользователя (высший приоритет):

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

2. Папка приложения (встроенный): config.proxy.json5 в директории с исполняемым файлом

3. Без файла: Если файл не найден, используется пустой массив прокси { 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 (Рекомендуется) ⭐

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

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

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

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

---

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

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

Требования

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

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

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

# 2. Клонируйте репозиторий
git clone https://github.com/zxcnoname666/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 россия, soundcloud desktop client, soundcloud app, soundcloud player, unofficial soundcloud, soundcloud прокси, soundcloud vpn, музыкальный плеер, desktop music player, soundcloud альтернатива

---

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