MusicArk v1.0.0 MVP

Первый стабильный публичный релиз MusicArk для Windows x64.

MusicArk — desktop-приложение для управления локальной музыкальной коллекцией и её сопоставления с библиотекой Яндекс Музыки. Основная задача приложения — помогать сохранять целостность музыкальной коллекции: находить отсутствующие треки, проверять версии записей, восстанавливать метаданные и выполнять контролируемую синхронизацию.

Основные возможности

• просмотр любимых треков, плейлистов и альбомов Яндекс Музыки;
• индексирование нескольких папок локальной музыкальной библиотеки;
• сопоставление локальных файлов с треками Яндекс Музыки;
• отдельный анализ версии записи и метки ORIGINAL / CENSORED;
• поиск отсутствующих локально и требующих проверки треков;
• очередь загрузок с повтором, отменой, удалением и массовыми действиями;
• встроенное воспроизведение локальных и доступных через Яндекс Музыку треков;
• редактор метаданных MP3/ID3, включая обложки;
• копирование и восстановление метаданных на основе данных Яндекс Музыки;
• ручная загрузка собственных или разрешённых MP3 в Яндекс Музыку;
• восстановление недоступных треков при наличии локальной копии;
• Controlled Sync с предварительным планом и подтверждением изменений;
• поддержка системного подключения, прямого подключения и пользовательского proxy;
• русский и английский интерфейс;
• System / Light / Dark темы;
• встроенная проверка обновлений.

Отдельное внимание в v1.0.0 уделено работе с библиотеками в несколько тысяч треков: используются кеширование, пакетная обработка, сохранённые очереди и оптимизированные операции сопоставления.

Установка

Доступны два варианта:

• MusicArk-Setup-1.0.0-x64.exe — обычный установщик Windows для текущего пользователя;
• MusicArk-1.0.0-win-x64.zip — portable-версия без установки.

Обе сборки уже содержат Flutter-приложение и необходимый Python backend runtime. Отдельно устанавливать Python или клонировать исходный код не требуется.

Пользовательские данные хранятся отдельно в:

%LOCALAPPDATA%\MusicArk

Поэтому обычное удаление приложения не должно удалять базу данных, кеш и настройки пользователя.

Обновления

В релиз входит проверяемый механизм обновления.

Перед запуском нового установщика MusicArk проверяет:

1. update manifest;
2. размер загруженного файла;
3. SHA-256;
4. повторно проверяет файл непосредственно перед запуском установки.

Установка обновления выполняется только после подтверждения пользователя.

Проверка файлов

В релиз также входят:

• SHA256SUMS.txt — SHA-256 контрольные суммы;
• update-manifest.json — данные для встроенного механизма обновлений.

Известные ограничения

• поддерживается только Windows x64;
• полноценная безопасная запись метаданных реализована прежде всего для MP3/ID3;
• некоторые функции зависят от доступности внешних API Яндекс Музыки;
• автоматическое определение ORIGINAL / CENSORED не является абсолютным и спорные случаи требуют ручной проверки;
• MusicArk намеренно не выполняет автоматическое удаление, переименование или перезапись существующих локальных треков;
• v1.0.0 распространяется без Authenticode-подписи (UNSIGNED), поэтому Windows SmartScreen может показать предупреждение при первом запуске.

Лицензия

Собственный код MusicArk распространяется под лицензией MIT.

Сторонние библиотеки и runtime-компоненты сохраняют собственные лицензии. Информация о них включена в THIRD_PARTY_NOTICES.md и каталог licenses/.

MusicArk использует неофициальный API Яндекс Музыки через стороннюю библиотеку yandex-music.

MusicArk не является официальным продуктом Яндекса и не аффилирован с Яндексом.

---

Полное описание релиза:
https://github.com/Regstar2/music-ark/blob/v1.0.0/docs/releases/v1.0.0.md

Исходный код:
https://github.com/Regstar2/music-ark

Ошибки и предложения:
https://github.com/Regstar2/music-ark/issues