windows/INSTALL.md

Установка MusicBridge для Windows x64

1. Распаковать MusicBridge-win-x64.zip целиком.
2. Запустить Install.cmd. Права администратора не нужны.
3. Открыть MusicBridge через меню «Пуск».

Пакет содержит .NET Runtime: SDK и отдельная установка .NET не нужны. Это локальный ZIP-установщик со скриптом, не MSI и не подписанный установщик. Install.cmd разрешает выполнение только запущенного скрипта в этом процессе; постоянная политика PowerShell не меняется.

Приложение устанавливается в %LOCALAPPDATA%\Programs\MusicBridge. Ярлык запускает --tray --lan. Крестик скрывает окно, меню трея завершает агент.

Автозапуск

В меню значка трея включить «Запускать вместе с Windows». По умолчанию он выключен. Настройка относится только к текущему пользователю (HKCU Run). Сохраняются путь исполняемого файла, режим локальной сети и порт текущего запуска. Агент открывается в трее без главного окна (--minimized). Повторное нажатие выключает автозапуск. Включать его желательно после установки, чтобы путь к приложению был постоянным.

Обновление и удаление

Перед повторной установкой завершить агент через меню трея. Установщик не завершает процессы автоматически и не трогает хранилище сопряжения.

Для удаления завершить агент и выполнить:

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\Programs\MusicBridge\Uninstall.ps1"

Удаляются установленная папка, соответствующий ярлык и запись автозапуска. Сертификат и доверенные устройства в %LOCALAPPDATA%\MusicBridge сохраняются. Правила брандмауэра установщик не меняет. Для подключения из домашней сети потребуется разрешённый доступ к TCP-порту агента и UDP 5353 в частной сети.

Для разработчика

Собрать пакет: powershell -NoProfile -File Packaging/Publish.ps1. Результат: dist/MusicBridge-win-x64.zip. Для проверки установки в изоляции можно передать Install.ps1 -InstallDirectory <пустая тестовая папка> -NoShortcut.