Files
windows/INSTALL.md
T

44 lines
3.0 KiB
Markdown
Raw Normal View History

# Установка 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
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`.