Skip to content

Desai0/ChromaSync

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

☁️ Подключитесь к инфраструктуре ChromaSync Ultimate и получите свой Personal API Token, для расширенного функционала: @ChromaSyncBOT

ChromaSync Ecosystem

Кроссплатформенный плагин для визуальной кастомизации и расширения возможностей десктопных и мобильных стриминговых плееров.

Screenshot 2026-05-08 231308
📷 Показать еще скриншоты Снимок экрана 2025-07-14 225906 Снимок экрана 2025-07-14 225945 Снимок экрана 2025-07-14 230142


ChromaSync: Ваша Музыка, Ваши Цвета

ChromaSync — это мощная система кастомизации и интеграции для поддерживаемых стриминговых сервисов (включая десктопный и мобильный клиенты Яндекс.Музыки). Базовый плагин превращает стандартный интерфейс в живое, дышащее пространство, которое адаптируется под обложку каждого трека, а облачные функции расширяют возможности плеера до предела.

В основе темы лежит "эффект хамелеона": скрипт анализирует обложку текущего трека, извлекает из неё палитру ярких и приглушенных цветов и плавно применяет их ко всему интерфейсу — от фона до мельчайших кнопок. Но это только начало. ChromaSync предоставляет вам полный контроль над каждым аспектом этого эффекта.

🌈 Ключевые возможности

1. Динамический фон с эффектом параллакса

Забудьте о статичных фонах. ChromaSync использует обложку текущего трека в качестве полноэкранного фона с красивым размытием.

  • Плавные переходы: Благодаря двухслойной системе, смена фона при переключении треков происходит с мягким эффектом кроссфейда, без резких скачков.
  • Эффект параллакса: Легкое движение мыши создает иллюзию глубины, смещая фон и добавляя интерфейсу динамики.
  • Регулировка яркости: Не нравится слишком яркий или темный фон? Используйте специальный ползунок в настройках, чтобы идеально отрегулировать его яркость.

2. Полный контроль над акцентным цветом

Акцентный цвет — это сердце темы. Он определяет цвет кнопок, вкладок, ползунков и других элементов. ChromaSync предлагает беспрецедентную гибкость в его настройке.

  • Автоматический режим (по умолчанию):

    • Выбор источника: Вы можете указать, какой именно оттенок из палитры обложки станет основным: Vibrant (яркий), Muted (приглушенный), DarkVibrant (темный и насыщенный) и другие. Экспериментируйте, чтобы найти идеальный для себя вариант!
    • Умная контрастность: Тема автоматически анализирует яркость выбранного акцентного цвета и подбирает цвет текста (черный или белый) на активных вкладках для обеспечения максимальной читаемости.
  • Ручной режим:

    • Используйте свой цвет: Если автоматика вам не по душе, просто включите опцию "Использовать свой акцентный цвет".
    • Палитра: Выберите абсолютно любой цвет с помощью удобной палитры в настройках.

3. Детальная настройка интерфейса

Вы можете настроить внешний вид практически каждого основного блока.

  • Основные элементы (плеер, область контента):
    • Размытие: Регулируйте степень размытия фона за плеером и основным контентом.
    • Яркость: Делайте подложку светлее или темнее для лучшего контраста.
  • Панель навигации (меню слева):
    • Имеет собственные, независимые ползунки для размытия и яркости.
  • Окно с информацией о треке:
    • Настройте прозрачность всплывающего окна с текстом и информацией о треке.
  • Полноэкранный плеер:
    • Для режима "во весь экран" доступны глобальные фильтры: Насыщенность, Размытие и Яркость.
  • Мелкие, но важные детали:
    • Обводка плеера: Включите или выключите цветную обводку и тень у плеера, которая окрашивается в акцентный цвет.
    • Акцентная кнопка Play: Решите, будет ли главная кнопка Play окрашиваться в акцентный цвет.
    • Цветной логотип: Позвольте логотипу Яндекс.Музыки перенимать усредненный цвет плеера.

