freakcloud Sync ☁️⚡

Companion Browser Extension for the freakcloud Desktop Music Player.
Браузерное расширение для быстрой и безопасной передачи сессии SoundCloud в десктопный плеер freakcloud.

---

🇬🇧 English

What is freakcloud Sync?

SoundCloud uses advanced bot protection (DataDome WAF) that prevents direct third-party logins without human verification.

freakcloud Sync bridges this gap:

1. You log into soundcloud.com normally in your everyday browser (Chrome, Edge, Brave, etc.).
2. The extension extracts your authenticated oauth_token and relays it to your local freakcloud player via loopback at http://127.0.0.1:49281/oauth/callback.
3. Your desktop client is instantly logged in with all your likes, playlists, and personal wave access.

🔒 Security & Privacy First

• 100% Localhost Only: The extension communicates exclusively with soundcloud.com and http://127.0.0.1:49281 on your own machine.
• No Analytics / No Tracking: No telemetry, analytics, or third-party servers.
• Minimal Permissions: Only reads the oauth_token cookie required for client authorization.

📥 Installation (Load Unpacked)

Since this is an open-source companion extension:

1. Download / Clone this repository:

   git clone https://github.com/MinakowDev/freakcloud-extension.git

2. Open your browser extension manager:
   • Google Chrome: chrome://extensions
   • Microsoft Edge: edge://extensions
   • Brave: brave://extensions
3. Enable Developer mode (toggle in the top-right corner).
4. Click Load unpacked (Загрузить распакованное).
5. Select the freakcloud-extension folder.
6. Open soundcloud.com. If you are already logged in, click the freakcloud Sync extension icon in your toolbar and press Sync Now!

---

🇷🇺 Русский

Что такое freakcloud Sync?

SoundCloud защищён системой DataDome WAF, блокирующей автоматическую авторизацию через сторонние приложения.

freakcloud Sync решает эту проблему в один клик:

1. Вы входите на soundcloud.com в обычном браузере.
2. Расширение считывает авторизованную куку oauth_token и передает её в запущенный десктопный плеер freakcloud по локальному адресу http://127.0.0.1:49281/oauth/callback.
3. Плеер моментально подхватывает сессию: загружает ваши лайки, сохранённые треки и персональную волну.

🔒 Безопасность и конфиденциальность

• Работает только локально: Токен передается исключительно на локальный сокет плеера (127.0.0.1:49281). Никаких внешних серверов.
• Без трекинга и аналитики: Исходный код полностью открыт, весит несколько килобайт и содержит только логику передачи сессии.

📥 Установка в браузер

1. Клонируйте репозиторий или скачайте архив ZIP:

   git clone https://github.com/MinakowDev/freakcloud-extension.git

2. Откройте в браузере страницу расширений:
   • В Chrome: chrome://extensions
   • В Edge: edge://extensions
   • В Яндекс / Brave / Opera: browser://extensions
3. В правом верхнем углу включите тумблер «Режим разработчика» (Developer mode).
4. Нажмите кнопку «Загрузить распакованное» (Load unpacked).
5. Выберите папку freakcloud-extension.
6. Откройте вкладку soundcloud.com и войдите в аккаунт — авторизация передастся в freakcloud автоматически!

---

📄 License

MIT License. Designed for freakcloud.