sixonefour

A high-performance, aesthetically driven SoundCloud desktop client.
Where advanced engineering meets experimental design.

---

English | Русский

---

🌐 English Version

Project Overview

sixonefour is not just another wrapper. It is a feature-rich, optimized SoundCloud client designed for users who demand both visual excellence and technical depth. Built on a modular Electron architecture, it integrates real-time stats, automation tools, and a proprietary theme engine.

� Core Capabilities

• Modular Theme Engine: Full CSS/Manifest control with video background support.
• Advanced Automation: Telegram Feed integration and Fans-category boosting.
• Network Resilience: Native support for Zapret, Proxy, and DNS mapping.
• Ecosystem Integration: Discord Rich Presence with live preview and synced desktop widget.

---

🔍 Feature Breakdown

� Custom Themes & Visual Engine

The client features a robust theming system that goes beyond simple color swaps. It supports live CSS injection and manifest-based theme packages.

• Dynamic Media: Seamless integration of .mp4 and .webm video backgrounds with adjustable blur.
• Branding Control: Fully customizable UI elements, including logos and scrollbars.
• Developer Ready: Real-time hot-reloading for theme creators.

[!TIP] Refer to the Theming Guide and Selectors List for advanced customization.

🪟 Desktop Widget (Glass Architecture)

A floating, interactive player designed with glassmorphism principles. The widget is fully synchronized with the main client's state and visual style.

• Visual Parity: Automatically inherits video backgrounds, fonts, and colors from the active theme.
• Resource Efficient: Uses optimized BrowserViews to maintain zero impact on system performance.
• Interactive Controls: Micro-animations for playback management and track info display.

🎮 Discord Rich Presence

Advanced activity tracking for your Discord profile. Highly customizable to show exactly what you want.

• Precision Tracking: Displays artist, artwork, and real-time playback progress.
• Status Preview: A live "What others see" window in the F1 settings menu.
• Custom Metadata: Enhanced track detection for better accuracy.

✈️ Telegram Integration

Bridge the gap between SoundCloud and Telegram with automated feed management and library exports.

• Live Feed Tracking: Automatically mirrors your "Liked" tracks to a private or public channel.
• Weekly Analytics: Generates aesthetic infographics of your weekly listening habits.
• Metadata Management: Comprehensive export of track titles, artists, and high-quality artwork.

Live Feed	Weekly Stats

[!IMPORTANT] Requirements:

1. The bot must be added to your channel with Administrator permissions.
2. Ensure Enable Track Parser is switched ON in the F1 settings for proper metadata extraction.

Mass Export Preview:

🌐 Network & Bypass Tools

Built-in solutions to maintain connection stability and bypass regional restrictions.

• Zapret Service: Integrated DPI bypass for unrestricted track streaming.
• Custom DNS Mapping: Hard-coded host-resolver rules for SoundCloud domains.
• Proxy Engine: Full support for custom proxy configurations.

📈 Fans Boosting (Behavior Simulation)

A sophisticated tool designed to improve track placement in the "Fans" category using human-like behavior simulation.

• Organic Patterns: Randomizes listening duration (80-100% full listens vs. short samples) to mimic real users.
• Hardware Fingerprinting: Spoofs viewport metrics, Device Scale factors, and User-Agents via Chrome DevTools Protocol (CDP).
• Intelligent Scheduling: Distributes plays over hours to maintain a natural growth curve.

[!WARNING] This feature requires Enable Track Parser to be active in the F1 settings to correctly identify track parameters.

---

� Project Roadmap

The following features are planned for future releases:

1. WebSocket Synchronization: Listen to music in real-time with friends.
2. First-Launch Experience: Interactive tutorial and setup wizard for new users.
3. In-Game Overlay: Manage playback without leaving your active game.
4. Cinematic Integration: Automatic YouTube clip lookup/preview when opening a track.

---

🚀 Setup & Installation

1. Download: Get the latest installer from the Releases page.
2. Access: Launch the app and press F1 to open the Command Center.
3. Requirement: For downloading and Telegram features, ensure Enable Track Parser is enabled.

---

🛠 Technical Build

# Clone and install dependencies
git clone https://github.com/1vilio/sixonefour.git
npm install

# Development
npm run dev

# Build (Windows)
npm run build-win

---

🇷🇺 Русская версия

О проекте

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

🔍 Подробный разбор функций

🎨 Кастомные темы и визуальный движок

Система тем позволяет полностью изменять интерфейс через CSS и JSON манифесты.

• Видео-фоны: Поддержка .mp4 и .webm фонов с эффектом размытия (Blur).
• Полный контроль: Возможность замены логотипов, настройки скроллбаров и шрифтов.
• Hot-Reload: Обновление тем в реальном времени без перезагрузки приложения.

🪟 Десктопный виджет (Glass Architecture)

Плавающий плеер с эффектом стекла, полностью синхронизированный с основным приложением.

• Визуальное единство: Наследует видео-фон, цвета и шрифты активной темы.
• Оптимизация: Минимальное влияние на систему благодаря использованию BrowserViews.
• Управление: Интерактивные кнопки и микро-анимации.

✈️ Интеграция с Telegram

Автоматизация вашего музыкального потока: отLive-фида до экспорта всей библиотеки.

• Live Feed: Автоматическая пересылка каждого вашего "лайка" в Telegram канал.
• Еженедельная статистика: Красивые инфографики прослушиваний за неделю.
• Массовый экспорт: Перенос всей коллекции треков в один клик.

[!IMPORTANT] Требования:

1. Бот должен быть добавлен в ваш канал с правами администратора.
2. В настройках (F1) должен быть включен пункт Enable Track Parser.

📈 Fans Boosting (Симуляция поведения)

Инструмент для улучшения позиций трека в категории "Fans" через имитацию действий реального пользователя.

• Органические паттерны: Рандомизация длительности прослушивания и случайные паузы.
• Hardware Fingerprinting: Подмена метрик устройства и User-Agent через протокол CDP.
• Умное планирование: Распределение прослушиваний по времени для естественного роста.

[!WARNING] Для корректной работы требуется включенный Enable Track Parser в настройках F1.

---

� Планы развития (Roadmap)

1. WebSocket Sync: Совместное прослушивание музыки с друзьями в реальном времени.
2. First-Launch Tutorial: Интерактивное обучение для новых пользователей.
3. Game Overlay: Управление музыкой поверх игровых окон.
4. Cinematic View: Автоматический поиск и показ клипа с YouTube при открытии трека.

---

💖 Acknowledgments

Special thanks to richardhbtz for the inspiration and work on soundcloud-rpc.

---

Licensed under MIT. Made for the community.