4. Оптимизация производительности

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

  • Никаких зависаний: Анализ цветов — ресурсоемкая задача. Чтобы избежать зависаний при быстрой прокрутке треков, эта операция выполняется с задержкой (debounce). Фон меняется мгновенно, а цвета — только после того, как вы остановили выбор.
  • Защита от "состояния гонки": При быстрой смене треков скрипт не позволит старой обложке подменить новую благодаря системе уникальных идентификаторов для каждого запроса.
  • Эффективное отслеживание: MutationObserver настроен так, чтобы реагировать только на самые необходимые изменения в DOM (смена src у изображений), а не на каждое движение мыши, что значительно снижает нагрузку.
  • Экономия ресурсов: Когда окно или вкладка с приложением неактивны, наблюдатель за изменениями полностью отключается и возобновляет работу при возвращении, экономя ресурсы вашего ПК.

☁️ ChromaSync Ultimate (Серверные функции)

Для работы сложных функций, требующих баз данных и вычислительных мощностей, мы запустили собственную серверную инфраструктуру — ChromaSync Ultimate. Вы можете поддержать проект и получить личный API-Token у нашего Telegram-бота.

Токен связывает ваши десктопные и мобильные клиенты с нашим API, разблокируя:

  • 💬 Cloud Comments: Межплатформенная система комментариев. Читайте и оставляйте комментарии к любым трекам (данные хранятся на наших серверах).
  • 📂 Smart Local Priority: Бесшовная интеграция вашей локальной медиатеки. Если аудиопоток в стриминге имеет низкое качество или недоступен по лицензионным/региональным причинам, алгоритм автоматически подменяет его на ваш локальный HQ-файл.
  • 🎛 Cloud Pulse Engine: Продвинутая пульсация интерфейса под бит, данные для которой рассчитываются и синхронизируются через наше API.
    И многое другое. Мы постоянно расширяем возможности Cloud API.

🛠️ Как это работает (Технический стек)

  • Интеграция ПК: Работает как безопасный .pext аддон в среде открытого инжектора PulseSync.
  • Интеграция Android: Работает на уровне памяти через среду LSPosed (или LSpatch для устройств без Root-прав).
  • Cloud API: HTTP-авторизация по токенам для обмена данными с серверами ChromaSync.
  • Vibrant.js: Машинное извлечение палитры.
  • CSS Variables: Динамический рендеринг интерфейса.
image

Установка 📦

🖥 Для Desktop (Windows/macOS/Linux)

  1. Скачайте и установите инжектор PulseSync.
  2. Авторизуйтесь и установите базовые компоненты.
  3. Скачайте файл .pext из последнего релиза и примените его в интерфейсе PulseSync.
  4. Настройте по вашему желанию ❤️
  5. При возникновении проблем с API-токеном или Cloud-функциями, обращайтесь в наш чат сообщества

📱 Для Mobile (Android)

Инструкция по настройке модуля LSPosed/LSpatch для мобильного клиента находится в нашем закрытом сообществе.

☁️ Подключение к Cloud API

Получите свой Personal API Token, поддержав оплату серверов в официальном боте: @ChromaSyncBOT. Введите полученный токен в настройках плагина (на ПК или телефоне) для синхронизации и активации серверных функций.

Пользуйтесь! 🎉

Ссылки 🔗

PulseSync: https://pulsesync.dev/
ChromaSync сообщество: https://t.me/Chromasync
ChromaSync Ultimate (Токены): https://t.me/ChromaSyncBOT

Вдохновлена Blurity by diram1x

⚠️ Правовая информация и отказ от ответственности

Данное программное обеспечение является независимым фреймворком (плагином) с открытым исходным кодом, разработанным энтузиастами. Проект ChromaSync не связан с компанией «Яндекс», не спонсируется ею и не является официальным продуктом. Все названия, логотипы и торговые марки принадлежат их законным владельцам.

API-инфраструктура (ChromaSync Ultimate) предоставляется "как есть". Пользователи несут полную личную ответственность за содержимое публикуемых ими комментариев в облачной базе данных, а также за использование локальных медиафайлов через модуль Smart Local Priority. Мы не распространяем проприетарный код. Используйте плагин на свой страх и риск. Автор не несет ответственности за любые ограничения со стороны стриминговых платформ или изменения в их работе.

About

Адаптивная тема для кастомизации интерфейса Яндекс Музыки: визуальная синхронизация под трек, живавя пульсация и локальные uncensored-версии треков

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors