﻿Audiophiles - тестовая сборка для Windows
=========================================

Это пробная версия: без установки, без автообновления и без подписи.
Работает - слушаем и говорим, что не так.


Запуск
------

1. Распакуйте архив в папку, где разрешена запись: Рабочий стол, «Загрузки»
   или «Документы». В Program Files класть нельзя - сервер не сможет создать
   свою папку с данными.
2. Дважды кликните Audiophiles.cmd - откроется окно приложения, сервера отдельного
   окна нет. Сервер приложение поднимает само, когда в адресе стоит 127.0.0.1 или
   localhost и на этом порту никто не отвечает. Крестик на окне приложение не
   закрывает, а прячет: значок остаётся в трее, музыка играет дальше. Левый клик по
   значку показывает окно обратно, правый - меню, где «Выйти» выключает приложение
   и вместе с ним сервер. Если пишет «сервер недоступен» - смотрите журнал сервера в
   подпапке data: файл server.log, прошлый запуск рядом в server.log.old.
3. При первом старте Windows спросит про брандмауэр. Нажмите «Разрешить
   доступ» для частной сети - иначе зайти с телефона или второго компьютера
   не получится.
4. Если Windows показывает синее окно «Компьютер защищён»: нажмите
   «Подробнее», затем «Выполнить в любом случае». Подписи у тестовой сборки
   нет, это ожидаемо.


Первый вход
-----------

- Адрес сервера: 127.0.0.1:22050, если приложение на той же машине. С телефона
  - IP-адрес этой машины и тот же порт, например 192.168.1.20:22050. IP видно
  командой ipconfig.
- Дальше приложение попросит завести владельца: имя и пароль придумываете сами
  и запоминаете - восстановить пароль пока нельзя.
- Добавьте папку с музыкой в настройках и запустите обход. Список папок в
  приложении обновляет только полный обход.


Что должно стоять отдельно
--------------------------

ffmpeg - внешний декодер, он лежит подпапкой ffmpeg рядом с Audiophiles.cmd. С ним
играют форматы, которые сборка сама не декодирует (APE, WavPack, MPC, WMA, TAK,
MP4/AAC, Opus), и работает перевод DSD в PCM. Без них эти строки видны в
библиотеке, но не играются.

Своя сборка кладётся туда же: запуск берёт то, что лежит в папке ffmpeg, ничего
настраивать не нужно. Если папки нет - это поставка без сборки: скачайте LGPL-сборку
ffmpeg для Windows и положите в подпапку ffmpeg файлы ffmpeg.exe и ffprobe.exe.

DST-сжатые SACD-образы и многоканальный DSD не играются и с ffmpeg - это отдельная
работа, а не отсутствующий бинарник.

Драйвер ASIO от вашего ЦАПа - нужен только для DSD без пересчёта. Без него DSD
играет через DoP, звук тоже есть. Обычно драйвер идёт в комплекте с ЦАПом или
на сайте производителя.

WebView2 - на Windows 11 стоит по умолчанию, на Windows 10 почти всегда тоже.
Если окно приложения открылось белое - установите «Microsoft Edge WebView2
Runtime» с сайта microsoft.com и запустите снова.


Сетевая папка (NAS)
-------------------

Проводник -> в адресной строке \\123.123.123.123\Music -> «Вход в сеть» ->
логин/пароль с NAS -> поставить галочку «Запомнить учётные данные». После
этого путь из настройки должен открыться.

Если папка в Проводнике видна, а в приложении её нет: альбомы появятся после
обычного обхода, а вкладка «Папки» обновляется только полным обходом - он и
пересобирает дерево.


Где данные и как это удалить
----------------------------

Вся библиотека, обложки и настройки сервера лежат в подпапке data рядом с
Audiophiles.cmd. Туда же пишутся журналы: server.log (прошлый запуск -
server.log.old) и папка endpoint с журналом демона, который открывает ЦАП.
Удалили папку data - удалили всё.

Если ставили Audiophiles через установщик (.exe): программа и её подпапка data
лежат в одной папке - в той, которую вы выбрали при установке (по умолчанию
%LOCALAPPDATA%\Audiophiles). Перенос программы = перенести эту папку целиком,
библиотека поедет с ней. Тот же путь показывает вкладка «О программе» окна
приложения.

Снятие через uninstall.exe удаляет наши файлы: четыре бинарника, подпапку data
рядом с ними, ярлык и память окна (адрес сервера, токен входа, тема, язык).
Ничего вашего в выбранной папке не трогается: если положили программу в папку с
музыкой, музыка останется. Portable-раскладка от этого независима: её data лежит
рядом с Audiophiles.cmd, и снятие установленной копии её не касается.

Пока приложение работает, ни установка, ни снятие не проходят: Windows не отдаёт
занятые файлы. Установщик и удалитель в этом случае отказывают целиком, чтобы от
программы не осталось половинок, - выйди через значок в трее (правый клик -
Выйти) и запусти снова.


Что в тестовой версии сознательно не сделано
--------------------------------------------

- Нет обновлений: пришла новая сборка - распаковываете заново, папку data
  можно оставить на месте.
- Сервер не стартует вместе с Windows: каждый раз нужен Audiophiles.cmd.
- Пароль не восстанавливается.
- Трафик внутри домашней сети идёт открытым текстом - наружу порт 22050 не
  пробрасывайте.
