ОбзорOverview

Latency — десктопный медиаплеер на Electron + React + TypeScript с архитектурой подключаемых источников (PlaybackProvider). Локальные файлы и SoundCloud работают через единое ядро: очередь, плеер-бар, лайки и плейлисты не зависят от источника.Latency is a desktop media player built on Electron + React + TypeScript with a pluggable-source architecture (PlaybackProvider). Local files and SoundCloud run through one engine: queue, player bar, likes and playlists are source-agnostic.

УстановкаInstallation

Все сборки лежат на вкладке Releases. Выберите файл под свою платформу.All builds are on the Releases page. Pick the file for your platform.

Windows

1. Скачайте Latency-0.2.0-x64.exe (установщик NSIS) или Latency-0.2.0-portable.exe (без установки).Download Latency-0.2.0-x64.exe (NSIS installer) or Latency-0.2.0-portable.exe (no install).
2. Запустите установщик и выберите папку (можно изменить путь установки), либо просто запустите портативный .exe.Run the installer and choose a folder (the install path is changeable), or just run the portable .exe.
3. Если SmartScreen ругается на неизвестного издателя — «Подробнее» → «Выполнить в любом случае» (сборка без платной подписи кода).If SmartScreen warns about an unknown publisher — “More info” → “Run anyway” (the build isn't paid-code-signed).

Android

1. Скачайте Latency.apk на телефон.Download Latency.apk to your phone.
2. Откройте файл — система попросит разрешить «Установка из неизвестных источников» для браузера/проводника. Включите.Open the file — the system will ask to allow “Install from unknown sources” for your browser/file manager. Enable it.
3. Подтвердите установку. Это debug-APK — обновления раз в 7 дней не требуются.Confirm the install. It's a debug APK — no 7-day re-signing needed.

iOS

iOS-сборка — неподписанный Latency-unsigned.ipa. Подпишите своим Apple ID через сайдлоадер:The iOS build is an unsigned Latency-unsigned.ipa. Sign it with your Apple ID via a sideloader:

1. Установите AltStore или Sideloadly на компьютер.Install AltStore or Sideloadly on your computer.
2. Подключите iPhone, перетащите .ipa и подпишите своим Apple ID.Connect your iPhone, drop the .ipa in and sign with your Apple ID.
3. На бесплатном аккаунте подпись действует 7 дней — потом перевыпуск.On a free account the signature lasts 7 days — re-sign after that.

Локальные файлыLocal files

Добавьте папки с музыкой — Latency просканирует их, прочитает теги и обложки (music-metadata) и закэширует обложки в userData. Файлы отдаются через собственный протокол media://. Без ограничений по форматам и количеству.Add your music folders — Latency scans them, reads tags and cover art (music-metadata) and caches covers in userData. Files are served through a custom media:// protocol. No format or count limits.

SoundCloud

Поиск треков и артистов работает без входа: client_id подбирается автоматически (скрейпится на лету, авто-рефреш при 401). Стрим — progressive (MP3) и HLS (через hls.js).Track & artist search works without logging in: client_id is fetched automatically (scraped on the fly, auto-refreshed on 401). Streaming is progressive (MP3) and HLS (via hls.js).

Вход в аккаунт (опционально)Logging in (optional)

Вход открывает персональные миксы и лайки. Подключение — в Profile или Settings → SoundCloud: после логина OAuth-токен перехватывается из вашей же сессии и хранится локально в %APPDATA%/latency-player/soundcloud.json. В репозиторий он не попадает.Logging in unlocks personal mixes and likes. Connect in Profile or Settings → SoundCloud: after login the OAuth token is captured from your own session and stored locally in %APPDATA%/latency-player/soundcloud.json. It never enters the repo.

Discord Rich Presence

Показывает в профиле Discord название трека, by Автор, статус играет/пауза, таймер и обложку трека вместо иконки приложения.Shows the track title, by Artist, playing/paused status, a timer and the track cover (instead of an app icon) in your Discord profile.

1. Создайте приложение на discord.com/developers и скопируйте Application ID.Create an app at discord.com/developers and copy its Application ID.
2. В Latency: Settings → Discord → включите тумблер и вставьте Application ID.In Latency: Settings → Discord → toggle it on and paste the Application ID.
3. Запустите Discord-десктоп. Если он не запущен — плеер просто не показывает статус, без падений.Run the Discord desktop app. If it isn't running, the player just skips presence — no crashes.

ЭквалайзерEqualizer

10 полос (32 Гц … 16 кГц, BiquadFilter peaking), вертикальные ползунки ±12 дБ, тумблер вкл/выкл и 7 пресетов: Flat, Bass Boost, Treble Boost, Vocal, Electronic, Rock, Loudness. Открывается кнопкой EQ в правой панели. Работает и на локальных файлах, и на SoundCloud.10 bands (32 Hz … 16 kHz, peaking BiquadFilter), vertical ±12 dB sliders, an on/off toggle and 7 presets: Flat, Bass Boost, Treble Boost, Vocal, Electronic, Rock, Loudness. Opened via the EQ button in the right panel. Works for both local files and SoundCloud.

Тексты и караокеLyrics & karaoke

• LRCLIB — синхронизированный LRC: построчная подсветка по позиции, автоскролл, клик по строке = перемотка.LRCLIB — synced LRC: per-line highlight by position, auto-scroll, click a line to seek.
• Genius — фолбэк (plain-текст) с оценочной авто-разбивкой по времени.Genius — fallback (plain text) with estimated time-splitting.
• Ручная синхронизация (SyncEditor) — свои тайминги, защищённые от перезаписи. Кэш — в userData/lyrics.Manual sync (SyncEditor) — your own timings, protected from overwrite. Cached in userData/lyrics.

АвтопилотAutopilot

Тумблер на нижнем прогресс-баре (рядом с караоке). Когда включён и очередь заканчивается, плеер автоматически находит похожие треки через SoundCloud (scRelated) и продолжает играть без остановки.A toggle on the bottom progress bar (next to karaoke). When on and the queue runs out, the player automatically finds similar tracks via SoundCloud (scRelated) and keeps playing non-stop.

Офлайн-кэшOffline cache

Кнопка скачивания (↓) на каждом SoundCloud-треке сохраняет MP3 в userData/offline — потом он играет без интернета. Вкладка Скачанное в сайдбаре → «Моя музыка». В Settings → Storage видно количество и размер кэша с кнопкой очистки.The download button (↓) on any SoundCloud track saves the MP3 to userData/offline — it then plays offline. A Downloaded tab in the sidebar → “My music”. Settings → Storage shows cache count and size with a clear button.

ОформлениеTheming

• Темы: Green, Purple, Blue, Pink + кастомный акцент (собственный HSV-пикер с hex и пресетами).Themes: Green, Purple, Blue, Pink + a custom accent (built-in HSV picker with hex and presets).
• Кастомный фон: своя картинка с недеструктивным кадрированием (пан/зум), область применения — полноэкранный / интерфейс / везде.Custom background: your own image with non-destructive cropping (pan/zoom), applied to fullscreen / UI / everywhere.
• Компактный режим, размер текста караоке (S/M/L), два языка интерфейса (EN/RU).Compact mode, karaoke text size (S/M/L), two UI languages (EN/RU).

Данные и приватностьData & privacy

В коде нет захардкоженных секретов. client_id берётся на лету, OAuth-токен SoundCloud перехватывается из вашего логина и хранится только локально. Обход DRM и риппинг защищённого аудио (Spotify/Яндекс) не делается.There are no hardcoded secrets in the code. client_id is fetched on the fly, the SoundCloud OAuth token is captured from your own login and kept locally only. No DRM circumvention or protected-audio ripping (Spotify/Yandex) is done.

Сборка из исходниковBuild from source

npm install
npm run dev        # десктоп, дев-режим с hot-reloaddesktop dev with hot-reload
npm run dev:mobile # мобильный таргет в браузереmobile target in the browser

npm run build      # main + preload + renderer → out/
npm run typecheck  # проверка типовtype checking
npm run dist:win   # установщик NSIS + портативный exe → release/NSIS installer + portable exe → release/

FAQ

Решение проблемTroubleshooting